PHPackages                             forecho/laravel-trace-log - 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. forecho/laravel-trace-log

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

forecho/laravel-trace-log
=========================

trace log for laravel

v1.1.3(3y ago)718.3k↓12.7%1MITPHPPHP >=7.2

Since Jan 17Pushed 3y ago1 watchersCompare

[ Source](https://github.com/forecho/laravel-trace-log)[ Packagist](https://packagist.org/packages/forecho/laravel-trace-log)[ RSS](/packages/forecho-laravel-trace-log/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)DependenciesVersions (14)Used By (0)

Trace Log for Laravel/Lumen
===========================

[](#trace-log-for-laravellumen)

[![Latest Stable Version](https://camo.githubusercontent.com/7b36f80aeaaec904f881bc42ac7e7bda906db9382f10a80afbfa911390cd01b9/68747470733a2f2f706f7365722e707567782e6f72672f666f726563686f2f6c61726176656c2d74726163652d6c6f672f762f737461626c652e737667)](https://packagist.org/packages/forecho/laravel-trace-log)[![Latest Unstable Version](https://camo.githubusercontent.com/a5e33105cd5556ed612a871b33634796082287e12cebb5ecd37dbb50e0e63a43/68747470733a2f2f706f7365722e707567782e6f72672f666f726563686f2f6c61726176656c2d74726163652d6c6f672f762f756e737461626c652e737667)](https://packagist.org/packages/forecho/laravel-trace-log)[![Total Downloads](https://camo.githubusercontent.com/b83d39ce71eebe72f2e98b144b741f853612d8eefe452c39ed5828f7401ef773/68747470733a2f2f706f7365722e707567782e6f72672f666f726563686f2f6c61726176656c2d74726163652d6c6f672f646f776e6c6f616473)](https://packagist.org/packages/forecho/laravel-trace-log)[![License](https://camo.githubusercontent.com/4c7ab96df2248a1bceffcbcc95ec2d6c06c2d1e72399b6030c2adb6ddf5ccc6d/68747470733a2f2f706f7365722e707567782e6f72672f666f726563686f2f6c61726176656c2d74726163652d6c6f672f6c6963656e7365)](https://packagist.org/packages/forecho/laravel-trace-log)

Install
-------

[](#install)

```
composer require forecho/laravel-trace-log
```

if you use Lumen, you need add service provider to your `bootstrap/app.php` file.

```
$app->register(Forecho\LaravelTraceLog\TraceLogServiceProvider::class);
```

Configuration
-------------

[](#configuration)

This step is optional

```
php artisan vendor:publish --provider="Forecho\LaravelTraceLog\TraceLogServiceProvider"
```

if you use Lumen, you need add config file to your `config` directory.

```
cp vendor/forecho/laravel-trace-log/config/tracelog.php config/
```

and you need add code to your `bootstrap/app.php` file.

```
$app->configure('tracelog');
```

**Note**

- The number of bits of the value corresponding to the key in `log_filter_half_hide_keys` must be greater than 2, otherwise all data is hidden.
- If the configuration file causes an error, the filtering function will be invalid, the error message can be searched for `request_params_filter_key_config_error` to view the log.

`additional_fields` is an array of additional fields that will be added to the log. eg:

```
'additional_fields' => [
    'user_id' => [App\Models\User::class, 'getId'],
    'tag' => 'test', // value can use closure、string、array
  ],
```

add `getId()` method to User model, and the value of the field will be the return value of the method.

```
namespace App\Models;

class User
{
    public static function getId(): ?int
    {
        return data_get(Auth::user(), 'id');
    }
}
```

Usage
-----

[](#usage)

### Middleware(Optional)

[](#middlewareoptional)

change `App\Http\Kernel.php` file to add `TraceLogMiddleware` middleware.

```
use Forecho\LaravelTraceLog\Middleware\TraceLogMiddleware;

protected $middlewareGroups = [
    // ...

    'api' => [
        // ...
        'request.tracelog'
    ],
];

protected $routeMiddleware = [
    // ...
    'request.tracelog' => TraceLogMiddleware::class
];
```

### Logging

[](#logging)

```
use Forecho\LaravelTraceLog\TraceLog;

TraceLog::warning('This is a warning message.', ['foo' => 'bar']);
TraceLog::error('This is an error message.', ['foo' => 'bar']);
TraceLog::info('This is an info message.', ['foo' => 'bar']);
TraceLog::debug('This is a debug message.', ['foo' => 'bar']);
```

### Get Trace ID

[](#get-trace-id)

```
use Forecho\LaravelTraceLog\TraceLog;

TraceLog::getTraceId();
```

### Curl Request

[](#curl-request)

if you want next system use the same trace\_id, you need add `trace_id` to your `header`

```
use Forecho\LaravelTraceLog\TraceLog;

$key = config('tracelog.trace_id_header_key');
$headers = [
  $key => TraceLog::getTraceId(),
]
```

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95% 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

Every ~17 days

Recently: every ~40 days

Total

13

Last Release

1424d ago

Major Versions

v0.2.0 → v1.0.02022-03-03

### Community

Maintainers

![](https://www.gravatar.com/avatar/4c0612f70d09feb06ab5d24a31e0cc551f1ee547b42308c695e34d76181f18cf?d=identicon)[forecho](/maintainers/forecho)

---

Top Contributors

[![forecho](https://avatars.githubusercontent.com/u/1725326?v=4)](https://github.com/forecho "forecho (19 commits)")[![mengdream](https://avatars.githubusercontent.com/u/3888694?v=4)](https://github.com/mengdream "mengdream (1 commits)")

---

Tags

laravellaravel-packagetracelog

### Embed Badge

![Health badge](/badges/forecho-laravel-trace-log/health.svg)

```
[![Health](https://phpackages.com/badges/forecho-laravel-trace-log/health.svg)](https://phpackages.com/packages/forecho-laravel-trace-log)
```

###  Alternatives

[psr/log

Common interface for logging libraries

10.4k1.2B11.5k](/packages/psr-log)[open-telemetry/api

API for OpenTelemetry PHP.

1941.5M277](/packages/open-telemetry-api)[open-telemetry/sdk

SDK for OpenTelemetry PHP.

2328.5M343](/packages/open-telemetry-sdk)

PHPackages © 2026

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