Amazon Chime SDK ミーティングのログ記録とモニタリングの設定
ログ記録は、サーバー側の会議イベントやクライアント側のブラウザコンソールログなどの情報を収集するのに役立ちます。
Amazon Chime SDK は、Amazon EventBridge と Amazon CloudWatch Events のログに送信できるサーバー側の会議イベントを提供します。CloudWatch のメトリクスとインサイトを作成し、ダッシュボードでモニタリングに使用できます。「Server-side Logging and Monitoring of Amazon Chime SDK events
Amazon Chime SDK は、音声と動画の品質、ネットワーク帯域幅、接続の問題に関するクライアント側イベントを提供します。「Monitoring and troubleshooting with Amazon Chime SDK Meeting events
トラブルシューティングメトリクスのオプション
トラブルシューティングイベントの収集では、以下のオプションがあります。
-
イベントごとにメトリクスを送信する
-
N 秒ごとにイベントをバッチ処理する
-
会議の終了時にメトリクスを送信する
-
ブラウザコンソールログのログ記録レベル
推奨メトリクス
少なくとも、以下のメトリクス収集してログ記録する必要があります。
-
SDK プラットフォームとバージョン
-
ブラウザとバージョン
-
オペレーティングシステム
-
論理コア
-
開始された会議
-
終了した会議
-
参加した参加者
-
退出した参加者
-
切断された参加者
さらに、直面している問題に応じて、以下のメトリクスから接続、帯域幅、品質の問題に関する情報が得ることができます。これらのメトリックが発生するたびに記録することも、カウントだけすることもできます。カウントすることで、根本的な問題の概要を把握できます。
-
connectionDidSuggestStopVideo
-
connectionDidBecomeGood
-
connectionDidBecomePoor
-
参加者の参加時間 > t 秒
-
MeetingStartFailed
-
MeetingFailed
クライアント側のログ記録を有効にする
LogLevel.INFO を ConsoleLogger オブジェクトに渡すことで、INFO レベルのブラウザログを有効にできます。
const logger = new ConsoleLogger('MyLogger', LogLevel.INFO);const meetingSession = new DefaultMeetingSession(configuration,logger,deviceController);
JavaScript 用 Amazon Chime SDK の POSTLogger コンポーネントを使用して、Amazon CloudWatch Logs などのバックエンドでブラウザログをキャプチャすることもできます。POSTLogger は、POSTLogger コンストラクターHTTP POST リクエストを行います。例えば、GitHub の Amazon Chime SDK サーバーレスデモPOSTLogger を使用してブラウザログを今後の調査に使用できるように Amazon CloudWatch Logs に送信します。
サーバー側のログ記録を有効にする
JavaScript 用 Amazon Chime SDK では、MeetingStartFailed や MeetingFailed などの主要な会議イベントで eventDidReceive オブザーバーメソッドも呼び出されます。多くの場合、会議イベントには失敗の具体的な理由が含まれます。例えば、多数のお客様で障害が発生したとします。ウェブアプリケーションはこれらの会議イベントを収集し、根本原因をトラブルシューティングするためにその情報を共有できます。会議イベントの詳細については、GitHub の会議イベントガイド
