README

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

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

Middleware(Optional)

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

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

use Forecho\LaravelTraceLog\TraceLog; TraceLog::getTraceId();

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(), ]