PHPackages                             request-atlas/laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Debugging & Profiling](/categories/debugging)
4. /
5. request-atlas/laravel

ActiveLibrary[Debugging & Profiling](/categories/debugging)

request-atlas/laravel
=====================

A Laravel package to capture and inspect request execution traces.

v1.0.0(4mo ago)67MITPHPPHP ^8.0

Since Dec 27Pushed 4mo agoCompare

[ Source](https://github.com/bwazik/laravel-request-atlas)[ Packagist](https://packagist.org/packages/request-atlas/laravel)[ RSS](/packages/request-atlas-laravel/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (7)Versions (2)Used By (0)

Request Atlas — Integrated Tracing for Laravel
==============================================

[](#request-atlas--integrated-tracing-for-laravel)

**A high-precision execution profiler providing a hierarchical view of the request lifecycle.**

Request Atlas captures the complete execution flow of your Laravel applications—mapping database queries, cache operations, outbound HTTP calls, and application events into a structured "Execution Tree". Inspect your request's "Story" directly from your terminal or through a polished, educational Web UI.

---

🚀 Why Request Atlas?
--------------------

[](#-why-request-atlas)

Most profilers tell you **what** happened (flat lists) or **what was slow** (flamegraphs). Atlas tells you **how** it happened.

- **Hierarchical Context**: See exactly which controller method or middleware triggered which database query.
- **CLI-First**: Designed for developers who live in the terminal. No browser required.
- **Educational Web UI**: A "Junior-First" approach to performance, explaining the Laravel lifecycle as it happens.
- **IDE Integration**: Open files directly in your favorite editor (**VS Code, Cursor, Trae, PhpStorm, or Antigravity**) from the trace view.
- **Production Ready**: "Smart Disable" in production, request sampling, and high-performance cursor pagination.
- **Data Scrubbing**: Automatically masks sensitive information (passwords, tokens, keys) before saving to the database.
- **Zero-Config Installation**: One command and you're tracing.

---

🛠 Features
----------

[](#-features)

- **Full Lifecycle Tracing**: Captures everything from the public `index.php` to the final `terminating` cleanup.
- **Execution Tree**: Automatically reconstructs parent-child relationships using a LIFO context stack.
- **Deep Database Insight**: Records SQL, interpolates bindings, detects N+1 patterns, and groups queries by table.
- **Comparison Dashboard**: Side-by-side analysis of two traces with a categorical performance breakdown and duration gap indicators.
- **Interactive Story**: A visual flow of your request, explaining the Laravel phases (Entry Point, Middleware, Controller, etc.).
- **Multi-Language**: Fully localized for **English** and **Arabic**.

---

📋 Requirements
--------------

[](#-requirements)

Before installing, ensure your environment meets the following criteria:

- **PHP**: `8.0` - `8.5`
- **Laravel**: `8.x`, `9.x`, `10.x`, `11.x`, or `12.x`
- **Database**: Any SQL-based driver supported by Laravel (MySQL, PostgreSQL, SQLite, SQL Server)
- **Browser**: Modern browser with JavaScript enabled (for the Web UI)

---

📦 Installation
--------------

[](#-installation)

1. **Install via Composer:**

    ```
    composer require request-atlas/laravel
    ```
2. **Run the Automated Setup:**

    ```
    php artisan atlas:install
    ```

    This will publish the configuration, run migrations, and enable the collector in your `.env`.

---

💻 Terminal Usage
----------------

[](#-terminal-usage)

Atlas provides a suite of powerful Artisan commands for fast, pipe-friendly inspection.

### 1. Listing Recent Traffic

[](#1-listing-recent-traffic)

```
php artisan atlas:list
```

**Options:** `--slow`, `--failed`, `--has-n-plus-one`, `--limit=50`.

### 2. The Execution Tree

[](#2-the-execution-tree)

```
php artisan atlas:show {trace_id}
```

Shows a hierarchical tree. Use `--simple` to hide framework noise (migrations, internal events).

### 3. Performance Analysis

[](#3-performance-analysis)

```
php artisan atlas:analyze {trace_id}
```

Runs a diagnostic report: detects slow operations and highlights specific N+1 query candidates.

---

🌐 Web Interface
---------------

[](#-web-interface)

Accessible at `/atlas`, the Web UI is designed for deep exploration.

### IDE Integration

[](#ide-integration)

Every file path in the UI (Controllers, Views, Entry Point) features an "Open in IDE" dropdown, allowing you to quickly jump to the code in **VS Code, Cursor, Trae, PhpStorm, or Antigravity**.

### Comparison Mode

[](#comparison-mode)

Select two traces from the index and click **Compare**.

- **Performance Gap**: Shows exactly how much faster or slower the new request is.
- **Categorical Breakdown**: Compare the number of DB queries, cache hits, and events side-by-side.

### Maintenance & Scalability

[](#maintenance--scalability)

- **Clear All**: A dedicated button in the Web UI to wipe the trace history (equivalent to `atlas:clear`).
- **Infinite Loading**: The index uses high-performance cursor pagination with a "Load More" button, making it snappy even with millions of records.

---

⚙️ Configuration
----------------

[](#️-configuration)

The `config/atlas.php` file allows you to fine-tune Atlas:

- **`enabled`**: Master switch. Defaults to `null`, which automatically **disables** Atlas in production for safety.
- **`sample_rate`**: Control how many requests are recorded (e.g., `0.1` for 10%).
- **`scrubbing`**: Define sensitive keys to be masked (e.g., `password`, `_token`).
- **`ignore`**: Define SQL or Route patterns to skip.
- **`view`**: Control the "Internal Noise" filtering.
- **`events`**: Group framework-internal events to reduce noise.

---

🤝 Atlas vs Laravel Telescope?
-----------------------------

[](#-atlas-vs-laravel-telescope)

FeatureRequest AtlasLaravel Telescope**Primary Goal****Hierarchy & Flow**Feature Monitoring**Question it answers**"How did this happen?""What happened?"**Best for**Debugging & LearningGeneral Auditing**Footprint**Ultra-LightweightMedium/Heavy

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance74

Regular maintenance activity

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

142d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1793f983aa555664690ede286a627d581f0ca7b7a1352bacb0942d944dc157b4?d=identicon)[bwazik](/maintainers/bwazik)

---

Top Contributors

[![bwazik](https://avatars.githubusercontent.com/u/75957371?v=4)](https://github.com/bwazik "bwazik (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/request-atlas-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/request-atlas-laravel/health.svg)](https://phpackages.com/packages/request-atlas-laravel)
```

###  Alternatives

[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k12.1M99](/packages/laravel-pulse)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[yadahan/laravel-authentication-log

Laravel Authentication Log provides authentication logger and notification for Laravel.

416632.8k5](/packages/yadahan-laravel-authentication-log)[fumeapp/modeltyper

Generate TypeScript interfaces from Laravel Models

196277.9k](/packages/fumeapp-modeltyper)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

44643.1k1](/packages/pressbooks-pressbooks)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)