kartmax/telescope

A fork of Laravel Telescope fine tuned for KartmaX

v1.0.8 2025-06-09 13:56 UTC

Requires

• php: ^7.3|^8.0
• ext-json: *
• async-aws/s3: ^2.9
• laravel/framework: ^8.37|^9.0
• symfony/var-dumper: ^5.0|^6.0

Requires (Dev)

• ext-gd: *
• guzzlehttp/guzzle: ^6.0|^7.0
• orchestra/testbench: ^6.0|^7.0

MIT

• Sagar Chauhan
• KartmaX

• s3
• debugging
• monitoring
• laravel
• s3 logs

README

Introduction

KartmnaX Telescope is an elegant debug assistant for the Laravel framework, building on the original Laravel Telescope. In addition to all the features of Telescope, KartmnaX Telescope introduces support for S3 storage and enhanced environment-based configuration, making it suitable for distributed and cloud-native environments.

Key Features

• All features of Laravel Telescope
• S3 Storage Support: Store Telescope entries in AWS S3 (or any compatible object storage)
• Custom Environment Tags: Add static and dynamic tags to every entry for better filtering and multi-tenant support
• Production Enablement: Optionally enable Telescope in production with fine-grained control

S3 Storage Usage

To use S3 as the storage backend for KartmnaX Telescope, set the following in your .env:

TELESCOPE_DRIVER=s3
TELESCOPE_S3_DISK=s3           # The Laravel disk to use (default: s3)
TELESCOPE_S3_DIRECTORY=telescope # The directory/prefix in the bucket (default: telescope)

Ensure your config/filesystems.php is configured for your S3 disk.

Environment Variables

KartmnaX Telescope can be configured using the following environment variables:

Custom Tags

You can attach custom tags to every entry using the following configuration:

• TELESCOPE_CUSTOM_STATIC_TAG: A static string tag (e.g., service name)
• TELESCOPE_CUSTOM_DYNAMIC_TAG: A class name resolved from the container, whose value will be used as a tag (e.g., tenant/site token)

Production Usage

To enable KartmnaX Telescope in production, set:

TELESCOPE_ENABLED_IN_PROD=true

Access is still protected by the authorization gate.

Official Documentation

For general usage, see the Laravel Telescope documentation. For S3 and advanced configuration, refer to this README.

Contributing

Thank you for considering contributing to KartmnaX Telescope! Please see the Laravel contribution guide.

Code of Conduct

Please review and abide by the Code of Conduct.

Security Vulnerabilities

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

License

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