# Amazon IVS Chat のモニタリング
<a name="chat-health"></a>

Amazon CloudWatch を使用して、Amazon Interactive Video Service (IVS) Chat のリソースをモニタリングできます。CloudWatch は Amazon IVS Chat から未加工データを収集し、リアルタイムに近い読み取り可能なメトリクスに加工します。これらの統計は 15 か月間保持されるため、ウェブアプリケーションやサービスの動作に関する履歴情報を取得できます。特定のしきい値にアラームを設定し、これらのしきい値に達したときに通知を送信したりアクションを実行したりできます。詳細については、[CloudWatch ユーザーガイド](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)を参照してください。

## CloudWatch メトリクスへのアクセス
<a name="chat-health-cloudwatch-metrics"></a>

Amazon CloudWatch は Amazon IVS Chat から未加工データを収集し、ほぼリアルタイムの読み取り可能なメトリクスに加工します。これらの統計は 15 か月間保持されるため、ウェブアプリケーションやサービスの動作に関する履歴情報を取得できます。特定のしきい値にアラームを設定し、これらのしきい値に達したときに通知を送信したりアクションを実行したりできます。詳細については、[CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)を参照してください。

CloudWatch メトリクスは時間の経過とともにロールアップされることに注意してください。メトリクスの経過とともに解像度は実質的に低下します。スケジュールは次のとおりです。
+ 60 秒のメトリクスは 15 日間使用できます。
+ 5 分間のメトリクスは 63 日間使用できます。
+ 1 時間のメトリクスは、455 日 (15 か月) 間使用できます。

データ保持に関する最新情報については、[Amazon CloudWatch のよくある質問](https://aws.amazon.com/cloudwatch/faqs/)の「保持期間」を検索してください。

### CloudWatch コンソールでの手順
<a name="chat-health-cloudwatch-metrics-console"></a>

1. CloudWatch コンソールの [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) を開いてください。

1. サイドナビゲーションで、**[メトリクス]** ドロップダウンをクリックし、**[すべてのメトリクス]** を選択します。

1. **[参照]** タブで、左側のラベルなしのドロップダウンを使用して、チャネルが作成された「ホーム」リージョンを選択します。リージョンの詳細については、「[グローバルソリューション、リージョナルコントロール](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/what-is.html#what-is-aws)」を参照してください。対応するリージョンの一覧については、「[AWS 全般のリファレンス](https://docs.aws.amazon.com/general/latest/gr/ivs.html)」の*Amazon IVS のページ*を参照してください。

1. **[参照]** タブの下部で **IVSChat** 名前空間を選択します。

1. 次のいずれかを行います。

   1. 検索バーに、リソース ID (ARN の一部、`arn:::ivschat:room/<resource id>`) を入力します。

      次に、**[IVSChat]** を選択します。

   1. **[AWS の名前空間]**に **[IVSChat]** が選択可能なサービスとして表示される場合、それを選択します。Amazon IVSChat を使用していて、Amazon CloudWatch にメトリクスを送信している場合にリスト表示されます。(**IVSChat** がリスト表示されていない場合、Amazon IVSChat メトリクスはありません)。

      次に、必要に応じて*ディメンション*グループを選択します。使用可能なディメンションは、以下の「[CloudWatch メトリクス](#chat-health-cloudwatch-metrics-chat)」にリストされています。

1. グラフに追加するメトリクスを選択します。利用可能なメトリックスは、以下の「[CloudWatch メトリクス](#chat-health-cloudwatch-metrics-chat)」にリストされています。

チャットセッションの詳細ページで **[CloudWatch で表示]** ボタンを選択することで、チャットセッションの CloudWatch グラフにアクセスすることもできます。

### CLI の手順
<a name="chat-health-cloudwatch-metrics-cli"></a>

AWS CLI を使用してメトリクスにアクセスすることもできます。そのためには、まず CLI をマシンにダウンロードして設定する必要があります。詳細については、[AWS コマンドラインインターフェイスのユーザーガイド](https://docs.aws.amazon.com//cli/latest/userguide/cli-chap-welcome.html)を参照してください。

次に、AWS CLI を使用して Amazon IVS 低レイテンシーチャットメトリクスにアクセスするために、次の操作を実行します。
+ コマンドプロンプトで、次のコマンドを実行します。

  ```
  aws cloudwatch list-metrics --namespace AWS/IVSChat
  ```

詳細については、*Amazon CloudWatch ユーザーガイド*の「[Amazon CloudWatch メトリクスの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)」を参照してください。

## CloudWatch メトリクス: IVS Chat
<a name="chat-health-cloudwatch-metrics-chat"></a>

Amazon IVS Chat は、**AWS/IVSChat** の名前空間で以下のメトリクスを提供します。


| メトリクス | ディメンション | 説明 | 
| --- | --- | --- | 
|  `ConcurrentChatConnections`  | なし |  チャットルームでの同時接続の総数 (1 分あたりの最大レポート数)。これは、お客様がリージョン内の同時チャット接続の上限に近づいたときに、それを把握するのに役立ちます。 単位: 数 有効な統計: 合計、平均、最大、最小  | 
|  `Deliveries`  | Action |  リージョン内のすべてのルームでのチャット接続への特定のアクションタイプで行われたメッセージングリクエストの配信数。 単位: 数 有効な統計: 合計、平均、最大、最小  | 
|  `InvocationErrors`  | `Uri` |  リージョン内のすべてのルームにおける特定のメッセージレビューハンドラの呼び出しエラーの数。呼び出しエラーは、メッセージレビューハンドラーを呼び出すことができない場合に発生します。 呼び出しエラーは、Amazon IVS Chat がハンドラーを呼び出すことができない場合に発生します。これは、ルームに関連付けられているハンドラーが存在しないかタイムアウトした場合、またはそのリソースポリシーでサービスがルームを呼び出すことを許可していない場合に発生する可能性があります。 単位: 数 有効な統計: 合計、平均、最大、最小  | 
|  `LogDestinationAccessDeniedError`  | `LoggingConfiguration` |  リージョン内のすべてのルームにおけるログ送信先のアクセス拒否エラーの数。 これらのエラーは、Amazon IVS Chat がログ記録設定で指定された送信先リソースにアクセスできない場合に発生します。これは、送信先リソースポリシーで、サービスにレコードの配置が許可されていない場合に発生する可能性があります。 単位: 数 有効な統計: 合計、平均、最大、最小  | 
|  `LogDestinationErrors`  | `LoggingConfiguration` |  リージョン内のすべてのルームにおけるログ送信先のすべてのエラーの数。 これは、あらゆる種類のエラーを含む集計されたメトリクスで、Amazon IVS Chat がログ記録設定で指定された送信先リソースにログを配信できなかった場合に発生するエラーなどが含まれます。 単位: 数 有効な統計: 合計、平均、最大、最小  | 
|  `LogDestinationResourceNotFoundErrors`  | `LoggingConfiguration` |  リージョン内のすべてのルームにおけるログ送信先のリソースが見つからないエラーの数。 これらのエラーは、リソースが存在しないために Amazon IVS Chat がログ記録設定で指定された送信先リソースにログを配信できない場合に発生します。これは、ログ記録設定に関連する送信先リソースが存在しなくなった場合に発生する可能性があります。 単位: 数 有効な統計: 合計、平均、最大、最小  | 
|  `MessagingDeliveries`  | なし |  リージョン内のすべてのルームにわたるチャット接続へのメッセージングリクエストの配信数。 単位: 数 有効な統計: 合計、平均、最大、最小  | 
|  `MessagingRequests`  | なし |  リージョン内のすべてのルームで行われたメッセージリクエストの数。 単位: 数 有効な統計: 合計、平均、最大、最小  | 
|  `Requests`  | Action | リージョン内のすべてのルームで特定のアクションタイプで行われたリクエストの数。 単位: 数 有効な統計: 合計、平均、最大、最小  | 
|  `ResponseValidationErrors`  | `Uri` |  リージョン内のすべてのルームにおける特定のメッセージレビューハンドラーのレスポンス検証エラーの数。メッセージレビューハンドラーからの応答が無効であると、レスポンス検証エラーが発生します。これは、レスポンスを解析できなかったり、検証チェックに失敗した可能性があります。たとえば、無効なレビュー結果やレスポンス値が長すぎる可能性があります。 単位: 数 有効な統計: 合計、平均、最大、最小  |