laravel teams logging

laravel-teams-logging

Laravelハンドラーは、受信するWebhookコネクタを使用してMicrosoftチームにメッセージを送信します。

インストール

作曲家とのこのパッケージが必要です。

$ composer require margatampu/laravel-teams-logging

統合

パッケージは、LaravelおよびLumen Framework（10+）でテストして動作しました。

LARAVEL ：Composerを使用してインストールした後、 config/app.phpに次の行を追加する必要があります。

 MargaTampu  LaravelTeamsLogging  LoggerServiceProvider ::class

Lumen ：Lumenの場合、 bootstrap/app.phpに次の行を追加する必要があります。

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

Laravel ：次に、Laravel-Teams-LoggingからConfig Folderへのteams構成ファイルをコピーします。

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

ルーメン：ルーメンの場合、ファイルを手動で構成フォルダーにコピーし、 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 '
],

Microsoft Teamsメッセージには、SimpleとCardを使用した2つのスタイルがあります。シンプルなスタイルとの違いである結果スタイルのカードスタイルを見ることができます。

config/logging.phpファイルにconfigsを追加したら、microsoftチームコネクタのコネクタURLを使用して.envファイルにINCOMING_WEBHOOK_URL変数を追加します。マイクロソフトチームのドキュメントを読んで、コネクタURLを見つけてください。

使用法

Teamsチャンネルに簡単なエラーメッセージを送信するには、以下にスクリプトを親切に使用してください。

 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ライセンスの下で入手できます。詳細については、ライセンスファイルを参照してください。