如何解决分布式系统日志管理难题？itspire/monolog-loki助你无缝对接GrafanaLoki

<code class="bash">composer require itspire/monolog-loki</code>

<pre class="brush:php;toolbar:false;">use Monolog\Logger;
use Itspire\MonologLoki\Handler\LokiHandler;

// 创建一个 Monolog Logger 实例
$log = new Logger('my_app');

// 配置 LokiHandler
$lokiHandler = new LokiHandler([
    'entrypoint' => 'http://localhost:3100', // Loki 服务的入口地址
    'client_name' => 'my-php-app-server-01', // 客户端唯一标识
    'labels' => [ // 全局标签，用于在 Loki 中过滤和查询
        'env' => 'production',
        'app' => 'my-php-app',
    ],
    // 如果 Loki 需要认证，可以配置 basic auth
    // 'auth' => [
    //     'basic' => ['username', 'password'],
    // ],
    // 还可以自定义 curl 选项，例如超时时间
    // 'curl_options' => [
    //     CURLOPT_CONNECTTIMEOUT_MS => 500,
    //     CURLOPT_TIMEOUT_MS => 600
    // ]
]);

$log->pushHandler($lokiHandler);

// 现在，你可以像往常一样记录日志了
$log->info('User logged in', ['user_id' => 123, 'ip' => '192.168.1.100']);
$log->error('Database connection failed', ['exception' => 'PDOException']);

<pre class="brush:php;toolbar:false;">use Monolog\Logger;
use Monolog\Handler\WhatFailureGroupHandler;
use Itspire\MonologLoki\Handler\LokiHandler;

$lokiHandler = new LokiHandler([
    'entrypoint' => 'http://localhost:3100',
    'client_name' => 'my-php-app-server-01',
    'labels' => [
        'env' => 'production',
        'app' => 'my-php-app',
    ],
    'curl_options' => [
        CURLOPT_CONNECTTIMEOUT_MS => 500, // 连接超时500毫秒
        CURLOPT_TIMEOUT_MS => 600 // 请求超时600毫秒
    ]
]);

// 使用 WhatFailureGroupHandler 包装 LokiHandler
$robustLokiHandler = new WhatFailureGroupHandler([$lokiHandler]);

$log = new Logger('my_app');
$log->pushHandler($robustLokiHandler);

$log->info('This log will be sent to Loki, or gracefully ignored if Loki is down.');

<pre class="brush:php;toolbar:false;">// config/logging.php
'channels' => [
    // ... 其他日志通道
    'loki' => [
        'driver'         => 'monolog',
        'level'          => env('LOG_LEVEL', 'debug'),
        'handler'        => \Itspire\MonologLoki\Handler\LokiHandler::class,
        'formatter'      => \Itspire\MonologLoki\Formatter\LokiFormatter::class,
        'formatter_with' => [
            'labels' => [], // 可以在这里定义额外的标签
            'context' => [],
            'systemName' => env('LOKI_SYSTEM_NAME', null),
        ],
        'handler_with'   => [
            'apiConfig'  => [
                'entrypoint'  => env('LOKI_ENTRYPOINT', "http://localhost:3100"),
                'client_name' => env('APP_NAME', 'laravel-app'),
                'auth' => [
                    'basic' => [
                        env('LOKI_AUTH_BASIC_USER', ''),
                        env('LOKI_AUTH_BASIC_PASSWORD', '')
                    ],
                ],
            ],
        ],
    ],
    // 同样，在 Laravel 中也可以创建自定义 Handler 来包装 WhatFailureGroupHandler
    'loki_safe' => [
        'driver'    => 'custom',
        'via'       => \App\Logging\LokiNoFailureHandler::class, // 自定义的Handler类
        // ... 其他配置
    ],
],