を使用した Amazon Kinesis Video Streams Edge Agent のモニタリング CloudWatch

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

メトリクスを表示するには、次の手順を実行します。

1. にサインイン AWS Management Console し、https://console.aws.amazon.com/cloudwatch/ で CloudWatch コンソールを開きます。

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

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

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

ディメンション	状態	説明
ストリーム名、 RecordJob	実行中	RecordJob の実行時に継続的に発行します。 単位: なし。「1」は、 がこの状態にある限り公開RecordJobされます。
	FatalError	RecordJob 致命的なエラーが発生した場合に発行します。 単位: なし。このイベントが発生すると、「1」が 1 回発行されます。 注記 詳細については、「 ログ」を参照してください。
	完了	RecordJob が完了すると発行されます。 単位: なし。このイベントが発生すると、「1」が 1 回発行されます。
ストリーム名、 UploadJob	実行中	UploadJob の実行時に継続的に発行します。 単位: なし。「1」は、 がこの状態にある限り公開UploadJobされます。
	FatalError	UploadJob 致命的なエラーが発生した場合に発行します。 単位: なし。このイベントが発生すると、「1」が 1 回発行されます。 注記 詳細については、「 ログ」を参照してください。
	完了	UploadJob が完了すると発行されます。 単位: なし。このイベントが発生すると、「1」が 1 回発行されます。
ストリーム名	PercentageSpaceUsed	これは、Amazon Kinesis Video Streams Edge Agent 設定で記録メディアに割り当てられた合計領域のうち、使用された割合です。詳細については、「LocalSizeConfig」を参照してください。 単位: パーセンテージ (スケール 0～1)。
モノの名前	アライブ	Amazon Kinesis Video Streams Edge Agent で実行されている設定に関係なく、1 分ごとに発行します。 これは、Amazon Kinesis Video Streams Edge Agent が稼働していて、設定を受け入れる準備ができているかどうかを理解するために使用できます。 単位: なし。「1」は毎分発行されます。
	RecordJobs.HealthyJobCount	Amazon Kinesis Video Streams Edge Agent で実行中およびスケジュールされたレコードジョブの合計数。 単位: 個
	UploadJobs.HealthyJobCount	Amazon Kinesis Video Streams Edge Agent で実行中およびスケジュールされたアップロードジョブの合計数。 単位: 個
	RecordJobs.UnhealthyJobCount	現在エラーが発生しているレコードジョブの合計数。 単位: 個
	UploadJobs.UnhealthyJobCount	現在エラーが発生しているアップロードジョブの合計数。 単位: 個
	RecordJobs.RunningJobCount	アクティブに実行されているレコードジョブの合計数。 単位: 個
	UploadJobs.RunningJobCount	アクティブに実行されているアップロードジョブの合計数。 単位: 個
	RecordJobs.EdgeConfigCount	Amazon Kinesis Video Streams Edge Agent で処理中のレコード設定の合計数。 単位: 個
	UploadJobs.EdgeConfigCount	Amazon Kinesis Video Streams Edge Agent で処理中のアップロード設定の合計数。 単位: 個

CloudWatch Amazon Kinesis Video Streams Edge Agent の メトリクスガイダンス

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

Amazon Kinesis Video Streams Edge Agent には記録するのに十分なスペースがありますか？

関連するメトリクス： PercentageSpaceUsed

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

Amazon Kinesis Video Streams Edge Agent は稼働していますか？

関連するメトリクス： Alive

アクション： いずれかの時点でこのメトリクスの受信を停止した場合、Amazon Kinesis Video Streams Edge Agent で次のいずれかまたは複数が発生したことを意味します。

• アプリケーションランタイムの問題: メモリやその他のリソースの制約、バグなど

• エージェントがシャットダウン、クラッシュ、または終了時に実行している AWS IoT デバイス

• AWS IoT デバイスにはネットワーク接続がありません

異常なジョブはありますか？

関連するメトリクス:

• RecordJobs.UnhealthyJobCount

• UploadJobs.UnhealthyJobCount

アクション： ログを検査し、 FatalErrorメトリクスを探します。

• FatalError メトリクスが存在する場合、致命的なエラーが発生したため、ジョブを手動で再起動する必要があります。を使用してジョブを手動で再起動する前にStartEdgeConfigurationUpdate、ログを検査し、問題を修正します。

• FatalError メトリクスが存在しない場合、一時的な (致命的ではない) エラーが発生し、Amazon Kinesis Video Streams Edge Agent はジョブを再試行しています。

注記

エージェントが致命的に誤ったジョブを再試行するには、 を使用しますStartEdgeConfigurationUpdate。

外部からの介入が必要なジョブはありますか？

関連するメトリクス:

• PercentageSpaceUsed – これが特定の値を超えると、レコードジョブは一時停止され、スペースが利用可能な場合にのみ再開されます (メディアの保持期間外）。更新した設定を より高い で送信MaxLocalMediaSizeInMBして、ジョブをすぐに更新できます。

• RecordJob.FatalError / UploadJob.FatalError – エージェントのログを調べ、ジョブを再開するための設定を再度送信します。

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