laravel teams logging

Laravel-Teams-Logging

Laravel Handler для отправки сообщений командам Microsoft с помощью входящего разъема Webhook.

Установка

Требовать этот пакет с композитором.

$ composer require margatampu/laravel-teams-logging

Интеграция

Пакет протестирован и работал с Laravel и Lumen Framework (10+).

Laravel : После установки с использованием Composer Finsive Up, вам придется добавить следующую строку в свой config/app.php :

 MargaTampu  LaravelTeamsLogging  LoggerServiceProvider ::class

Lumen : для Lumen вам придется добавить следующую строку в свой bootstrap/app.php :

 $ app -> register ( MargaTampu  LaravelTeamsLogging  LoggerServiceProvider ::class);

Laravel : затем скопируйте файл конфигурации teams из Laravel-Teams-Logging в вашу папку конфигурации:

$ php artisan vendor:publish --provider= " MargaTampuLaravelTeamsLoggingLoggerServiceProvider "

Lumen : для Lumen вам нужно скопировать файл вручную в папку конфигурации и включить его в bootstrap/app.php :

 $ app -> configure ( ' teams ' );

Создайте пользовательский канал, используя файл журнала Laravel или создайте новый файл конфигурации журнала для Lumen.

Добавьте эту конфигурацию в файл config/logging.php

 ' teams ' => [
    ' driver '    => ' custom ' ,
    ' via '       =>  MargaTampu  LaravelTeamsLogging  LoggerChannel ::class,
    ' level '     => ' debug ' ,
    ' url '       => env ( ' INCOMING_WEBHOOK_URL ' ),
    ' style '     => ' simple ' ,    // Available style is 'simple' and 'card', default is 'simple'
],

Или просто добавьте имя, чтобы указать различное имя проекта для каждого разъема.

 ' teams ' => [
    ' driver '    => ' custom ' ,
    ' via '       =>  MargaTampu  LaravelTeamsLogging  LoggerChannel ::class,
    ' level '     => ' debug ' ,
    ' url '       => env ( ' INCOMING_WEBHOOK_URL ' ),
    ' style '     => ' simple ' ,    // Available style is 'simple' and 'card', default is 'simple'
    ' name '      => ' Dummy Project '
],

Есть 2 доступных стиля для сообщения Microsoft Teams, используя Simple и Card. Вы можете увидеть стиль карты в стиле результатов, что отличается от простого стиля.

После добавления конфигураций в ваш файл config/logging.php добавьте переменную INCOMING_WEBHOOK_URL в ваш файл .env с URL -адресом разъема из вашего соединителя Microsoft Teams. Пожалуйста, прочитайте документ Microsoft Teams, чтобы найти URL -адрес вашего соединителя.

Использование

Чтобы отправить простое сообщение об ошибке на канал команды, вы используете сценарий ниже:

 Log :: channel ( ' teams ' )-> error ( ' Error message ' );

Или вы можете включить дополнительную информацию в сообщении карты, используя контекст журнала.

 Log :: channel ( ' teams ' )-> error ( ' Error message ' , [
    ' name '  => ' value ' ,
    ' Assigned to ' => ' Unassigned '
]);

При использовании простого стиля контекст журнала будет игнорировать из сообщения.

Вы также можете добавить teams в канал stack по умолчанию, чтобы все ошибки автоматически отправлялись на канал teams .

 ' channels ' => [
    ' stack ' => [
        ' driver ' => ' stack ' ,
        ' channels ' => [ ' single ' , ' teams ' ],
    ],
],

Результаты

Вот некоторые результаты уведомлений, отправленных на канал Microsoft Teams с использованием стиля карт.

• Предварительный просмотр журнала отладки в канале Microsoft Teams

• Предварительный просмотр журнала информации в канале Microsoft Teams

• Предварительный просмотр журнала уведомления в канале Microsoft Teams

• Предварительный просмотр журнала предупреждения на канале Microsoft Teams

• Предварительный просмотр журнала ошибок в канале Microsoft Teams

• Предварительный просмотр критического журнала в канале Microsoft Teams

• Предварительный просмотр журнала оповещения в канале Microsoft Teams

• Предварительный просмотр экстренного журнала в канале Microsoft Teams

Лицензия

Этот пакет Laravel-Teams-Logging доступен по лицензии MIT. Смотрите файл лицензии для получения дополнительной информации.