ronasit/laravel-telescope-extension

Laravel library for Telescope

0.1 2025-07-03 09:08 UTC

Requires

• php: ^8.4
• laravel/framework: >=11.44.1
• laravel/telescope: ^5
• muhammadhuzaifa/telescope-guzzle-watcher: ^3.2

Requires (Dev)

• ext-pdo: *
• mpyw/laravel-database-mock: ^0.0.1@alpha
• orchestra/testbench: ^9.8
• php-coveralls/php-coveralls: ^2.7
• phpunit/phpunit: ^10.5

MIT

• Ronas IT

• laravel
• telescope

README

The library extends the Laravel Telescope's package.

Installation

Install the package using the following command

composer require ronasit/laravel-telescope-extension

Publish the package configuration:

php artisan vendor:publish --provider=RonasIT\\TelescopeExtension\\TelescopeExtensionServiceProvider

That's it!

Features

Updated prune command

Manually call the console command telescope:prune with your options or specify it into schedule. For example:

php artisan telescope:prune --set-hours=request:240,query:24,unresolved_exception:480 --hours=100

The explanation: remove all records with entry type request older than 240 hours, with entry type query older than 24 hours, and entry type unresolved-exception older than 480 hours. Also, remove records of all other entry types older than 100 hours.

Command's options have the following formats:

Option	Format	Description
--set-hours	[entry-type]:[hours],[entry-type]:[hours]...	List of rules for specified entry types
--hours	[hours]	Rule for all other entry types

Here is the list of possible entry-type values:

Entry Type
batch
cache
dump
event
exception
job
log
mail
model
notification
query
redis
request
schedule
gate
view
unresolved_exception
resolved_exception
completed_job

Store content in JSON field

The content field in the telescope_entries table now has the jsonb type which makes it easier to work with using the database management system's tools.

Production Filter

Feel free to use the predefined telescope filter for the production environment. It'll collect next entries:

• Exceptions

• Incoming HTTP requests with the status >= 400

• Outgoing HTTP requests with the status >= 400

• Failed jobs

• Slow DB queries

• Scheduled tasks

To enable the filter just use it in your own TelescopeServiceProvider

Telescope::filter(call_user_func(new \RonasIT\TelescopeExtension\Filters\ProductionFilter));

Request Watcher

The extended Request watcher works with the new configuration and allows skipping incoming HTTP requests based on the message field in the response:

        RequestWatcher::class => [
            .....
            'ignore_error_messages' => [],
        ],