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

# CloudWatch で Amazon Kinesis Video Streams Edge エージェントをモニタリングする
<a name="monitoring-edge-cloudwatch"></a>

Amazon CloudWatch を使用して Amazon Kinesis Video Streams Amazon CloudWatch は raw データを収集し、読み取り可能なほぼリアルタイムのメトリクスに加工します。これらの統計は 15 か月間記録されます。この履歴情報を使用すると、ウェブアプリケーションまたは Amazon Kinesis Video Streams Edge Agent サービスのパフォーマンスをより的確に把握できます。

メトリクスを表示するには、以下を実行します。

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) で CloudWatch コンソールを開きます。

1. 左側のナビゲーションの**メトリクス**で、**すべてのメトリクス**を選択します。

1. **参照**タブを選択し、**EdgeRuntimeAgent** カスタム名前空間を選択します。

Amazon Kinesis Video Streams Edge Agent は、 名前空間 に次のメトリクスを発行します`EdgeRuntimeAgent`。



- ** ストリーム名、 `RecordJob` **
  - **State:** 実行中 / **説明:** `RecordJob` の実行時に継続的に発行します。<br />単位: なし。「1」は`RecordJob`、 がこの状態にある限り発行されます。
  - **State:** FatalError / **説明:** `RecordJob` 致命的なエラーが発生した場合に発行します。<br />単位: なし。「1」は、このイベントが発生すると 1 回発行されます。 詳細については、「 ログ」を参照してください。 
  - **State:** 完了 / **説明:** `RecordJob` が完了すると発行されます。<br />単位: なし。「1」は、このイベントが発生すると 1 回発行されます。

- ** ストリーム名、 `UploadJob` **
  - **State:** 実行中 / **説明:** `UploadJob` の実行時に継続的に発行します。<br />単位: なし。「1」は`UploadJob`、 がこの状態にある限り発行されます。
  - **State:** FatalError / **説明:** `UploadJob` 致命的なエラーが発生した場合に発行します。<br />単位: なし。「1」は、このイベントが発生すると 1 回発行されます。 詳細については、「 ログ」を参照してください。 
  - **State:** 完了 / **説明:** `UploadJob` が完了すると発行されます。<br />単位: なし。「1」は、このイベントが発生すると 1 回発行されます。

- ** ストリーム名 **
  - **State:** PercentageSpaceUsed
  - **説明:** これは、Amazon Kinesis Video Streams Edge Agent 設定で記録メディアに割り当てられた合計領域のうち、使用された割合です。詳細については「[LocalSizeConfig](API_LocalSizeConfig.md)」を参照してください。<br />単位: パーセンテージ (スケール 0～1)。

- ** モノの名前 **
  - **State:** アライブ / **説明:** 実行中の設定に関係なく、Amazon Kinesis Video Streams Edge Agent から毎分発行します。<br />これは、Amazon Kinesis Video Streams Edge Agent が稼働していて、設定を受け入れる準備ができているかどうかを理解するために使用できます。<br />単位: なし。「1」は毎分発行されます。
  - **State:** RecordJobs.HealthyJobCount / **説明:** Amazon Kinesis Video Streams Edge Agent で実行されているレコードジョブとスケジュールされたレコードジョブの合計数。<br />単位: 個
  - **State:** UploadJobs.HealthyJobCount / **説明:** Amazon Kinesis Video Streams Edge Agent で実行中およびスケジュールされたアップロードジョブの合計数。<br />単位: 個
  - **State:** RecordJobs.UnhealthyJobCount / **説明:** 現在エラーが発生しているレコードジョブの合計数。<br />単位: 個
  - **State:** UploadJobs.UnhealthyJobCount / **説明:** 現在エラーが発生しているアップロードジョブの合計数。<br />単位: 個
  - **State:** RecordJobs.RunningJobCount / **説明:** アクティブに実行されているレコードジョブの合計数。<br />単位: 個
  - **State:** UploadJobs.RunningJobCount / **説明:** アクティブに実行されているアップロードジョブの合計数。<br />単位: 個
  - **State:** RecordJobs.EdgeConfigCount / **説明:** Amazon Kinesis Video Streams Edge Agent で処理中のレコード設定の合計数。<br />単位: 個
  - **State:** UploadJobs.EdgeConfigCount / **説明:** Amazon Kinesis Video Streams Edge Agent で進行中のアップロード設定の合計数。<br />単位: 個



## Amazon Kinesis Video Streams Edge Agent の CloudWatch メトリクスガイダンス Amazon Kinesis Video Streams
<a name="monitoring-edge-qa"></a>

CloudWatch メトリクスは、次の質問に対する回答を見つけるのに役立ちます。

**Topics**
+ [Amazon Kinesis Video Streams Edge エージェントには、記録するのに十分なスペースがありますか?](#monitoring-edge-space)
+ [Amazon Kinesis Video Streams Edge エージェントは稼働していますか?](#monitoring-edge-alive)
+ [異常なジョブはありますか?](#monitoring-edge-unhealthy)
+ [外部からの介入が必要なジョブはありますか?](#monitoring-edge-intervention)

### Amazon Kinesis Video Streams Edge エージェントには、記録するのに十分なスペースがありますか?
<a name="monitoring-edge-space"></a>

**関連するメトリクス:** `PercentageSpaceUsed`

**アクション:** アクションは必要ありません。

### Amazon Kinesis Video Streams Edge エージェントは稼働していますか?
<a name="monitoring-edge-alive"></a>

**関連するメトリクス:** `Alive`

**アクション:** このメトリクスの受信を停止すると、Amazon Kinesis Video Streams Edge Agent で次のいずれか**または複数**が発生したことを意味します。
+ アプリケーションランタイムの問題: メモリやその他のリソースの制約、バグなど
+ シャットダウン、クラッシュ、または終了時にエージェントが実行している AWS IoT デバイス
+  AWS IoT デバイスにはネットワーク接続がありません

### 異常なジョブはありますか?
<a name="monitoring-edge-unhealthy"></a>

**関連するメトリクス:**
+ `RecordJobs.UnhealthyJobCount`
+ `UploadJobs.UnhealthyJobCount`

**アクション:** ログを検査し、 `FatalError`メトリクスを探します。
+ `FatalError` メトリクス****が存在する場合、致命的なエラーが発生したため、ジョブを手動で再起動する必要があります。を使用してジョブを手動で再起動する前に`StartEdgeConfigurationUpdate`、ログを検査し、問題を修正します。
+ `FatalError` メトリクス****が存在しない場合、一時的な (致命的ではない) エラーが発生し、Amazon Kinesis Video Streams Edge Agent がジョブを再試行しています。

**注記**  
エージェントが致命的に誤ったジョブを再試行するには、 を使用します[StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md)。

### 外部からの介入が必要なジョブはありますか?
<a name="monitoring-edge-intervention"></a>

**関連するメトリクス:**
+ `PercentageSpaceUsed` – これが特定の値を超えると、レコードジョブは一時停止され、スペースが利用可能なとき (メディアの保持期間外になったとき) にのみ再開されます。より高い で更新された設定を送信`MaxLocalMediaSizeInMB`して、ジョブをすぐに更新できます。
+ `RecordJob.FatalError` / `UploadJob.FatalError` – エージェントのログを調査し、ジョブを再開するための設定を再度送信します。

**アクション:** 設定を使用して API コールを行い、この問題が発生したジョブを再起動します。