翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Chime SDK ミーティングのログ記録とモニタリングの設定
<a name="ts-log-monitor"></a>

ログ記録は、サーバー側の会議イベントやクライアント側のブラウザコンソールログなどの情報を収集するのに役立ちます。

Amazon Chime SDK は、Amazon EventBridge と Amazon CloudWatch Events のログに送信できるサーバー側の会議イベントを提供します。CloudWatch のメトリクスとインサイトを作成し、ダッシュボードでモニタリングに使用できます。「[Server-side Logging and Monitoring of Amazon Chime SDK events](https://aws.amazon.com/blogs/business-productivity/server-side-logging-and-monitoring-of-amazon-chime-sdk-events/)」のブログ投稿では、CloudWatch のメトリクス、インサイト、ダッシュボードを有効にする方法について説明しています。

Amazon Chime SDK は、音声と動画の品質、ネットワーク帯域幅、接続の問題に関するクライアント側イベントを提供します。「[Monitoring and troubleshooting with Amazon Chime SDK Meeting events](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/)」のブログ投稿では、参加エラー、音声品質の問題、マイクとカメラの設定エラーに対して、CloudWatch メトリクス、インサイト、ダッシュボードを有効にする方法について説明しています。会議イベントの詳細については、Github の「[Meeting Events](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/06_Meeting_Events.md)」を参照してください。



## トラブルシューティングメトリクスのオプション
<a name="ts-cloudwatch-options"></a>

トラブルシューティングイベントの収集では、以下のオプションがあります。
+ イベントごとにメトリクスを送信する 
+ N 秒ごとにイベントをバッチ処理する 
+ 会議の終了時にメトリクスを送信する 
+ ブラウザコンソールログのログ記録レベル

## 推奨メトリクス
<a name="ts-cloudwatch-metrics"></a>

少なくとも、以下のメトリクス収集してログ記録する必要があります。
+ SDK プラットフォームとバージョン
+ ブラウザとバージョン
+ オペレーティングシステム
+ 論理コア
+ 開始された会議
+ 終了した会議
+ 参加した参加者
+ 退出した参加者
+ 切断された参加者

さらに、直面している問題に応じて、以下のメトリクスから接続、帯域幅、品質の問題に関する情報が得ることができます。これらのメトリックが発生するたびに記録することも、カウントだけすることもできます。カウントすることで、根本的な問題の概要を把握できます。
+ connectionDidSuggestStopVideo
+ connectionDidBecomeGood
+ connectionDidBecomePoor
+ 参加者の参加時間 > t 秒
+ MeetingStartFailed
+ MeetingFailed

## クライアント側のログ記録を有効にする
<a name="client-side-logging"></a>

`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 コンストラクター](https://aws.github.io/amazon-chime-sdk-js/classes/postlogger.html)で指定された URL にブラウザログをアップロードするために、`HTTP POST` リクエストを行います。例えば、[GitHub の Amazon Chime SDK サーバーレスデモ](https://github.com/aws/amazon-chime-sdk-js/blob/main/demos/browser/app/meetingV2/meetingV2.ts#L1773)では、`POSTLogger` を使用してブラウザログを今後の調査に使用できるように Amazon CloudWatch Logs に送信します。

## サーバー側のログ記録を有効にする
<a name="server-side-logging"></a>

JavaScript 用 Amazon Chime SDK では、`MeetingStartFailed` や `MeetingFailed` などの主要な会議イベントで `eventDidReceive` オブザーバーメソッドも呼び出されます。多くの場合、会議イベントには失敗の具体的な理由が含まれます。例えば、多数のお客様で障害が発生したとします。ウェブアプリケーションはこれらの会議イベントを収集し、根本原因をトラブルシューティングするためにその情報を共有できます。会議イベントの詳細については、[GitHub の会議イベントガイド](https://aws.github.io/amazon-chime-sdk-js/modules/meetingevents.html)と、「[Monitoring and troubleshooting with Amazon Chime SDK meeting events](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/)」のブログ投稿を参照してください。