cebe/yii2-loki-log-target

Grafana Loki Log Target for Yii2

1.2.0 2024-06-06 14:43 UTC

Requires

• php: >=7.1.0
• yiisoft/yii2: ~2.0.0
• yiisoft/yii2-httpclient: ^2.0

MIT

• Carsten Brandt

• logging
• yii2
• grafana
• loki

README

Grafana Loki Log Target for Yii2.

Requirements

• PHP 7.1 or higher (works with PHP 8)
• Yii 2

Install

composer require cebe/yii2-loki-log-target

Usage

Add the log target to your application config:

// ...
'components' => [
    // ...
    'log' => [
        // ...
        'targets' => [
            [
                'class' => \cebe\lokilogtarget\LokiLogTarget::class,
                //'enabled' => YII_ENV_PROD,

                'lokiPushUrl' => 'https://loki.example.com/loki/api/v1/push',
                'lokiAuthUser' => 'loki', // HTTP Basic Auth User
                'lokiAuthPassword' => '...', // HTTP Basic Auth Password

                'levels' => ['error', 'warning', 'info'],

                // optionally exclude categories
                'except' => [
                    'yii\db\Connection::open',
                    'yii\db\Command::execute',
                    'yii\httpclient\StreamTransport::send',
                ],

                // optionally re-map log level for certain categories
                'levelMap' => [
                    // yii category
                    'yii\web\HttpException:404' => [
                        // yii level => loki level
                        // set loki level to false, to drop messages with that category
                        '*' => 'info',
                    ],
                    'yii\web\HttpException:401' => [
                        // yii level => loki level
                        // set loki level to false, to drop messages with that category
                        '*' => 'warning',
                    ],
                ],

            ],
        ],
    ],
]

See also https://www.yiiframework.com/doc/guide/2.0/en/runtime-logging#log-targets.