Laravel Time Machine is a performance profiler by <a href="https://github.com/JaydeepGadhiya" target="_blank" rel="noopener nofollow">@jaydeepgadhiya</a> that records every stage of a Laravel request — bootstrap, middleware, routing, controller, response, and termination — with millisecond timings. It answers one question: where did the time go in this request?
Here’s what the package gives you:
<ul>
<li>Lifecycle timeline — a Gantt-style breakdown of each request phase, from framework boot through the <code>terminate</code> step.</li>
<li>Query capture — every SQL statement with bindings, connection, and execution time, toggled via <code>collectors.queries</code>.</li>
<li>Slow highlighting — requests over 500ms and queries over 50ms get flagged, with both thresholds configurable.</li>
<li>Flat-file storage — profiles are plain JSON files in <code>storage/time-machine</code>; no database tables or migrations.</li>
<li>Ignore patterns — asset requests and paths like the Telescope dashboard are skipped via <code>ignore_paths</code>.</li>
<li>Debug-only by default — the profiler follows <code>APP_DEBUG</code>, so it stays off in production unless you enable it.</li>
</ul>
<h2><a href="https://laravel-news.com/laravel-time-machine-a-request-lifecycle-profiler#content-the-timeline-dashboard" target="_blank" rel="noopener nofollow">#</a>The Timeline Dashboard</h2>
Once installed, the package records every HTTP request automatically and serves a self-contained dashboard at <code>/time-machine</code> when enabled. Each request gets a visual timeline showing how long the application spent in each lifecycle phase, alongside memory usage and query counts. Requests that cross the slow threshold (500ms by default) are highlighted so bottlenecks stand out in the list of recent profiles.
<h2><a href="https://laravel-news.com/laravel-time-machine-a-request-lifecycle-profiler#content-custom-instrumentation" target="_blank" rel="noopener nofollow">#</a>Custom Instrumentation</h2>
Beyond the automatic lifecycle phases, you can instrument your own code through the <code>TimeMachine</code> facade. Drop point-in-time markers, wrap a block in a measured closure, or control spans manually:
<pre><code>use Jaydeep\LaravelTimeMachine\Facades\TimeMachine;
</code></pre>
<code> </code>
<code>// Drop a marker on the timeline</code>
<code>TimeMachine::mark('cache primed');</code>
<code> </code>
<code>// Time a code block</code>
<code>$report = TimeMachine::measure('generate-report', function () {</code>
<code>return Report::build();</code>
<code>});</code>
<code> </code>
<code>// Manual span control</code>
<code>TimeMachine::startSpan('external-api');</code>
<code>$response = Http::get('https://api.example.com');</code>
<code>TimeMachine::endSpan('external-api');</code>
Custom spans appear on the same timeline as the framework phases, so you can see how a slow external API call or report generation fits into the overall request.
<h2><a href="https://laravel-news.com/laravel-time-machine-a-request-lifecycle-profiler#content-storage-without-a-database" target="_blank" rel="noopener nofollow">#</a>Storage Without a Database</h2>
Profiles are written as JSON files to <code>storage/time-machine</code>, which means there are no migrations to run and the data never leaves your server. The package retains the most recent 100 profiles by default and prunes the oldest ones as new requests come in; the <code>storage.max_records</code> setting (or the <code>TIME_MACHINE_MAX_RECORDS</code> env variable) adjusts the limit.
<h2><a href="https://laravel-news.com/laravel-time-machine-a-request-lifecycle-profiler#content-how-it-compares-to-telescope-and-debugbar" target="_blank" rel="noopener nofollow">#</a>How It Compares to Telescope and Debugbar</h2>
There’s some overlap with Laravel Telescope and Laravel Debugbar, but the three tools have different scopes. Telescope monitors many parts of an application — requests, jobs, mail, notifications, cache, and more — and stores its entries in the database.
Debugbar renders a toolbar inside the current page with timing and query data for that response.
Time Machine sits in between: it keeps a browsable history of recent requests like Telescope, but collects only lifecycle timing and query data, stores it in flat files, and presents it on a timeline. If you want full application monitoring, Telescope is still the better fit; if you’re profiling where individual requests spend their time, that’s the case this package is built for.
<h2><a href="https://laravel-news.com/laravel-time-machine-a-request-lifecycle-profiler#content-installation-and-configuration" target="_blank" rel="noopener nofollow">#</a>Installation and Configuration</h2>
The package supports Laravel 8 through 13, and installs via Composer with auto-discovery handling the service provider and facade:
<pre><code>composer require jaydeep/laravel-time-machine
</code></pre>
Publishing the config file is optional:
<pre><code>php artisan vendor:publish --tag=time-machine-config
</code></pre>
You can learn more about this package, get full installation instructions, and view the source code on the <a href="https://github.com/JaydeepGadhiya/laravel-timemachine" target="_blank" rel="noopener nofollow">laravel-timemachine GitHub repository</a>.

A community for Laravel developers to share tutorials, best practices, news, tips, and resources. Whether you're a beginner or an expert, join us to stay updated and discuss everything in Laravel! 💯

Laravel Time Machine: A Request Lifecycle Profiler