laravel/telescope

This system is a Laravel debugging and monitoring package that records and displays detailed telemetry for application events, including HTTP requests, database queries, jobs, logs, and cache interactions. It provides a comprehensive web interface for inspecting these entries with granular filtering, syntax highlighting, and interactive data visualization. The system supports configurable watchers to capture specific data types, manages storage via a structured database schema, and offers CLI commands for data lifecycle management.

44 changes.

This period focused on the major release of Telescope 5.x, featuring a complete frontend migration from Laravel Mix to Vite and Vue 3, alongside a comprehensive backend rewrite to support Laravel Octane and granular storage operations. The work involved rebuilding the entire dashboard interface with new screens for all monitored entry types, implementing a modern design system with dark mode, and introducing extensive CLI commands and configuration options for data management.

9 changes.

This period focused on expanding the Telescope debugging package with new monitoring capabilities, including dedicated screens for HTTP client requests and view composition. The work involved establishing the underlying database schema, refining API route definitions, and enhancing queue job configurability. Additionally, the frontend build system was migrated to Vite, and the workbench environment was updated to streamline local development and testing.

Users can now view a list of executed commands in the Commands index screen, showing the command text, exit code, and time ago. Clicking into a command opens a preview page that displays the command and exit code, along with a tabbed interface to view Arguments and Options as formatted JSON. The preview includes a copy-to-clipboard feature for the JSON content and links to related entries.

resources/js/screens/commands · high confidence

Introduced new Vue components for the Gates monitoring feature, including an index view (\resources/js/screens/gates/index.vue\) that lists gate events with ability, result, message, and timestamp, and a preview view (\resources/js/screens/gates/preview.vue\) that displays detailed gate information such as the triggering file location and a JSON-pretty-printed view of the arguments passed to the gate.

resources/js/screens/gates · high confidence

This change introduces the user interface for the HTTP Client watcher feature. It adds the \index.vue\ list view, which displays recorded HTTP requests with columns for Verb, URI, Status, Duration, and timestamp, and the \preview.vue\ detail view, which allows users to inspect individual request details including method, URI, status, duration, and tabs for viewing the request payload, request headers, response body, and response headers.

resources/js/screens/client-requests · high confidence

A new Models screen has been added to display a list of model hydration events, showing the model name, action type, and time elapsed. Users can click into a preview to see detailed information, including the specific action, the number of hydrated items, and a formatted JSON view of the changes made, which supports copying to the clipboard.

resources/js/screens/models · high confidence

New Vue components have been added to the Redis monitoring interface, introducing an index view that lists executed commands with their duration and timestamp, and a preview view that displays detailed command information including connection details and the raw command text.

resources/js/screens/redis · high confidence

This change introduces the Schedule management interface within the application. The new index screen lists scheduled commands, displaying the command description or command string, the cron expression, and a relative time indicator for when the entry was created. It also provides a link to view detailed information for each scheduled item. The corresponding preview screen presents specific details for a selected schedule entry, including its description, command, expression, associated user, and timezone. Additionally, if the schedule entry contains output, it is displayed in a dedicated card with a copy-to-clipboard feature.

resources/js/screens/schedule · high confidence

A new Views screen has been added to the application, allowing users to monitor view rendering activity. The list view displays the name and path of each view, the number of view composers associated with it, and the time since it was rendered. A preview screen provides detailed information, including the full view payload data and a dedicated tab listing all view composers with their types, enabling better debugging and insight into view composition behavior.

resources/js/screens/views · high confidence

A new Monitoring screen has been added to the Telescope frontend, allowing users to view, add, and remove monitored tags. The component fetches the current list of tags via an API endpoint and provides a modal interface for adding new ones. It relies on jQuery for modal interactions and uses AbortController to cancel in-flight requests when the component is destroyed, ensuring that stale network calls do not update the UI after navigation.

resources/js/screens/monitoring · high confidence

A new UninstallAction class has been introduced to handle cleanup tasks when the package is uninstalled. Specifically, it attempts to remove the TelescopeServiceProvider from the application's bootstrap file if the underlying framework version supports the removeProviderFromBootstrapFile method, ensuring a cleaner removal process for users.

src/Actions · high confidence

Adds the migration file to create the \telescope\_entries\, \telescope\_entries\_tags\, and \telescope\_monitoring\ database tables. This establishes the storage structure required for the Telescope debugging package, including primary keys, unique constraints, and foreign key relationships with cascade delete behavior.

database/migrations · high confidence

The Dumps screen now renders dump entries with interactive, collapsible variable trees using the Symfony VarDumper JavaScript library. This change adds a new \sfdump.js\ module and updates \index.vue\ to initialize the dumper, ensuring that dump data is displayed with proper syntax highlighting and expand/collapse functionality rather than as static text.

resources/js/screens/dumps · high confidence

The Telescope frontend has been significantly restructured and expanded. The application now includes dedicated screens and routes for a wider range of collected data, including dumps, logs, jobs, batches, queries, models, requests, commands, schedule, redis, monitoring, and gates, in addition to the existing mail, exceptions, notifications, events, and cache. The UI now features a new 'Copy to Clipboard' component, a 'Clear Entries' button (accessible via the CMD+K hotkey), and a toggle to pause recording directly from the interface. Time display logic has been updated to show more granular elapsed time for recent entries, and the application now properly handles the base path configuration for non-root installations. Additionally, CSRF tokens are automatically attached to all Axios requests, and the Vue JSON Pretty library is integrated for better JSON visualization.

resources/js · high confidence

This update introduces a suite of new Artisan commands to the \src/Console\ directory, giving users direct control over Telescope's lifecycle and data. The \telescope:install\ command automates the initial setup by publishing configuration, migrations, and the service provider. Users can now manage the recording state with \telescope:pause\ and \telescope:resume\, which toggle a cache flag to temporarily stop or restart data collection. Data management is handled by \telescope:clear\ to delete all entries, \telescope:prune\ to remove stale records based on a configurable age (with an option to preserve exceptions), and \telescope:list\ to browse entries with filtering and pagination. Additionally, \telescope:show\ provides detailed inspection of specific entries and their batch context, while \telescope:publish\ allows for updating existing assets.

src/Console · high confidence

Added new Vue components for the Jobs and Batches sections of the application. The Jobs index and preview screens now display job details including status, connection, queue, tries, timeout, and batch association, with tabs for viewing job data, exception messages, stacktraces, and code previews. The Batches index and preview screens provide an overview of batch progress, status (pending, finished, failures), and links to associated jobs.

resources/js/screens/jobs · high confidence

Users can now view application logs via a new Logs index screen that lists entries by message, level, and time, with messages truncated to 50 characters. Clicking an entry opens a Log Details preview that displays the log level and provides two tabs: Log Message (with a copy-to-clipboard button) and Context (rendered as pretty JSON via vue-json-pretty, also copyable).

resources/js/screens/logs · high confidence

Added the Queries index and preview screens to the application. The index view lists recorded queries with truncated SQL, duration, and time-ago information. The preview screen displays full query details including connection, execution location (file and line), and duration. It now formats SQL using the sql-formatter library (supporting dialects like PostgreSQL and SQL Server) and applies syntax highlighting via highlight.js, with a copy-to-clipboard button for the formatted code.

resources/js/screens/queries · high confidence

A new \entriesStyles.js\ mixin has been added to the frontend, providing helper methods that map various application states (such as HTTP request methods, job statuses, log levels, and model actions) to specific CSS classes. This allows components using this mixin to automatically apply consistent visual styling (e.g., colors for success, warning, or danger) based on the data context, improving the readability of entries in the interface.

resources/js/mixins · high confidence

Added the Exceptions index and preview screens to the Telescope UI. The index screen displays a table of exceptions with columns for type, occurrence count, time, and resolution status, allowing users to filter by family hash or tag. The preview screen provides detailed information for a specific exception, including tabs for Message, Location (with code preview), Context (with JSON pretty-printing and copy-to-clipboard), and Stacktrace. It also includes a 'Mark as resolved' button that triggers a confirmation dialog and updates the exception status via the API.

resources/js/screens/exceptions · high confidence

This release introduces a major architectural overhaul for Laravel Telescope. It adds native support for Laravel Octane by managing recording state around request lifecycles and queue worker loops, ensuring entries are stored at appropriate termination points. The frontend asset pipeline has migrated from Laravel Mix to Vite. The system now supports a broader range of monitored events, introducing new entry types such as \client\_request\, \view\, and \log\ alongside existing ones like \request\ and \job\. Users can now customize user avatars via a callback, hide specific request headers and parameters for security, and filter entries using new \isLog\, \isEvent\, and \isCache\ methods. The package also includes new CLI commands for managing Telescope (install, clear, pause, resume, prune) and allows for granular configuration of watchers and ignored commands.

src · high confidence

The \src/Watchers\ directory has been completely rewritten to support Laravel 5.x. The legacy \EventsWatcher\ (which extended \AbstractWatcher\) has been removed and replaced by a suite of new, dedicated watcher classes: \BatchWatcher\, \ClientRequestWatcher\, \CommandWatcher\, \DumpWatcher\, \EventWatcher\, \ExceptionWatcher\, \GateWatcher\, \JobWatcher\, \ModelWatcher\, \QueryWatcher\, \RedisWatcher\, \RequestWatcher\, \ScheduleWatcher\, and \ViewWatcher\. These new watchers extend a new base \Watcher\ class and utilize modern Laravel event listeners (e.g., \GateEvaluated\, \BatchDispatched\, \CommandFinished\) to record telemetry data, introducing features like batch tracking, HTTP client request monitoring, and improved query binding replacement.

src/Watchers · high confidence

The workbench environment now automatically registers a Telescope service provider that grants view access to all users, and includes a database seeder that creates a default 'Laravel User' account along with nine additional test users. This change simplifies local development and testing by providing immediate access to Telescope monitoring and pre-configured test data without manual setup.

workbench · high confidence

The legacy Vue components for the Log screen (index.vue and preview.vue) have been removed from the application. This deletion eliminates the previous implementation that displayed log entries in a table and provided a detailed preview view with exception traces and context, indicating a shift away from this specific frontend structure for log viewing.

resources/js/screens/log · high confidence

The legacy Vue components for the Queue monitoring section (\resources/js/screens/queue/index.vue\ and \preview.vue\) have been removed. This deletes the old table-based list view for queue entries and the detailed preview page that displayed job status, name, queue, connection, tries, timeout, and exception details via direct API calls. Users relying on these specific Vue screens for queue inspection will no longer have access to them in this location.

resources/js/screens/queue · high confidence

A change to existing behaviour in resources — 2 commits, 1 file.

resources · medium confidence · unverified

The Cache index and preview screens have been completely rewritten to use the new shared layout components (index-screen, preview-screen) and the StylesMixin, replacing the previous custom Vue logic and direct axios calls. This change updates the user interface to a more consistent design with improved table formatting, adds a formatted expiration display in seconds on the preview page, and removes the manual document title setting and jQuery dependency from these specific components.

resources/js/screens/cache · high confidence

The \ProcessPendingUpdates\ job now respects new configuration options for queue behavior, allowing users to customize the queue connection (\telescope.queue.connection\), queue name (\telescope.queue.queue\), and retry delay (\telescope.queue.delay\). Previously, these jobs likely used default queue settings; now, if a numeric delay greater than zero is configured, the job will be dispatched with that delay after processing, and it will attempt up to three times before stopping, using the specified connection and queue for each retry.

src/Jobs · high confidence

The Requests screen now displays additional metadata in the list view, including a Duration column, and the Request Details preview page shows controller action, middleware, IP address, and memory usage. The preview interface has been expanded to include tabs for viewing response headers and session variables alongside the existing payload and response data, with support for copying content to the clipboard.

resources/js/screens/requests · high confidence

The Telescope frontend has been rebuilt using Vue 3 and the Vite build tool, replacing the previous Vue 2 and Mix setup. This introduces several behavioral changes: the Alert component now relies on jQuery for Bootstrap modal interactions, the Index and Preview screens use AbortController to cancel in-flight requests when navigating away, and the RelatedEntries component supports hash-based tab navigation. New capabilities include a CopyClipboard component for one-click data copying, syntax-highlighted code previews for exceptions, and a dedicated loader component to manage loading states.

resources/js/components · high confidence

The application now explicitly defines HTTP routes for all Telescope API endpoints (such as mail, exceptions, dumps, logs, and queue jobs) in the web routes file, replacing any previous implicit or centralized registration. This change ensures that all entry-related API interactions are handled through clearly declared controller methods, providing a stable and predictable interface for accessing debugging data.

routes · high confidence

The Mail list and preview screens have been refactored to use the shared IndexScreen and PreviewScreen components, replacing the previous custom loader and table layouts. In the list view, the columns have changed from 'From/To/Subject' to 'Mailable/Recipients/Happened', and a new 'Recipients' column now displays the total count of To, CC, BCC, and Reply-To addresses for each entry. The preview screen now uses a parameters table for metadata and wraps the HTML preview iframe in a card component.

resources/js/screens/mail · high confidence

The project's frontend asset compilation has switched from Laravel Mix to Vite. This is evidenced by the addition of a new \vite.config.js\ configuration file and the \.npmrc\ file, alongside the removal of the \mix-manifest.json\ file. The \webpack.mix.js\ file has also been updated to include Vite-compatible options such as Vue support and console dropping, reflecting the underlying infrastructure change required for the new build tool.

(repo-wide) · high confidence

A new \config/telescope.php\ file has been introduced, providing a centralized place to configure Laravel Telescope. This allows users to enable or disable specific watchers (such as Cache, Client Request, Command, Dump, Event, Gate, Log, Model, and Query) via environment variables. The configuration also introduces granular filtering options, including \ignore\_paths\ and \ignore\_commands\ to exclude specific URIs and Artisan commands, \ignore\_hosts\ for HTTP client requests, and watcher-specific settings like \ignore\ lists for events and cache keys, \hydrations\ for models, and \level\ for logs.

config · high confidence

The Notifications list and preview screens have been refactored to use the shared \index-screen\ and \preview-screen\ components, replacing the previous custom Vue logic and manual table layouts. This change removes direct dependencies on jQuery and Lodash from these files and standardizes the interface: the list view now displays a 'Queued' badge for pending notifications, truncates long notification and recipient text, and uses a consistent time-ago format for the 'Happened' column, while the preview view adopts the standard parameter table layout.

resources/js/screens/notifications · high confidence

The application's visual appearance has been updated with a new design system. A comprehensive color palette (including gray, red, amber, emerald, blue, and indigo scales) has been introduced, replacing the previous variable definitions. The interface now supports a dark mode theme, allowing users to switch between light and dark visual styles. Additionally, the typography has been updated to use the 'Figtree' font family, and syntax highlighting for JSON and code blocks has been refined for better readability.

resources/sass · high confidence

The Events index screen now displays the number of listeners for each event and uses a time-ago format for timestamps, while the preview screen has been restructured into a tabbed interface that separates Event Data (with JSON pretty-printing and copy-to-clipboard) from a dedicated Listeners tab showing queued status badges.

resources/js/screens/events · high confidence

Telescope's HTTP controllers have been refactored to extend a new abstract \EntryController\ base class, replacing the previous pattern where each controller (such as Cache, Events, Log, Mail, Notifications, and Queue) implemented its own \index\ and \show\ methods. This change centralizes common entry-listing and entry-detail logic, while specific controllers now only define their entry type and watcher class. The \QueueController\ also gains the ability to display related batch entries when viewing a specific job, and the \DumpController\ now includes a mechanism to trigger a live dump preview via cache.

src/Http/Controllers · high confidence

The storage implementation has been restructured to improve performance and query flexibility. A new EntryQueryOptions class now handles filtering by batch ID, tags, family hash, and UUIDs, replacing the previous simple type-based retrieval. The DatabaseEntriesRepository now inserts entries in configurable chunks (defaulting to 1000) using JSON\_INVALID\_UTF8\_SUBSTITUTE to handle binary data safely, and separates exception storage to track occurrences via family hashes. The legacy TelescopeDatabaseEntry model has been removed in favor of direct Eloquent usage on EntryModel.

src/Storage · high confidence

The \EntryModel\ in the Telescope storage layer has been rewritten to use Eloquent scopes for query construction, introducing support for filtering entries by multiple tags, batch IDs, and family hashes. This change modifies how users can query recorded entries, enabling more granular filtering capabilities within the Telescope UI and API by leveraging the new \telescope\_entries\_tags\ relationship logic.

laravel/telescope · medium confidence

The storage contract layer in src/Contracts has been restructured to support more specific data management capabilities. New interfaces PrunableRepository and TerminableRepository define methods for pruning entries by date and performing post-storage cleanup, respectively. The ClearableRepository interface (renamed from AbstractWatcher) now explicitly defines a clear() method for wiping all entries. Additionally, the EntriesRepository interface has been significantly expanded: the generic all() method is replaced by find() for single-entry retrieval and get() for filtered queries using EntryQueryOptions, while store() and update() now accept typed collections of IncomingEntry and EntryUpdate objects. New methods for tag monitoring (loadMonitoredTags, isMonitoring, monitoring, monitor, stopMonitoring) have also been added to the contract.

src/Contracts · high confidence

The explicit PHP route definitions for Telescope API endpoints (mail, log, notifications, queue, events, cache) and the frontend view fallback have been removed from src/Http/routes.php. This indicates a migration away from traditional route file registration, likely consolidating routing into a different mechanism or configuration file within the application.

src/Http · high confidence

The migration file responsible for creating the \telescope\_entries\ table has been removed from the codebase. This change eliminates the automatic creation of the database schema for Telescope's entry storage, implying that the application no longer relies on this specific table structure or that the storage mechanism has been replaced by a different implementation.

src/Storage/migrations · high confidence

The pre-compiled frontend assets \public/app.css\ and \public/app.js\ have been deleted from the repository. These files previously contained the bundled styles (including Bootstrap v4.1.3) and the webpack-compiled JavaScript bundle (including jQuery v3.3.1 and Vue runtime utilities). Their removal indicates a shift in the build process, likely moving away from serving these static, pre-built files directly from the public directory.

public · high confidence

The Telescope dashboard layout has been completely redesigned. The sidebar now features a modern icon-based navigation with new sections for Batches, Dumps, Gates, and HTTP Client, replacing the previous text-only list. A new header bar includes a logo, a button to pause/resume recording, a button to clear entries, an auto-load toggle, and a monitoring link. The page also adds a favicon, sets robots to noindex/nofollow, and switches the asset pipeline from Laravel Mix to Vite, loading styles and scripts via Telescope's helper methods instead of static file paths.

resources/views · high confidence

The TelescopeServiceProvider stub has been updated to improve security and compatibility. It now explicitly hides sensitive request parameters (like \\_token\) and headers (cookies, CSRF tokens) in non-local environments to prevent session hijacking and CSRF exploits. The service provider also uses native PHP type declarations for the \register\ and \hideSensitiveRequestDetails\ methods, type-hints the \User\ model in the gate definition, and passes the local environment check into the filter closure to satisfy static analysis tools like Larastan.

stubs · high confidence

Added EntryModel factory for test data generation; Added HTTP test coverage for authorization, avatars, CSP nonces, and routes; Added test coverage for Telescope watchers; Added tests for Telescope CLI commands; Added tests for pending update processing and database storage behavior; Added tests for tag extraction and recording hooks; Establishes FeatureTestCase base class for integration tests.

The frontend build system has been migrated from Laravel Mix (Webpack) to Vite, replacing the previous npm scripts with Vite-specific commands and updating the JavaScript dependency list to include Vite, Vue 2.7, and various UI libraries. On the PHP side, the package now requires PHP 8.0 or higher and supports Laravel 8 through 13, while also introducing new development dependencies like PHPStan 2 and Orchestra Testbench. Additionally, the project has switched its lock file management from Yarn to npm (package-lock.json) and removed the composer.lock file.

(dependencies) · high confidence

The frontend build pipeline has been migrated from the previous setup to Vite, resulting in new compiled output files (dist/app.css and dist/app.js). This change includes several dependency updates visible in the build artifacts: axios has been upgraded through versions 1.14.0 to 1.18.0, and lodash has been updated from 4.17.21 to 4.17.23. Additionally, the application now bundles Vue.js v2.7.16.

dist · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• First survey — no prior run to compare against. CAI 49.

• Code Health 63
• Architecture 61
• Maturity 56
• Readiness 52
• Security 80
• Accessibility 41

• 300 commits — 255 feature/other, 45 fixes

• (root) — 130 commits
• .github/workflows — 21 commits
• src/Watchers — 21 commits
• resources/js — 15 commits
• src/Storage — 12 commits
• config/telescope.php — 11 commits
• src/Telescope.php — 9 commits
• (repo) — 8 commits
• public/app.js — 8 commits
• tests/Watchers — 7 commits
• .github/ISSUE_TEMPLATE — 6 commits
• public/build — 6 commits
• src/Console — 5 commits
• dist/app.js — 4 commits
• public/app-dark.css — 4 commits
• database/migrations — 3 commits
• dist/app.css — 3 commits
• .github/dependabot.yml — 2 commits
• art/.DS_Store — 2 commits
• resources/sass — 2 commits

• fix: Apply fixes from StyleCI
• fix: Apply fixes from StyleCI
• fix: Apply fixes from StyleCI
• fix: Apply fixes from StyleCI
• fix: Fix (#1621)
• fix: Fix BatchWatcher::recordBatch docblock copied from JobWatcher (#1753)
• fix: Fix MailWatcher tags (#1340)
• fix: Fix Telescope::css() return type docblock (#1762)
• fix: Fix base.scss (#1447)
• fix: Fix batch function call on null (#1606)
• fix: Fix broken preview image in README.md (#1596)
• fix: Fix database connection
• fix: Fix dumps screen missing sf-js-enabled css class name (#1671)
• fix: Fix duplicated queries on multiple connections (#1385)
• fix: Fix empty avatar on nullable user email (#1575)
• fix: Fix missing _ import and supported Vite (#1609)
• fix: Fix missing lodash on Dump screen (#1628)
• fix: Fix non existing property (#1360)
• fix: Fix that multiple use of the same binding is only replaced once in the query (#1503)
• fix: Fix workbench integration and fix compile-assets build (#1601)
• …and 280 more

• 0 containers · 1 bounded contexts · 0 dependency edges (baseline)

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

laravel/telescope was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.