Überwachung des Amazon Kinesis Video Streams Edge Agent mit CloudWatch

Sie können den Amazon Kinesis Video Streams Edge Agent mithilfe von Amazon überwachen CloudWatch, der Rohdaten sammelt und zu lesbaren, nahezu in Echtzeit verfügbaren Metriken verarbeitet. Diese Statistiken werden über einen Zeitraum von 15 Monaten aufgezeichnet. Mit diesen historischen Informationen können Sie sich einen besseren Überblick über die Leistung Ihrer Webanwendung oder des Amazon Kinesis Video Streams Edge Agent-Service verschaffen.

Gehen Sie wie folgt vor, um die Metriken einzusehen:

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.

2. Wählen Sie in der linken Navigationsleiste unter Metriken die Option Alle Metriken aus.

3. Wählen Sie die Registerkarte Durchsuchen und dann den EdgeRuntimeAgentbenutzerdefinierten Namespace aus.

Amazon Kinesis Video Streams Edge Agent veröffentlicht die folgenden Metriken unter dem Namespace: EdgeRuntimeAgent

Dimensionen	Status	Beschreibung
Name des Streams, RecordJob	In Ausführung	Veröffentlicht kontinuierlich, wenn der RecordJob läuft. Einheiten: Keine. „1" wird veröffentlicht, solange sie RecordJob sich in diesem Status befindet.
	FatalError	Publiziert, wenn ein RecordJob fataler Fehler auftritt. Einheiten: Keine. „1" wird einmal veröffentlicht, wenn dieses Ereignis eintritt. Anmerkung Weitere Informationen finden Sie in den Protokollen.
	Completed	Veröffentlicht, wenn a abgeschlossen RecordJob ist. Einheiten: Keine. „1" wird einmal veröffentlicht, wenn dieses Ereignis eintritt.
Streamname, UploadJob	In Ausführung	Veröffentlicht kontinuierlich, wenn der UploadJob läuft. Einheiten: Keine. „1" wird veröffentlicht, solange sie UploadJob sich in diesem Status befindet.
	FatalError	Wird veröffentlicht, wenn die UploadJob fatalen Fehler auftreten. Einheiten: Keine. „1" wird einmal veröffentlicht, wenn dieses Ereignis eintritt. Anmerkung Weitere Informationen finden Sie in den Protokollen.
	Completed	Veröffentlicht, wenn der abgeschlossen UploadJob ist. Einheiten: Keine. „1" wird einmal veröffentlicht, wenn dieses Ereignis eintritt.
Stream-Name	PercentageSpaceUsed	Dies ist der Prozentsatz, der vom gesamten Speicherplatz, der in Amazon Kinesis Video Streams Edge Agent-Konfigurationen für Aufnahmemedien zugewiesen wurde, genutzt wird. Weitere Informationen finden Sie unter LocalSizeConfig. Einheiten: Prozentsatz (Skala 0—1).
Thing-Name	Am Leben	Veröffentlicht jede Minute vom Amazon Kinesis Video Streams Edge Agent aus, unabhängig davon, welche Konfigurationen darauf ausgeführt werden. Dies kann verwendet werden, um zu ermitteln, ob der Amazon Kinesis Video Streams Edge Agent aktiv ist und bereit ist, Konfigurationen zu akzeptieren. Einheiten: Keine. „1" wird jede Minute veröffentlicht.
	RecordJobs.HealthyJobCount	Gesamtzahl der laufenden und geplanten Aufzeichnungsaufträge auf dem Amazon Kinesis Video Streams Edge Agent. Einheiten: Anzahl.
	UploadJobs.HealthyJobCount	Gesamtzahl der laufenden und geplanten Upload-Jobs auf dem Amazon Kinesis Video Streams Edge Agent. Einheiten: Anzahl.
	RecordJobs.UnhealthyJobCount	Gesamtzahl der aktuell fehlerhaften Aufzeichnungsaufträge. Einheiten: Anzahl.
	UploadJobs.UnhealthyJobCount	Gesamtzahl der aktuell fehlerhaften Upload-Jobs. Einheiten: Anzahl.
	RecordJobs.RunningJobCount	Gesamtzahl der aktiv ausgeführten Rekordjobs. Einheiten: Anzahl.
	UploadJobs.RunningJobCount	Gesamtzahl der aktiv ausgeführten Upload-Jobs. Einheiten: Anzahl.
	RecordJobs.EdgeConfigCount	Gesamtzahl der Datensatzkonfigurationen, die auf dem Amazon Kinesis Video Streams Edge Agent in Bearbeitung sind. Einheiten: Anzahl.
	UploadJobs.EdgeConfigCount	Gesamtzahl der Upload-Konfigurationen, die auf dem Amazon Kinesis Video Streams Edge Agent in Bearbeitung sind. Einheiten: Anzahl.

CloudWatch Leitfaden für Metriken für Amazon Kinesis Video Streams Edge Agent

CloudWatch Metriken können nützlich sein, um Antworten auf die folgenden Fragen zu finden:

Verfügt der Amazon Kinesis Video Streams Edge Agent über ausreichend Speicherplatz für Aufzeichnungen?

Relevante Metriken: PercentageSpaceUsed

Aktion: Keine Aktion erforderlich.

Ist der Amazon Kinesis Video Streams Edge Agent am Leben?

Relevante Metriken: Alive

Maßnahme: Wenn Sie diese Metrik zu irgendeinem Zeitpunkt nicht mehr erhalten, bedeutet dies, dass der Amazon Kinesis Video Streams Edge Agent auf eine oder mehrere der folgenden Ursachen gestoßen ist:

• Ein Problem mit der Anwendungslaufzeit: Speicher- oder andere Ressourcenbeschränkungen, Fehler usw.

• Das AWS IoT Gerät, auf dem der Agent ausgeführt wird, wenn es heruntergefahren, abgestürzt oder beendet wurde

• Das AWS IoT Gerät hat keine Netzwerkverbindung

Gibt es ungesunde Jobs?

Relevante Metriken:

• RecordJobs.UnhealthyJobCount

• UploadJobs.UnhealthyJobCount

Aktion: Untersuchen Sie die Protokolle und suchen Sie nach der FatalError Metrik.

• Wenn die FatalError Metrik vorhanden ist, ist ein schwerwiegender Fehler aufgetreten und Sie müssen den Job manuell neu starten. Überprüfen Sie die Protokolle und beheben Sie das ProblemStartEdgeConfigurationUpdate, bevor Sie den Job manuell neu starten.

• Wenn die FatalError Metrik nicht vorhanden ist, ist ein vorübergehender (nicht schwerwiegender) Fehler aufgetreten, und der Amazon Kinesis Video Streams Edge Agent versucht den Job erneut.

Anmerkung

Verwenden Sie, damit der Agent erneut versucht, einen Auftrag mit schwerwiegendem Fehler auszuführen. StartEdgeConfigurationUpdate

Benötigen irgendwelche Jobs externe Eingriffe?

Relevante Metriken:

• PercentageSpaceUsed— Wenn dieser Wert einen bestimmten Wert überschreitet, wird der Aufnahmevorgang angehalten und erst wieder aufgenommen, wenn Speicherplatz verfügbar ist (wenn das Medium nicht mehr aufbewahrt wird). Sie können eine aktualisierte Konfiguration mit einem höheren Wert senden, um den Job MaxLocalMediaSizeInMB sofort zu aktualisieren.

• RecordJob.FatalError/UploadJob.FatalError— Untersuchen Sie die Protokolle des Agenten und senden Sie die Konfiguration erneut, damit der Job wieder aufgenommen werden kann.

Aktion: Führen Sie einen API-Aufruf mit der Konfiguration durch, um Jobs neu zu starten, bei denen dieses Problem auftritt.