telescope Documentation

An elegant debug assistant for the Laravel framework.

5,234 stars PHP PHP 1 file · ~16,348 tokens #debugging#laravel#monitoring
RAW Doc

File: README.md

Introduction

Laravel Telescope is an elegant debug assistant for the Laravel framework. Telescope provides insight into the requests coming into your application, exceptions, log entries, database queries, queued jobs, mail, notifications, cache operations, scheduled tasks, variable dumps and more. Telescope makes a wonderful companion to your local Laravel development environment.

Official Documentation

Documentation for Telescope can be found on the Laravel website.

Contributing

Thank you for considering contributing to Telescope! The contribution guide can be found in the Laravel documentation.

Code of Conduct

In order to ensure that the Laravel community is welcoming to all, please review and abide by the Code of Conduct.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

License

Laravel Telescope is open-sourced software licensed under the MIT license.


File: CHANGELOG.md

Release Notes

[Unreleased](https://github.com/laravel/telescope/compare/v5.26.0...5.x)

[v5.26.0](https://github.com/laravel/telescope/compare/v5.25.0...v5.26.0) - 2026-09-22

[v5.25.0](https://github.com/laravel/telescope/compare/v5.24.0...v5.25.0) - 2026-09-09

[v5.24.0](https://github.com/laravel/telescope/compare/v5.23.0...v5.24.0) - 2026-09-08

[v5.23.0](https://github.com/laravel/telescope/compare/v5.22.1...v5.23.0) - 2026-08-27

[v5.22.1](https://github.com/laravel/telescope/compare/v5.22.0...v5.22.1) - 2026-08-05

[v5.22.0](https://github.com/laravel/telescope/compare/v5.21.0...v5.22.0) - 2026-07-29

[v5.21.0](https://github.com/laravel/telescope/compare/v5.20.0...v5.21.0) - 2026-07-20

[v5.20.0](https://github.com/laravel/telescope/compare/v5.19.0...v5.20.0) - 2026-04-06

[v5.19.0](https://github.com/laravel/telescope/compare/v5.18.0...v5.19.0) - 2026-03-24

[v5.18.0](https://github.com/laravel/telescope/compare/5.18.0...v5.18.0) - 2026-03-05

[5.18.0](https://github.com/laravel/telescope/compare/v5.17.0...5.18.0) - 2026-02-20

[v5.17.0](https://github.com/laravel/telescope/compare/v5.16.1...v5.17.0) - 2026-01-30

[v5.16.1](https://github.com/laravel/telescope/compare/v5.16.0...v5.16.1) - 2025-12-30

[v5.16.0](https://github.com/laravel/telescope/compare/v5.15.1...v5.16.0) - 2025-12-09

[v5.15.1](https://github.com/laravel/telescope/compare/v5.15.0...v5.15.1) - 2025-11-25

[v5.15.0](https://github.com/laravel/telescope/compare/v5.14.1...v5.15.0) - 2025-10-23

[v5.14.1](https://github.com/laravel/telescope/compare/v5.14.0...v5.14.1) - 2025-10-12

[v5.14.0](https://github.com/laravel/telescope/compare/v5.13.0...v5.14.0) - 2025-10-06

[v5.13.0](https://github.com/laravel/telescope/compare/v5.12.0...v5.13.0) - 2025-09-30

[v5.12.0](https://github.com/laravel/telescope/compare/v5.11.4...v5.12.0) - 2025-09-18

[v5.11.4](https://github.com/laravel/telescope/compare/v5.11.3...v5.11.4) - 2025-09-12

[v5.11.3](https://github.com/laravel/telescope/compare/v5.11.2...v5.11.3) - 2025-08-21

[v5.11.2](https://github.com/laravel/telescope/compare/v5.11.1...v5.11.2) - 2025-08-16

[v5.11.1](https://github.com/laravel/telescope/compare/v5.11.0...v5.11.1) - 2025-08-14

[v5.11.0](https://github.com/laravel/telescope/compare/v5.10.2...v5.11.0) - 2025-08-03

[v5.10.2](https://github.com/laravel/telescope/compare/v5.10.1...v5.10.2) - 2025-07-24

[v5.10.1](https://github.com/laravel/telescope/compare/v5.10.0...v5.10.1) - 2025-07-22

[v5.10.0](https://github.com/laravel/telescope/compare/v5.9.1...v5.10.0) - 2025-07-07

[v5.9.1](https://github.com/laravel/telescope/compare/v5.9.0...v5.9.1) - 2025-06-10

[v5.9.0](https://github.com/laravel/telescope/compare/v5.8.0...v5.9.0) - 2025-06-03

[v5.8.0](https://github.com/laravel/telescope/compare/v5.7.0...v5.8.0) - 2025-05-26

[v5.7.0](https://github.com/laravel/telescope/compare/v5.6.0...v5.7.0) - 2025-03-27

[v5.6.0](https://github.com/laravel/telescope/compare/v5.5.1...v5.6.0) - 2025-03-17

[v5.5.1](https://github.com/laravel/telescope/compare/v5.5.0...v5.5.1) - 2025-03-10

[v5.5.0](https://github.com/laravel/telescope/compare/v5.4.0...v5.5.0) - 2025-02-11

[v5.4.0](https://github.com/laravel/telescope/compare/v5.3.0...v5.4.0) - 2025-01-24

[v5.3.0](https://github.com/laravel/telescope/compare/v5.2.6...v5.3.0) - 2024-12-26

[v5.2.6](https://github.com/laravel/telescope/compare/v5.2.5...v5.2.6) - 2024-11-25

[v5.2.5](https://github.com/laravel/telescope/compare/v5.2.4...v5.2.5) - 2024-10-31

[v5.2.4](https://github.com/laravel/telescope/compare/v5.2.3...v5.2.4) - 2024-10-29

[v5.2.3](https://github.com/laravel/telescope/compare/v5.2.2...v5.2.3) - 2024-10-13

[v5.2.2](https://github.com/laravel/telescope/compare/v5.2.1...v5.2.2) - 2024-08-26

[v5.2.1](https://github.com/laravel/telescope/compare/v5.2.0...v5.2.1) - 2024-08-20

[v5.2.0](https://github.com/laravel/telescope/compare/v5.1.1...v5.2.0) - 2024-08-02

[v5.1.1](https://github.com/laravel/telescope/compare/v5.1.0...v5.1.1) - 2024-06-27

[v5.1.0](https://github.com/laravel/telescope/compare/v5.0.5...v5.1.0) - 2024-06-17

[v5.0.5](https://github.com/laravel/telescope/compare/v5.0.4...v5.0.5) - 2024-05-09

[v5.0.4](https://github.com/laravel/telescope/compare/v5.0.3...v5.0.4) - 2024-04-22

[v5.0.3](https://github.com/laravel/telescope/compare/v5.0.2...v5.0.3) - 2024-04-17

[v5.0.2](https://github.com/laravel/telescope/compare/v5.0.1...v5.0.2) - 2024-04-15

[v5.0.1](https://github.com/laravel/telescope/compare/v5.0.0...v5.0.1) - 2024-03-23

[v5.0.0](https://github.com/laravel/telescope/compare/v4.17.6...v5.0.0) - 2024-03-12

[v4.17.6](https://github.com/laravel/telescope/compare/v4.17.5...v4.17.6) - 2024-02-08

[v4.17.5](https://github.com/laravel/telescope/compare/v4.17.4...v4.17.5) - 2024-01-30

[v4.17.4](https://github.com/laravel/telescope/compare/v4.17.3...v4.17.4) - 2024-01-22

[v4.17.3](https://github.com/laravel/telescope/compare/v4.17.2...v4.17.3) - 2023-12-11

[v4.17.2](https://github.com/laravel/telescope/compare/v4.17.1...v4.17.2) - 2023-11-01

[v4.17.1](https://github.com/laravel/telescope/compare/v4.17.0...v4.17.1) - 2023-11-01

[v4.17.0](https://github.com/laravel/telescope/compare/v4.16.4...v4.17.0) - 2023-10-31

[v4.16.4](https://github.com/laravel/telescope/compare/v4.16.3...v4.16.4) - 2023-09-25

[v4.16.3](https://github.com/laravel/telescope/compare/v4.16.2...v4.16.3) - 2023-09-19

[v4.16.2](https://github.com/laravel/telescope/compare/v4.16.1...v4.16.2) - 2023-08-28

[v4.16.1](https://github.com/laravel/telescope/compare/v4.16.0...v4.16.1) - 2023-08-11

[v4.16.0](https://github.com/laravel/telescope/compare/v4.15.2...v4.16.0) - 2023-08-08

[v4.15.2](https://github.com/laravel/telescope/compare/v4.15.1...v4.15.2) - 2023-07-13

[v4.15.1](https://github.com/laravel/telescope/compare/v4.15.0...v4.15.1) - 2023-06-21

[v4.15.0](https://github.com/laravel/telescope/compare/v4.14.6...v4.15.0) - 2023-06-08

[v4.14.6](https://github.com/laravel/telescope/compare/v4.14.5...v4.14.6) - 2023-06-03

[v4.14.5](https://github.com/laravel/telescope/compare/v4.14.4...v4.14.5) - 2023-06-02

[v4.14.4](https://github.com/laravel/telescope/compare/v4.14.3...v4.14.4) - 2023-05-29

[v4.14.3](https://github.com/laravel/telescope/compare/v4.14.2...v4.14.3) - 2023-05-19

[v4.14.2](https://github.com/laravel/telescope/compare/v4.14.1...v4.14.2) - 2023-04-19

[v4.14.1](https://github.com/laravel/telescope/compare/v4.14.0...v4.14.1) - 2023-03-17

[v4.14.0](https://github.com/laravel/telescope/compare/v4.13.2...v4.14.0) - 2023-02-21

[v4.13.2](https://github.com/laravel/telescope/compare/v4.13.1...v4.13.2) - 2023-02-16

[v4.13.1](https://github.com/laravel/telescope/compare/v4.13.0...v4.13.1) - 2023-02-06

Changed

[v4.13.0](https://github.com/laravel/telescope/compare/v4.12.0...v4.13.0) - 2023-01-30

Changed

Fixed

[v4.12.0](https://github.com/laravel/telescope/compare/v4.11.0...v4.12.0) - 2023-01-13

Added

[v4.11.0](https://github.com/laravel/telescope/compare/v4.10.2...v4.11.0) - 2023-01-03

Added

Changed

[v4.10.2](https://github.com/laravel/telescope/compare/v4.10.1...v4.10.2) - 2022-12-19

Fixed

[v4.10.1](https://github.com/laravel/telescope/compare/v4.10.0...v4.10.1) - 2022-12-14

Fixed

[v4.10.0](https://github.com/laravel/telescope/compare/v4.9.6...v4.10.0) - 2022-12-05

Added

[v4.9.6](https://github.com/laravel/telescope/compare/v4.9.5...v4.9.6) - 2022-11-08

Fixed

[v4.9.5](https://github.com/laravel/telescope/compare/v4.9.4...v4.9.5) - 2022-10-06

Fixed

[v4.9.4](https://github.com/laravel/telescope/compare/v4.9.3...v4.9.4) - 2022-10-03

Fixed

[v4.9.3](https://github.com/laravel/telescope/compare/v4.9.2...v4.9.3) - 2022-09-12

Fixed

[v4.9.2](https://github.com/laravel/telescope/compare/v4.9.1...v4.9.2) - 2022-08-08

Changed

[v4.9.1](https://github.com/laravel/telescope/compare/v4.9.0...v4.9.1) - 2022-07-18

Fixed

[v4.9.0](https://github.com/laravel/telescope/compare/v4.8.3...v4.9.0) - 2022-04-19

Added

[v4.8.3](https://github.com/laravel/telescope/compare/v4.8.2...v4.8.3) - 2022-04-11

Changed

[v4.8.2](https://github.com/laravel/telescope/compare/v4.8.1...v4.8.2) - 2022-04-01

Fixed

[v4.8.1](https://github.com/laravel/telescope/compare/v4.8.0...v4.8.1) - 2022-03-26

Changed

[v4.8.0](https://github.com/laravel/telescope/compare/v4.7.4...v4.8.0) - 2022-03-15

Added

Changed

[v4.7.4](https://github.com/laravel/telescope/compare/v4.7.3...v4.7.4) - 2022-03-03

Changed

Fixed

[v4.7.3](https://github.com/laravel/telescope/compare/v4.7.2...v4.7.3) - 2022-02-15

Fixed

[v4.7.2](https://github.com/laravel/telescope/compare/v4.7.1...v4.7.2) - 2022-02-04

Fixed

  • Fix key handling for ModelWatcher (#1180)

[v4.7.1](https://github.com/laravel/telescope/compare/v4.7.0...v4.7.1) - 2022-02-01

Changed

  • Attempt to fix model hydration (#1174)

[v4.7.0 (2022-01-12)](https://github.com/laravel/telescope/compare/v4.6.10...v4.7.0)

Changed

  • Laravel 9 Support (#1170)

[v4.6.10 (2022-01-04)](https://github.com/laravel/telescope/compare/v4.6.9...v4.6.10)

Fixed

  • Fix issue with array hydration (#1165)

[v4.6.9 (2021-12-07)](https://github.com/laravel/telescope/compare/v4.6.8...v4.6.9)

Changed

  • Merge previously defined view data when building the view mailable data (#1157)

Fixed

  • Add key attribute (#1154)
  • Fix PHP 8.1 issues (#1156)

[v4.6.8 (2021-11-30)](https://github.com/laravel/telescope/compare/v4.6.7...v4.6.8)

Changed

  • Add support ignore request when status code specified (abc9660, #1150)

[v4.6.7 (2021-11-16)](https://github.com/laravel/telescope/compare/v4.6.6...v4.6.7)

Changed

  • Slow query filter method added (#1146)

[v4.6.6 (2021-11-04)](https://github.com/laravel/telescope/compare/v4.6.5...v4.6.6)

Changed

  • Replace Http/Uri with HTTP/URI (#1141)

Fixed

  • Fix syntax highlighting (#1142)

[v4.6.5 (2021-10-05)](https://github.com/laravel/telescope/compare/v4.6.4...v4.6.5)

Fixed

  • Fix mail to check to allow for null to fields (#1133)

[v4.6.4 (2021-09-16)](https://github.com/laravel/telescope/compare/v4.6.3...v4.6.4)

Fixed

  • Don't log HTTP requests to Telescope endpoints (#1127)
  • Laravel Octane fix: GateWatcher handles stack trace caller not found (#1128)

[v4.6.3 (2021-09-14)](https://github.com/laravel/telescope/compare/v4.6.2...v4.6.3)

Fixed

  • Fix telescope.domain usage (#1124)

[v4.6.2 (2021-08-17)](https://github.com/laravel/telescope/compare/v4.6.1...v4.6.2)

Fixed

  • Rewind http client response after recording (#1114)

[v4.6.1 (2021-08-03)](https://github.com/laravel/telescope/compare/v4.6.0...v4.6.1)

Changed

  • Record 'connection failed' http client event (#1097)
  • Unified asset publishing (#1105)

Fixes

  • Suppress filesize errors in client request watcher (#1096)
  • Use intdiv where appropriate to prevent unexpected conversion to float (#1100)
  • Fix publishing for disabled module (#1104)

[v4.6.0 (2021-07-13)](https://github.com/laravel/telescope/compare/v4.5.1...v4.6.0)

Added

  • Add a new "Clear Entries" button (#1091)

Changed

  • Telescope:withoutRecording() should be exception safe (#1092)

Fixed

  • Fixed frontend request polling memory leaks (#1086)
  • Fix for JobWatchers when the job payload is encrypted (#1089)

[v4.5.1 (2021-06-22)](https://github.com/laravel/telescope/compare/v4.5.0...v4.5.1)

Fixed

  • Http Client Link State (#1078)
  • Improve file handling in client request watcher (#1080)

[v4.5.0 (2021-06-01)](https://github.com/laravel/telescope/compare/v4.4.10...v4.5.0)

Added

  • Add http client request watcher (#1073)

[v4.4.10 (2021-06-01)](https://github.com/laravel/telescope/compare/v4.4.9...v4.4.10)

Changed

  • Remove asset manifest check and warning (#1063)

Fixed

  • Implemented fallback for PDO::quote method on QueryWatcher (#1066)

[v4.4.9 (2021-04-06)](https://github.com/laravel/telescope/compare/v4.4.8...v4.4.9)

Fixed

  • Always boot commands (#1045)
  • Fix JSON indenting (#1049)
  • Fix query formatting in preview (#1050)

[v4.4.8 (2021-04-06)](https://github.com/laravel/telescope/compare/v4.4.7...v4.4.8)

Fixed

  • Fix query preview (#1044)

[v4.4.7 (2021-04-06)](https://github.com/laravel/telescope/compare/v4.4.6...v4.4.7)

Changed

  • Move booting of commands (#1034)
  • Prep For Octane (#1040)

[v4.4.6 (2021-03-11)](https://github.com/laravel/telescope/compare/v4.4.5...v4.4.6)

Fixed

  • Revert "[4.x] Move cache read inside handler to avoid early cache call" (#1030)

[v4.4.5 (2021-03-09)](https://github.com/laravel/telescope/compare/v4.4.4...v4.4.5)

Fixed

  • Move cache read inside handler to avoid early cache call (#1025)

[v4.4.4 (2021-02-23)](https://github.com/laravel/telescope/compare/v4.4.3...v4.4.4)

Fixed

  • Implement new GateEvaluated event (#1018)

[v4.4.3 (2021-02-16)](https://github.com/laravel/telescope/compare/v4.4.2...v4.4.3)

Fixed

  • Handle when $batch is null (#1013)

[v4.4.2 (2021-02-09)](https://github.com/laravel/telescope/compare/v4.4.1...v4.4.2)

Fixed

  • GateWatcher shows allowed when it is denied via Response class (#1010)

[v4.4.1 (2021-01-26)](https://github.com/laravel/telescope/compare/v4.4.0...v4.4.1)

Fixed

  • Prevent access to uninitialized typed properties (#1005)

[v4.4.0 (2020-12-15)](https://github.com/laravel/telescope/compare/v4.3.3...v4.4.0)

Added

  • Add model hydrations to model watcher (#1000)

Fixed

  • Fix typo in memory calculation (#997)

[v4.3.3 (2020-12-08)](https://github.com/laravel/telescope/compare/v4.3.2...v4.3.3)

Fixed

  • Revert "[4.x] Updated db command for clearing tables" (#993)

[v4.3.2 (2020-12-08)](https://github.com/laravel/telescope/compare/v4.3.1...v4.3.2)

Changed

  • Updated db command for clearing tables (#991)

[v4.3.1 (2020-11-05)](https://github.com/laravel/telescope/compare/v4.3.0...v4.3.1)

Fixed

  • Fix for database migrations publishing path (#979)

[v4.3.0 (2020-11-03)](https://github.com/laravel/telescope/compare/v4.2.0...v4.3.0)

Added

  • PHP 8 Support (#977)

Changed

  • Consolidate database directory (#975)

[v4.2.0 (2020-10-20)](https://github.com/laravel/telescope/compare/v4.1.0...v4.2.0)

Added

  • Be able to specify only allowed paths (#963, (18c475f))
  • Added isGate() filter (#967)
  • Added isRequest() filter (#966)

[v4.1.0 (2020-10-06)](https://github.com/laravel/telescope/compare/v4.0.1...v4.1.0)

Added

  • Dump visibility toggling, search, etc (#959)

[v4.0.1 (2020-09-22)](https://github.com/laravel/telescope/compare/v4.0.0...v4.0.1)

Fixed

  • Support new listeners syntax (a69fc6f)

[v4.0.0 (2020-09-08)](https://github.com/laravel/telescope/compare/v3.5.1...v4.0.0)

Added

  • Laravel 8 support & Batches support (#903)

Fixed

  • May be written to an empty log (#930)

Removed

  • Laravel 6 & 7 support (#860)
  • PHP 7.2 support (3c3883d)

[v3.5.1 (2020-07-28)](https://github.com/laravel/telescope/compare/v3.5.0...v3.5.1)

Fixed

  • Change text for Marking Exceptions as Resolved (#916)
  • Add explicit base font family fallback (#920)
  • Remove problematic unused code when formatting SQL (#924)

[v3.5.0 (2020-05-14)](https://github.com/laravel/telescope/compare/v3.4.0...v3.5.0)

Added

  • Add request IP address to RequestWatcher (#895)

Fixed

[v3.4.0 (2020-05-12)](https://github.com/laravel/telescope/compare/v3.3.1...v3.4.0)

Added

[v3.3.1 (2020-05-05)](https://github.com/laravel/telescope/compare/v3.3.0...v3.3.1)

Fixed

  • Changed truncate from 75 chars to 50 (#887)
  • Add index to created_at (#885)

[v3.3.0 (2020-04-28)](https://github.com/laravel/telescope/compare/v3.2.2...v3.3.0)

Added

  • Ability to review Exception context data (#882)

[v3.2.2 (2020-04-21)](https://github.com/laravel/telescope/compare/v3.2.1...v3.2.2)

Fixed

  • Fix typed properties issues (#879)
  • Remove thousands separator in time records (#877)

[v3.2.1 (2020-04-14)](https://github.com/laravel/telescope/compare/v3.2.0...v3.2.1)

Fixed

  • Testing fixes (#866)
  • Encode array for logging (#873)

[v3.2.0 (2020-03-17)](https://github.com/laravel/telescope/compare/v3.1.1...v3.2.0)

Added

  • Added isQuery in IncomingEntry (#842)

Fixed

  • Preserving the alphabetical order of providers (#841)

[v3.1.1 (2020-02-27)](https://github.com/laravel/telescope/compare/v3.1.0...v3.1.1)

Fixed

  • Fix array to string conversion (#839)

[v3.1.0 (2020-02-25)](https://github.com/laravel/telescope/compare/v3.0.0...v3.1.0)

Added

[v3.0.0 (2020-02-18)](https://github.com/laravel/telescope/compare/v2.1.7...v3.0.0)

Changed

  • Change Telescope::$tagUsing to an array (#694)
  • Make ignoring Laravel Nova paths configurable (#799)

Removed

  • Dropped support for Laravel 5.8

[v2.1.7 (2020-02-18)](https://github.com/laravel/telescope/compare/v2.1.6...v2.1.7)

Fixed

  • Handle all eval() failures from Laravel Tinker (#829)

[v2.1.6 (2020-02-12)](https://github.com/laravel/telescope/compare/v2.1.5...v2.1.6)

Fixed

  • ReflectionException when used with debugbar (#825)

[v2.1.5 (2020-02-04)](https://github.com/laravel/telescope/compare/v2.1.4...v2.1.5)

Fixed

  • Only log file/line for exception trace (#817)

[v2.1.4 (2020-01-21)](https://github.com/laravel/telescope/compare/v2.1.3...v2.1.4)

Fixed

  • Avoiding to create guard (#810)

[v2.1.3 (2019-12-19)](https://github.com/laravel/telescope/compare/v2.1.2...v2.1.3)

Fixed

  • Check if composers key exists (#797)

[v2.1.2 (2019-12-13)](https://github.com/laravel/telescope/compare/v2.1.1...v2.1.2)

Fixed

  • Enable redis events by default if the watcher is enabled (#789)
  • Fix Round queries duration to 2 decimal places (#791)
  • Fix ignore generic listeners as view composer (#794)

[v2.1.1 (2019-11-23)](https://github.com/laravel/telescope/compare/v2.1...v2.1.1)

Added

  • Add information about view composers (#766)
  • Add formatted output support for plain text responses (#749)
  • Added support for event ignoring (#738)
  • Show warning when manifest is outdated (#729)

Changed

  • Add the Nova API to ignore paths array (#752)
  • Use getConnection method in Migrations (#736)

Fixed

  • Properly Implode Nested(Array) Notification Routes To Fix Array To String Conversion Exception (#778)
  • Don't use familyHash for queries (#773)
  • Hide php-auth-pw server variable by default (#740)
  • Use time instead of duplicated to show global queries duration (#737)
  • Check for null values in query bindings (#727)
  • Prevent resuming recording when processing sync job (#720)

[v2.1 (2019-09-03)](https://github.com/laravel/telescope/compare/v2.0.6...v2.1)

Added

  • Jump to related entry by hash (#708)
  • Format SQL in watcher (#714)
  • Mark exceptions as resolved (#710)
  • Full timestamp on hover (#668)
  • Add memory to request watcher (#680)
  • Add view collector (#679)

Changed

  • Adding meta for disavowing robots (#703)
  • Chunk storage of exceptions and tags (#670)
  • Simplify dump error screen (#688)

Fixed

  • Log failed requests (#701)
  • Fix view tab selection order (#707)
  • Only load sfDump header once (#714)
  • Fix events with ShouldBroadcastNow (#623)
  • Support duration calculation without constant LARAVEL_START (#664)
  • Optimize dump (#683)

[v2.0.6 (2019-07-12)](https://github.com/laravel/telescope/compare/v2.0.5...v2.0.6)

Fixed

  • Enable chunking on delete to prevent errors on large resultsets (#658, 32c3709)

[v2.0.5 (2019-06-05)](https://github.com/laravel/telescope/compare/v2.0.4...v2.0.5)

Added

  • Add app name config to title and dashboard (#643), (a3f1580)

Fixed

  • JSON fallback font (#605)
  • PHPUnit 8 Warnings (#610)
  • Empty path config in frontend (#637)

[v2.0.4 (2019-03-28)](https://github.com/laravel/telescope/compare/v2.0.3...v2.0.4)

Fixed

[v2.0.3 (2019-03-27)](https://github.com/laravel/telescope/compare/v2.0.2...v2.0.3)

Changed

  • Cache key compatibility update (#583)

Fixed

  • Newline Config (#595)

[v2.0.2 (2019-03-06)](https://github.com/laravel/telescope/compare/v2.0.1...v2.0.2)

Fixes

  • Support apps that run carbon 1.0 (2b976e5)

[v2.0.1 (2019-03-05)](https://github.com/laravel/telescope/compare/v2.0...v2.0.1)

Added

  • Added support for Date::use(CarbonImmutable::class); (d7a3ca4)

[v2.0.0 (2019-02-27)](https://github.com/laravel/telescope/compare/v1.1...v2.0)

Changed

  • Update Cache to use seconds instead of minutes (#562)

File: composer.json

{
"name": "laravel/telescope",
"description": "An elegant debug assistant for the Laravel framework.",
"keywords": [
"laravel",
"monitoring",
"debugging"
],
"license": "MIT",
"authors": [
{
"name": "Taylor Otwell",
"email": "[email protected]"
},
{
"name": "Mohamed Said",
"email": "[email protected]"
}
],
"require": {
"php": "^8.0",
"ext-json": "",
"laravel/framework": "^8.37|^9.0|^10.0|^11.0|^12.0|^13.0",
"laravel/sentinel": "^1.0",
"symfony/console": "^5.3|^6.0|^7.0|^8.0",
"symfony/var-dumper": "^5.0|^6.0|^7.0|^8.0"
},
"require-dev": {
"ext-gd": "
",
"guzzlehttp/guzzle": "^6.0|^7.0|^8.0",
"laravel/octane": "^1.4|^2.0",
"orchestra/testbench": "^6.48|^7.57|^8.38|^9.15|^10.8|^11.0",
"phpstan/phpstan": "^2.2.9"
},
"autoload": {
"psr-4": {
"Laravel\Telescope\": "src/",
"Laravel\Telescope\Database\Factories\": "database/factories/"
}
},
"autoload-dev": {
"psr-4": {
"Laravel\Telescope\Tests\": "tests/",
"Workbench\App\": "workbench/app/",
"Workbench\Database\": "workbench/database/"
}
},
"extra": {
"laravel": {
"providers": [
"Laravel\Telescope\TelescopeServiceProvider"
]
}
},
"config": {
"sort-packages": true,
"audit": {
"block-insecure": false
}
},
"scripts": {
"post-autoload-dump": "@composer run prepare",
"prepare": "@php ./vendor/bin/testbench package:discover --ansi",
"build": [
"@php ./vendor/bin/testbench package:create-sqlite-db",
"@php ./vendor/bin/testbench telescope:publish --force",
"@php ./vendor/bin/testbench migrate:refresh"
],
"serve": [
"@composer run build",
"@php ./vendor/bin/testbench serve"
]
},
"minimum-stability": "dev",
"prefer-stable": true
}


File: LICENSE.md

The MIT License (MIT)

Copyright (c) Taylor Otwell

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.


File: package.json

{
"name": "laravel-telescope",
"private": true,
"type": "module",
"scripts": {
"build": "vite build",
"test": "vitest run",
"test:watch": "vitest",
"watch": "vite build --watch"
},
"devDependencies": {
"@vitejs/plugin-vue2": "^2.3.3",
"@vue/test-utils": "^1.3.6",
"axios": "^1.20",
"bootstrap": "^4.5.0",
"highlight.js": "^11.3.1",
"jquery": "^3.5",
"jsdom": "^30.1.2",
"lodash": "^4.18.1",
"moment": "^2.31.0",
"moment-timezone": "^0.5.45",
"popper.js": "^1.16",
"sass": "^1.74.1",
"sql-formatter": "^15.6.2",
"vite": "^5.4.21",
"vitest": "^3.2.7",
"vue": "^2.7.16",
"vue-copy-to-clipboard": "^1.0.3",
"vue-json-pretty": "^1.6.2",
"vue-router": "^3.6.5"
}
}


File: testbench.yaml

providers:

  • Laravel\Telescope\TelescopeServiceProvider
  • Laravel\Sentinel\SentinelServiceProvider
  • Workbench\App\Providers\TelescopeServiceProvider

migrations:

  • database/migrations

seeders:

  • Workbench\Database\Seeders\DatabaseSeeder

workbench:
start: '/telescope'
user: [email protected]


File: UPGRADE.md

Upgrade Guide

With every upgrade, make sure to publish Telescope's assets and clear the view cache:

text
php artisan telescope:publish

php artisan view:clear

Upgrading To 5.0 From 4.x

Migration Changes

Telescope 5.0 no longer automatically loads migrations from its own migrations directory. Instead, you should run the following command to publish Telescope's migrations to your application:

bash
php artisan vendor:publish --tag=telescope-migrations

Upgrading To 4.0 From 3.x

Minimum PHP Version

PHP 7.3 is now the minimum required version.

Minimum Laravel Version

Laravel 8.0 is now the minimum required version.


File: .styleci.yml

php:
preset: laravel
js:
tab-width: 4
use-tabs: false
print-width: 120
double-quotes: false
trailing-commas: es5
semicolons: true
arrow-parens: always
bracket-same-line: false
bracket-spacing: true
finder:
exclude:
- "dist"
- "node_modules"
- "vendor"
name:
- ".js"
- "
.jsx"
css:
tab-width: 4
use-tabs: false
print-width: 120
double-quotes: false
finder:
exclude:
- "dist"
- "node_modules"
- "vendor"
name:
- ".css"
- "
.scss"
- "*.less"


File: resources/boost/skills/telescope-debugging/SKILL.md


name: telescope-debugging

Telescope records every request, job, and command as a batch: the entry itself and every query, cache operation, log, event, exception, and view it produced. The two commands below read this data from the terminal. Prefer them to the web UI.

Workflow

  1. Find the entry. Run php artisan telescope:list request (or exception, job, query, or cache). Choose the row by URI, class, or duration, then copy its UUID. Skip this step when you want the most recent entry.

  2. Show the batch. Run php artisan telescope:show , or php artisan telescope:show latest:request. The output is the entry's own detail followed by Queries, Exceptions, Cache, and Logs sections, all from the same batch.

  3. Diagnose from the flags. In the Queries table, DUP marks queries with the same SQL pattern, which usually indicates an N+1. The Source column shows the file and line that ran the query, shortened to a basename; use --json for the full path. SLOW marks queries over the configured threshold. The Cache header shows hits, misses, and hit rate. An exception entry shows the message, code context, and stack trace.

  4. Finish when the finding identifies a file and line or a specific query, rather than only a symptom.

JSON output

Both commands accept --json. Prefer it to table output when you need exact values, want to filter results, or expect long output. telescope:list --json prints an array of entries. telescope:show --json prints {"entry": {...}, "batch": [...]}. Its batch array is in chronological order and already filtered by --type. When no entries match, telescope:list --json prints [] rather than a message.

Every entry has id, batch_id, type, content, family_hash, and created_at. The content keys match the Telescope UI for that type. For example, a query has sql, time, slow, file, and line, while an exception has class, message, file, line, and trace. Two fields are not populated by these commands: tags is always [] (use --tag to filter rather than reading tags from the output), and sequence is null when the entry is addressed by UUID.

bash
# Exception class, message, and location for the latest exception
php artisan telescope:show latest:exception --json | jq '.entry.content | {class, message, file, line}'

# Slow queries in the latest request, with the file that ran them
php artisan telescope:show latest:request --json --type=query | jq '.batch[] | select(.content.slow) | {sql: .content.sql, time: .content.time, file: .content.file, line: .content.line}'

# Repeated SQL patterns in a request (N+1 candidates), most repeated first
php artisan telescope:show latest:request --json --type=query | jq '[.batch[].content.sql] | group_by(.) | map({sql: .[0], count: length}) | sort_by(-.count) | .[] | select(.count > 1)'

# Recent 500 responses
php artisan telescope:list request --json --limit=50 | jq '.[] | select(.content.response_status >= 500) | {id, uri: .content.uri, status: .content.response_status}'

# Failed jobs and their exception messages
php artisan telescope:list job --json | jq '.[] | select(.content.status == "failed") | {id, name: .content.name, error: .content.exception.message}'

Reference

  • latest and latest:{type} resolve to the most recent entry without a UUID lookup. Any entry type works, including latest:query and latest:job.
  • --json on either command disables truncation, so --full is only needed for table output.
  • telescope:show --full disables truncation of SQL, messages, and payloads.
  • telescope:show --type=query,exception limits batch context to those types when a request produced hundreds of entries.
  • telescope:list --tag=Auth:42 filters entries for one authenticated user, because Telescope tags them with Auth:. --batch= lists every entry from one request. --before=<sequence> pages backward using the cursor printed in the footer. --family=<hash> groups recurrences of one exception; read the hash from the family_hash field in --json output.
  • Run either command with --help for the full option list and valid entry types.