posapp-vn/laravel-lark-logging

A Laravel package for logging to Lark bot

v1.0.0 2024-12-27 10:04 UTC

Requires

• php: >=8.2
• illuminate/support: ^8.0|^9.0|^10.0|^11.0
• monolog/monolog: >=3.2

MIT

• logging
• monolog
• laravel
• lark
• larksuite

README

Send logs to Lark chat via Lark bot

Install

composer require posapp-vn/laravel-lark-logging

Define Lark Bot Webhook URL in your .env file

LARK_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/<your-hook-id-xxxxxx>

Add to config/logging.php file new channel:

'lark' => [
    'driver' => 'custom',
    'via'    => PosAppVN\LarkLogger\LarkLogger::class,
    'level'  => 'debug',
    'title' => env('APP_NAME', 'Laravel Log'), // optional - title of the message
    'retries' => 3, // optional - retry sending message 3 times
]

Publish config file

php artisan vendor:publish --provider "PosAppVN\LarkLogger\LarkLoggerServiceProvider"

Create bot

For using this package you need to create Lark bot: https://open.larksuite.com/document/client-docs/bot-v3/add-custom-bot

Configuring a different chat id or token per channel

1. Add webhook_url or title to channels in config/logging.php.

[
    'channels' => [

        'lark-log' => [
            'driver' => 'custom',
            'via'    => PosAppVN\LarkLogger\LarkLogger::class,
            'level'  => 'debug',
            'webhook_url' => 'https://open.feishu.cn/open-apis/bot/v2/hook/<your-hook-id-xxxxxx>',
            'title' => 'Laravel Log',
        ],
        
        'lark-system' => [
            'driver' => 'custom',
            'via'    => PosAppVN\LarkLogger\LarkLogger::class,
            'level'  => 'error',
            'webhook_url' => 'https://open.feishu.cn/open-apis/bot/v2/hook/<your-hook-id-xxxxxx>',
            'title' => 'System Log',
        ],

    ]
]