wamesk / laravel-telescope

2.1.1 2025-10-08 07:07 UTC

Requires

• laravel/telescope: ^5.0

MIT

• laravel
• telescope

Published on Packagist.org on 2025-10-08 07:13 UTC

README

Instalation

composer require wamesk/laravel-telescope

• No setup is required.
• Middleware is added via ServiceProvider in the package.

Search

Adds fulltext search in path, content. Add tags to all requests.

Key	.env	Default	Search without tag	Example
/			✓	/api/v1
Api	TELESCOPE_TAG_API	false	×	Api:GET /api/v1/users
Code	TELESCOPE_TAG_CODE	true	✓	Code:1.2.3
Content			✓	Content:ip_address":"127.0.0.1"
Date	TELESCOPE_TAG_DATE	false	✓	Date:2023-01-01
DateTime	TELESCOPE_TAG_DATE_TIME	false	✓	DateTime:2023-01-01 11:22:33
Email	TELESCOPE_TAG_EMAIL	true	×	Email:[e-mail] or Email:none
Errors	TELESCOPE_TAG_ERROR	true	×	Errors:true
From			✓	From:2024-01-01, From:12:34, From:2024-01-01 12:34...
Hour	TELESCOPE_TAG_HOUR	false	✓	Hour:0 - Hour:23
Method	TELESCOPE_TAG_METHOD	false	✓	Method:GET, Method:POST, Method:UPDATE...
Month	TELESCOPE_TAG_MONTH	false	✓	Month:1 - Month:12
Path	TELESCOPE_TAG_PATH	true	✓	Path:/api/v1
Status	TELESCOPE_TAG_STATUS	false	✓	Status:200, Status:400, Status:500...
Time	TELESCOPE_TAG_TIME	false	✓	Time:11:22
To			✓	To:2024-01-01, To:12:34, To:2024-01-01 12:34...
Url	TELESCOPE_TAG_URL	false	✓	Url:/nova-api/user-groups?page=1&perPage=25

• To disable fulltext search, set TELESCOPE_SEARCH=false in .env.
• You can set the tag saving settings by adding a parameter to the .env e.g. TELESCOPE_TAG_CODE=false
• It is possible to search according to these keys even if saving tags is not allowed.
• By turning off the tag, you will only lose a quick filter.
• Keys can be written in case-insensitive

Data pruning

The package contains command to pruning data. In .env it is possible to set the number of hours how much data to remember. (Default 48 hours)

TELESCOPE_PRUNE_HOURS=168

To cancel the command, set the value to false.

TELESCOPE_PRUNE_HOURS=false

Config caching

The retention window is read from config('wame-telescope.prune_hours'), not from env() at runtime. If the application runs php artisan config:cache, Laravel stops loading the .env file altogether, so publish the config into the application to make the value part of the cached configuration:

php artisan vendor:publish --tag=wame-telescope-config

Without the published file the merged package config is still evaluated at runtime and TELESCOPE_PRUNE_HOURS silently falls back to the 48 hour default on a cached config.