PHPackages                             timadey/trailscope - 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. [Logging & Monitoring](/categories/logging)
4. /
5. timadey/trailscope

ActiveLibrary[Logging & Monitoring](/categories/logging)

timadey/trailscope
==================

Laravel request tracing and user journey observability with step logging, dashboard insights, and database or Redis storage.

v0.1.0(1mo ago)05MITPHPPHP ^8.1

Since Jun 7Pushed 1mo agoCompare

[ Source](https://github.com/Timadey/trailscope)[ Packagist](https://packagist.org/packages/timadey/trailscope)[ RSS](/packages/timadey-trailscope/feed)WikiDiscussions main Synced 1w ago

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

 [![TrailScope logo](art/logo.svg)](art/logo.svg)

TrailScope
==========

[](#trailscope)

TrailScope is a Laravel request tracing and user journey observability package with step logging, dashboard insights, and database or Redis storage.

Install
-------

[](#install)

```
composer require timadey/trailscope
php artisan vendor:publish --tag=trail-config
php artisan vendor:publish --tag=trail-migrations
php artisan migrate
php artisan trail:user admin@example.com --name="Admin" --role=admin
```

Capture Requests
----------------

[](#capture-requests)

Add the middleware to routes that should be traced:

```
Route::middleware('trail')->group(function () {
    Route::post('/transfer', TransferController::class);
});
```

Exclude noisy paths in `config/trail.php`:

```
'capture' => [
    'except_paths' => ['health', 'up', 'horizon/*'],
],
```

Add Developer Steps
-------------------

[](#add-developer-steps)

```
step('charging wallet', $wallet, $amount, $response);
```

For the clearest context keys, use named arguments or an associative array:

```
step('checking network', product: $product, is_active: $is_active);
step('checking network', ['product' => $product, 'is_active' => $is_active]);
```

TrailScope also infers simple positional variable names, so `step('checking network', $product, $is_active)` is stored as `product` and `is_active` when possible. Complex expressions fall back to generated keys.

TrailScope automatically attaches the step to the active request trace, normalizes context, sanitizes sensitive data, resolves identity, and stores the trace through the configured driver.

Storage
-------

[](#storage)

The default storage driver is the host database. Redis is also available:

```
TRAIL_STORAGE_DRIVER=redis
TRAIL_REDIS_CONNECTION=default
TRAIL_REDIS_PREFIX=trail
TRAIL_REDIS_TTL_DAYS=90
```

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance90

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity32

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

48d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5b744b99641f449d0a728d847610896780b56a585302711bb6b9a23caca99e12?d=identicon)[Timadey](/maintainers/Timadey)

---

Top Contributors

[![Timadey](https://avatars.githubusercontent.com/u/65812744?v=4)](https://github.com/Timadey "Timadey (6 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/timadey-trailscope/health.svg)

```
[![Health](https://phpackages.com/badges/timadey-trailscope/health.svg)](https://phpackages.com/packages/timadey-trailscope)
```

###  Alternatives

[laravel/pulse

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

1.7k15.1M136](/packages/laravel-pulse)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M347](/packages/psalm-plugin-laravel)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M133](/packages/roots-acorn)[api-platform/laravel

API Platform support for Laravel

58174.6k17](/packages/api-platform-laravel)

PHPackages © 2026

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