Download the PHP package grazulex/laravel-chronotrace without Composer
On this page you can find all versions of the php package grazulex/laravel-chronotrace. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download grazulex/laravel-chronotrace
More information about grazulex/laravel-chronotrace
Files in grazulex/laravel-chronotrace
Package laravel-chronotrace
Short Description Record and replay Laravel requests deterministically and generate tests from production traces.
License MIT
Homepage https://github.com/grazulex/laravel-chronotrace
Informations about the package laravel-chronotrace
Laravel ChronoTrace
⏱️ Record and replay Laravel requests deterministically — capture all database queries, cache operations, HTTP calls, and queue jobs for debugging and analysis.
[](https://packagist.org/packages/grazulex/laravel-chronotrace) [](https://packagist.org/packages/grazulex/laravel-chronotrace) [](https://github.com/Grazulex/laravel-chronotrace/blob/main/LICENSE.md) [](https://php.net/) [](https://laravel.com/) [](https://github.com/Grazulex/laravel-chronotrace/actions) [](https://github.com/laravel/pint)📖 Overview
Laravel ChronoTrace is a powerful debugging and monitoring tool for Laravel applications that allows you to:
- 🎯 Capture HTTP requests and their complete execution context (DB queries, cache operations, external HTTP calls, queue jobs)
- 🔄 Replay traces to analyze what happened during specific requests
- 🔍 Debug production issues with comprehensive event logs
- 📊 Monitor application performance and identify bottlenecks
Perfect for debugging hard-to-reproduce issues, performance analysis, and understanding complex application flows.
✨ Features
- ⏺️ Smart Recording – Multiple recording modes: always, sample rate, error-only, or targeted routes
- 📊 Comprehensive Event Capture – Database queries, cache operations, HTTP requests, queue jobs, and custom events
- 🔄 Detailed Replay – View complete execution flow with timestamps and performance metrics
- 🎯 Flexible Filtering – Focus on specific event types (DB, cache, HTTP, jobs) during analysis
- 💾 Multiple Storage Options – Local storage, S3, or custom storage adapters
- 🔐 PII Scrubbing – Automatically mask sensitive data (passwords, tokens, emails, etc.)
- ⚡ Async Storage – Queue-based storage for minimal performance impact
- 🗂️ Automatic Cleanup – Configurable retention policies and automatic purging
📦 Installation
Requirements:
- PHP 8.3+
- Laravel 12.x
🚀 Quick Start
1️⃣ Install and Configure
2️⃣ Configure Recording Mode
Edit config/chronotrace.php
or set environment variables:
3️⃣ Record Traces
For debugging real application issues:
For testing ChronoTrace configuration:
💡 Key Difference:
chronotrace:record
captures real HTTP requests for debugging actual issues, whilechronotrace:test-internal
validates that ChronoTrace is properly configured and working.
4️⃣ View Your Traces
5️⃣ Filter Events and Generate Tests
🔧 Storage & Configuration
- Local Storage:
storage/chronotrace/{date}/{trace-id}/
- S3/Minio: Support for distributed setups with configurable buckets
- Automatic Cleanup: TTL-based purge policies (default: 15 days)
- Compression: Configurable compression for large traces
- PII Scrubbing: Automatic masking of sensitive fields
📊 What Gets Captured
Each trace includes comprehensive information:
🔧 Available Commands
Recording & Analysis Commands
chronotrace:record
– Record real HTTP requests for debugging actual application issueschronotrace:list
– List stored traces with metadata and filtering optionschronotrace:replay
– Replay and analyze captured traces with advanced filtering and output formatschronotrace:purge
– Remove old traces based on retention policy
Setup & Testing Commands
chronotrace:install
– Install and configure ChronoTrace middlewarechronotrace:test-internal
– Test ChronoTrace configuration with internal Laravel operationschronotrace:test-middleware
– Test middleware installation and activationchronotrace:diagnose
– Diagnose configuration and potential issues with comprehensive checks
Command Examples
📊 Use Cases
- Bug Reproduction – No more “can’t reproduce locally” issues
- Test Generation – Build realistic tests from production data
- Performance Audits – Find slow queries, N+1s and cache misses
- Configuration Validation – Diagnose setup issues with built-in tools
- Onboarding – Help new devs understand complex flows via execution graphs
🔐 Security & Privacy
- PII scrubbing by default (configurable fields)
- Trace encryption at rest
- Trace TTL & purge policies
- Audit log of trace access
🤝 Contributing
We welcome contributions! See CONTRIBUTING.md for details.
📚 Documentation
Pour une documentation complète et détaillée, consultez notre Wiki officiel :
- Installation Guide - Guide complet d'installation et de configuration
- Configuration - Toutes les options de configuration disponibles
- Recording Modes - Modes d'enregistrement et cas d'usage
- Commands Reference - Documentation complète de toutes les commandes
- Storage Options - Configuration du stockage local et S3
- Advanced Usage - Techniques avancées et cas d'usage complexes
- Troubleshooting - Solutions aux problèmes courants
- API Reference - Documentation de l'API interne
Laravel ChronoTrace is open-sourced software licensed under the MIT license.
Made with ❤️ for the Laravel community
All versions of laravel-chronotrace with dependencies
illuminate/support Version ^12.19
nesbot/carbon Version ^3.10
illuminate/contracts Version ^12.0