Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Überwachung von Amazon Kinesis Video Streams
Die Überwachung ist ein wichtiger Bestandteil der Aufrechterhaltung der Zuverlässigkeit, Verfügbarkeit und Leistung von Amazon Kinesis Video Streams und Ihrer AWS Lösungen. Wir empfehlen, Überwachungsdaten aus allen Teilen Ihrer AWS Lösung zu sammeln, um Sie beim Debuggen eines etwaigen Fehlers an mehreren Stellen zu unterstützen. Bevor Sie mit der Überwachung von Amazon Kinesis Video Streams beginnen, empfehlen wir Ihnen, einen Überwachungsplan zu erstellen, der Antworten auf die folgenden Fragen enthält:
+ Was sind Ihre Ziele bei der Überwachung?
+ Welche Ressourcen werden überwacht?
+ Wie oft werden diese Ressourcen überwacht?
+ Welche Überwachungstools werden verwendet?
+ Wer soll die Überwachungsaufgaben ausführen?
+ Wer soll benachrichtigt werden, wenn Fehler auftreten?
Nachdem Sie Ihre Überwachungsziele definiert und Ihren Überwachungsplan erstellt haben, besteht der nächste Schritt darin, eine Ausgangsbasis für die normale Leistung von Amazon Kinesis Video Streams in Ihrer Umgebung festzulegen. Sie sollten die Leistung von Amazon Kinesis Video Streams zu verschiedenen Zeiten und unter verschiedenen Lastbedingungen messen. Speichern Sie bei der Überwachung von Amazon Kinesis Video Streams einen Verlauf der von Ihnen gesammelten Überwachungsdaten. Sie können die aktuelle Leistung von Amazon Kinesis Video Streams mit diesen historischen Daten vergleichen, um normale Leistungsmuster und Leistungsanomalien zu identifizieren und Methoden zur Behebung eventuell auftretender Probleme zu entwickeln.
**Topics**
+ [Überwachen Sie Amazon Kinesis Video Streams Streams-Metriken mit CloudWatch](monitoring-cloudwatch.md)
+ [Überwachen Sie den Amazon Kinesis Video Streams Edge Agent mit CloudWatch](monitoring-edge-cloudwatch.md)
+ [API-Aufrufe von Amazon Kinesis Video Streams protokollieren mit AWS CloudTrail](monitoring-cloudtrail.md)
# Überwachen Sie Amazon Kinesis Video Streams Streams-Metriken mit CloudWatch
Sie können einen Kinesis-Videostream mit Amazon überwachen. Amazon CloudWatch sammelt Rohdaten aus Amazon Kinesis Video Streams und verarbeitet sie zu lesbaren Metriken, die nahezu in Echtzeit verfügbar sind. Diese Statistiken werden über einen Zeitraum von 15 Monaten aufgezeichnet, sodass Sie auf historische Informationen zugreifen und sich einen besseren Überblick über die Leistung Ihrer Webanwendung oder Ihres Dienstes verschaffen können.
In der [Amazon Kinesis Video Streams Streams-Konsole](https://console.aws.amazon.com//kinesisvideo/home/) können Sie CloudWatch Metriken für einen Amazon Kinesis Kinesis-Videostream auf zwei Arten anzeigen:
+ Wählen Sie auf der Seite **Dashboard** die Registerkarte **Video streams (Videostreams)** im Bereich **Account-level metrics for Current Region (Metriken auf Kontoebene für aktuelle Region)** aus.
+ Wählen Sie auf der Detailseite des Videostreams die Registerkarte **Monitoring (Überwachung)** aus.
Amazon Kinesis Video Streams bietet die folgenden Metriken:
| Metrik | Description |
| --- | --- |
| ArchivedFragmentsConsumed.Media | Die Anzahl der Quotenpunkte für Fragmentmedien, die APIs von allen genutzt wurden. Eine Erläuterung des Konzepts der Quotenpunkte finden Sie unter[Fragment-Metadaten und Kontingente für fragmentierte Medien](limits.md#fragment_based_throttling).Einheiten: Anzahl |
| ArchivedFragmentsConsumed.Metadata | Die Anzahl der Fragment-Metadatenquotenpunkte, die von allen genutzt wurden APIs. Eine Erläuterung des Konzepts der Quotenpunkte finden Sie unter[Fragment-Metadaten und Kontingente für fragmentierte Medien](limits.md#fragment_based_throttling).Einheiten: Anzahl |
| `PutMedia.Requests` | Die Anzahl der `PutMedia` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `PutMedia.IncomingBytes` | Die Anzahl der Bytes, die als Teil von `PutMedia` für den Stream empfangen wurden. Einheiten: Byte |
| `PutMedia.IncomingFragments` | Die Anzahl der vollständigen Fragmente, die als Teil von `PutMedia` für den Stream empfangen wurden. Einheiten: Anzahl |
| `PutMedia.IncomingFrames` | Die Anzahl der vollständigen Frames, die als Teil von `PutMedia` für den Stream empfangen wurden. Einheiten: Anzahl |
| `PutMedia.ActiveConnections` | Die Gesamtzahl der Verbindungen zum Service-Host. Einheiten: Anzahl |
| `PutMedia.ConnectionErrors` | Die Fehler beim `PutMedia` Verbindungsaufbau für den Stream. Einheiten: Anzahl |
| `PutMedia.FragmentIngestionLatency` | Der Zeitunterschied zwischen dem Zeitpunkt, an dem das erste und das letzte Byte eines Fragments von Amazon Kinesis Video Streams empfangen werden. Einheiten: Millisekunden |
| `PutMedia.FragmentPersistLatency` | Die Zeit, die vergeht, bis die vollständigen Fragmentdaten empfangen und archiviert wurden. Einheiten: Anzahl |
| `PutMedia.Latency` | Der Zeitunterschied zwischen der Anfrage und der HTTP-Antwort InletService beim Verbindungsaufbau. Einheiten: Anzahl |
| `PutMedia.BufferingAckLatency` | Der Zeitunterschied zwischen dem Empfang des ersten Byte eines neuen Fragments durch Amazon Kinesis Video Streams und dem Senden des Buffering ACK für das Fragment. Einheiten: Millisekunden |
| `PutMedia.ReceivedAckLatency` | Der Zeitunterschied zwischen dem Zeitpunkt, an dem das letzte Byte eines neuen Fragments von Amazon Kinesis Video Streams empfangen wird, und dem Zeitpunkt, an dem das empfangene ACK für das Fragment gesendet wird. Einheiten: Millisekunden |
| `PutMedia.PersistedAckLatency` | Der Zeitunterschied zwischen dem Zeitpunkt, an dem das letzte Byte eines neuen Fragments von Amazon Kinesis Video Streams empfangen wird, und dem Zeitpunkt, an dem das persistente ACK für das Fragment gesendet wird. Einheiten: Millisekunden |
| `PutMedia.ErrorAckCount` | Die Anzahl der Fehler, die während der Bearbeitung `PutMedia` für den Stream ACKs gesendet wurden. Einheiten: Anzahl |
| `PutMedia.Success` | 1 für jedes erfolgreich geschriebene Fragment; 0 für jede fehlerhafte Fragment. Der durchschnittliche Wert dieser Metrik zeigt an, wie viele vollständige, gültige Fragmente gesendet werden. Einheiten: Anzahl |
| `GetMedia.Requests` | Die Anzahl der `GetMedia` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `GetMedia.OutgoingBytes` | Die Gesamtzahl der Byte, die vom Dienst als Teil der `GetMedia` API für einen bestimmten Stream gesendet wurden. Einheiten: Byte |
| `GetMedia.OutgoingFragments` | Die Anzahl der Fragmente, die während der Bearbeitung `GetMedia` für den Stream gesendet wurden. Einheiten: Anzahl |
| `GetMedia.OutgoingFrames` | Die Anzahl der Frames, die während des `GetMedia` angegebenen Streams gesendet wurden. Einheiten: Anzahl |
| `GetMedia.MillisBehindNow` | Der Zeitunterschied zwischen dem aktuellen Serverzeitstempel und dem Serverzeitstempel des zuletzt gesendeten Fragments. Einheiten: Millisekunden |
| `GetMedia.ConnectionErrors` | Die Anzahl der Verbindungen, die nicht erfolgreich aufgebaut wurden. Einheiten: Anzahl |
| `GetMedia.Success` | 1 für jedes erfolgreich gesendete Fragment; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter Protokollierung der Zusammenfassung von AWS Anfragen IDs und Antworten[.](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response) Einheiten: Anzahl |
| `GetMediaForFragmentList.OutgoingBytes` | Die Gesamtzahl der Byte, die vom Dienst als Teil der `GetMediaForFragmentList` API für einen bestimmten Stream gesendet wurden. Einheiten: Byte |
| `GetMediaForFragmentList.OutgoingFragments` | Die Gesamtzahl der Fragmente, die vom Dienst als Teil der `GetMediaForFragmentList` API für einen bestimmten Stream gesendet wurden. Einheiten: Anzahl |
| `GetMediaForFragmentList.OutgoingFrames` | Die Gesamtzahl der Frames, die vom Service als Teil der `GetMediaForFragmentList` API für einen bestimmten Stream gesendet wurden. Einheiten: Anzahl |
| `GetMediaForFragmentList.Requests` | Die Anzahl der `GetMediaForFragmentList` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `GetMediaForFragmentList.Success` | 1 für jedes erfolgreich gesendete Fragment; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter AWS IDs Protokollierung der [Zusammenfassung von Anfragen und Antworten](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Einheiten: Anzahl |
| `ListFragments.Latency` | Die Latenz der `ListFragments` API-Aufrufe für den angegebenen Stream-Namen. Einheiten: Millisekunden |
| `ListFragments.Requests` | Die Anzahl der `ListFragments` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `ListFragments.Success` | 1 für jede erfolgreiche Anfrage; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter AWS IDs Protokollierung der [Zusammenfassung von Anfragen und Antworten](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Einheiten: Anzahl |
| `GetHLSStreamingSessionURL.Latency` | Die Latenz der `GetHLSStreamingSessionURL` API-Aufrufe für den angegebenen Stream-Namen. Einheiten: Millisekunden |
| `GetHLSStreamingSessionURL.Requests` | Die Anzahl der `GetHLSStreamingSessionURL` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `GetHLSStreamingSessionURL.Success` | 1 für jede erfolgreiche Anfrage; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter AWS IDs Protokollierung der [Zusammenfassung von Anfragen und Antworten](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Einheiten: Anzahl |
| `GetHLSMasterPlaylist.Latency` | Die Latenz der `GetHLSMasterPlaylist` API-Aufrufe für den angegebenen Stream-Namen. Einheiten: Millisekunden |
| `GetHLSMasterPlaylist.Requests` | Die Anzahl der `GetHLSMasterPlaylist` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `GetHLSMasterPlaylist.Success` | 1 für jede erfolgreiche Anfrage; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter AWS IDs Protokollierung der [Zusammenfassung von Anfragen und Antworten](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Einheiten: Anzahl |
| `GetHLSMediaPlaylist.Latency` | Die Latenz der `GetHLSMediaPlaylist` API-Aufrufe für den angegebenen Stream-Namen. Einheiten: Millisekunden |
| `GetHLSMediaPlaylist.Requests` | Die Anzahl der `GetHLSMediaPlaylist` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `GetHLSMediaPlaylist.Success` | 1 für jede erfolgreiche Anfrage; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter AWS IDs Protokollierung der [Zusammenfassung von Anfragen und Antworten](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Einheiten: Anzahl |
| `GetMP4InitFragment.Latency` | Die Latenz der `GetMP4InitFragment` API-Aufrufe für den angegebenen Stream-Namen. Einheiten: Millisekunden |
| `GetMP4InitFragment.Requests` | Die Anzahl der `GetMP4InitFragment` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `GetMP4InitFragment.Success` | 1 für jede erfolgreiche Anfrage; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter AWS IDs Protokollierung der [Zusammenfassung von Anfragen und Antworten](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Einheiten: Anzahl |
| `GetMP4MediaFragment.Latency` | Die Latenz der `GetMP4MediaFragment` API-Aufrufe für den angegebenen Stream-Namen. Einheiten: Millisekunden |
| `GetMP4MediaFragment.Requests` | Die Anzahl der `GetMP4MediaFragment` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `GetMP4MediaFragment.Success` | 1 für jede erfolgreiche Anfrage; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter AWS IDs Protokollierung der [Zusammenfassung von Anfragen und Antworten](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Einheiten: Anzahl |
| `GetMP4MediaFragment.OutgoingBytes` | Die Gesamtzahl der Byte, die vom Dienst als Teil der `GetMP4MediaFragment` API für einen bestimmten Stream gesendet wurden. Einheiten: Byte |
| `GetTSFragment.Latency` | Die Latenz der `GetTSFragment` API-Aufrufe für den angegebenen Stream-Namen. Einheiten: Millisekunden |
| `GetTSFragment.Requests` | Die Anzahl der `GetTSFragment` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `GetTSFragment.Success` | 1 für jede erfolgreiche Anfrage; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter AWS IDs Protokollierung der [Zusammenfassung von Anfragen und Antworten](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Einheiten: Anzahl |
| `GetTSFragment.OutgoingBytes` | Die Gesamtzahl der Byte, die vom Dienst als Teil der `GetTSFragment` API für einen bestimmten Stream gesendet wurden. Einheiten: Byte |
| `GetDASHStreamingSessionURL.Latency` | Die Latenz der `GetDASHStreamingSessionURL` API-Aufrufe für den angegebenen Stream-Namen. Einheiten: Millisekunden |
| `GetDASHStreamingSessionURL.Requests` | Die Anzahl der `GetDASHStreamingSessionURL` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `GetDASHStreamingSessionURL.Success` | 1 für jede erfolgreiche Anfrage; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter AWS IDs Protokollierung der [Zusammenfassung von Anfragen und Antworten](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Einheiten: Anzahl |
| `GetDASHManifest.Latency` | Die Latenz der `GetDASHManifest` API-Aufrufe für den angegebenen Stream-Namen. Einheiten: Millisekunden |
| `GetDASHManifest.Requests` | Die Anzahl der `GetDASHManifest` API-Anfragen für einen bestimmten Stream. Einheiten: Anzahl |
| `GetDASHManifest.Success` | 1 für jede erfolgreiche Anfrage; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter AWS IDs Protokollierung der [Zusammenfassung von Anfragen und Antworten](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Einheiten: Anzahl |
| `GetClip.Latency` | Die Latenz der GetClip API-Aufrufe für den angegebenen Videostreamnamen. Einheiten: Millisekunden |
| `GetClip.Requests` | Die Anzahl der GetClip API-Anfragen für einen bestimmten Videostream. Einheiten: Anzahl |
| `GetClip.Success` | 1 für jede erfolgreiche Anfrage; 0 für jeden Fehler. Der durchschnittliche Wert zeigt die Erfolgsrate an. Ausfälle umfassen 400- (Benutzer) und 500-Fehler (System). Weitere Informationen zum Aktivieren einer Zusammenfassung von Anfragen und Antworten, einschließlich Anfragen, finden Sie unter AWS IDs Protokollierung der [Zusammenfassung von Anfragen und Antworten](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Einheiten: Anzahl |
| `GetClip.OutgoingBytes` | Die Gesamtzahl der Byte, die vom Dienst als Teil der GetClip API für einen bestimmten Videostream gesendet wurden. Einheiten: Byte |
## CloudWatch Anleitung zu Metriken
CloudWatch Kennzahlen können helfen, Antworten auf die folgenden Fragen zu finden:
**Topics**
+ [Erreichen Daten den Amazon Kinesis Video Streams Streams-Service?](#monitoring-cloudwatch-guidance-incoming)
+ [Warum werden Daten vom Amazon Kinesis Video Streams Streams-Service nicht erfolgreich aufgenommen?](#monitoring-cloudwatch-guidance-errors)
+ [Warum können die Daten vom Amazon Kinesis Video Streams Streams-Service nicht mit der gleichen Geschwindigkeit gelesen werden, mit der sie vom Produzenten gesendet werden?](#monitoring-cloudwatch-guidance-rate)
+ [Warum befindet sich kein Video in der Konsole, oder warum wird das Video verzögert abgespielt?](#monitoring-cloudwatch-guidance-novideo)
+ [Worum handelt es sich bei der Verzögerung beim Lesen von Echtzeitdaten und warum bleibt der Client zeitlich hinter dem Datenstromkopf zurück?](#monitoring-cloudwatch-guidance-delay)
+ [Liest der Client Daten aus dem Kinesis-Videostream und mit welcher Geschwindigkeit?](#monitoring-cloudwatch-guidance-isread)
+ [Warum kann der Client keine Daten aus dem Kinesis-Videostream lesen?](#monitoring-cloudwatch-guidance-noread)
### Erreichen Daten den Amazon Kinesis Video Streams Streams-Service?
**Relevante Metriken:**
+ `PutMedia.IncomingBytes`
+ `PutMedia.IncomingFragments`
+ `PutMedia.IncomingFrames`
**Aktionselemente:**
+ Wenn diese Messwerte sinken, überprüfen Sie, ob Ihre Anwendung immer noch Daten an den Service sendet.
+ Prüfen Sie die Netzwerkbandbreite. Wenn Ihre Netzwerkbandbreite nicht ausreicht, könnte dies die Geschwindigkeit, mit der der Service die Daten empfängt, verlangsamen.
### Warum werden Daten vom Amazon Kinesis Video Streams Streams-Service nicht erfolgreich aufgenommen?
**Relevante Metriken:**
+ `PutMedia.Requests`
+ `PutMedia.ConnectionErrors`
+ `PutMedia.Success`
+ `PutMedia.ErrorAckCount`
**Aktionselemente:**
+ Wenn es eine Zunahme von gibt`PutMedia.ConnectionErrors`, schauen Sie sich die HTTP-Antwort und die Fehlercodes an, die der Producer-Client erhalten hat, um zu sehen, welche Fehler beim Verbindungsaufbau aufgetreten sind.
+ Wenn es zu einem Rückgang `PutMedia.Success` oder Anstieg kommt`PutMedia.ErrorAckCount`, sehen Sie sich den Ack-Fehlercode in den vom Dienst gesendeten Ack-Antworten an, um herauszufinden, warum die Datenaufnahme fehlschlägt. [Weitere Informationen finden Sie unter .Values. AckErrorCode](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html)
### Warum können die Daten vom Amazon Kinesis Video Streams Streams-Service nicht mit der gleichen Geschwindigkeit gelesen werden, mit der sie vom Produzenten gesendet werden?
**Relevante Metriken:**
+ `PutMedia.FragmentIngestionLatency`
+ `PutMedia.IncomingBytes`
**Aktionselemente:**
+ Wenn diese Messwerte sinken, überprüfen Sie die Netzwerkbandbreite Ihrer Verbindungen. Verbindungen mit geringer Bandbreite können dazu führen, dass die Daten mit geringerer Geschwindigkeit zum Service gelangen.
### Warum befindet sich kein Video in der Konsole, oder warum wird das Video verzögert abgespielt?
**Relevante Metriken:**
+ `PutMedia.FragmentIngestionLatency`
+ `PutMedia.FragmentPersistLatency`
+ `PutMedia.Success`
+ `ListFragments.Latency`
+ `PutMedia.IncomingFragments`
**Aktionselemente:**
+ Wenn die Netzwerkbandbreite zunimmt `PutMedia.FragmentIngestionLatency` oder sinkt`PutMedia.IncomingFragments`, überprüfen Sie die Netzwerkbandbreite und ob die Daten weiterhin gesendet werden.
+ Wenn es zu einem Rückgang kommt`PutMedia.Success`, überprüfen Sie die ACK-Fehlercodes. Weitere Informationen finden Sie unter [AckErrorCode.Values.](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html)
+ Wenn der Wert von `PutMedia.FragmentPersistLatency` oder zunimmt`ListFragments.Latency`, liegt höchstwahrscheinlich ein Serviceproblem vor. Wenn der Zustand über einen längeren Zeitraum andauert, erkundigen Sie sich bei Ihrem Kundendienstkontakt, ob ein Problem mit Ihrem Service vorliegt.
### Worum handelt es sich bei der Verzögerung beim Lesen von Echtzeitdaten und warum bleibt der Client zeitlich hinter dem Datenstromkopf zurück?
**Relevante Metriken:**
+ `GetMedia.MillisBehindNow`
+ `GetMedia.ConnectionErrors`
+ `GetMedia.Success`
**Aktionselemente:**
+ Wenn der Wert zunimmt, kann es sein`GetMedia.ConnectionErrors`, dass der Verbraucher beim Lesen des Streams ins Hintertreffen gerät, weil er häufig versucht, erneut eine Verbindung zum Stream herzustellen. Sehen Sie sich die response/error HTTP-Codes an, die für die `GetMedia` Anfrage zurückgegeben wurden.
+ Wenn es zu einem Ausfall kommt`GetMedia.Success`, liegt das wahrscheinlich daran, dass der Dienst die Daten nicht an den Verbraucher senden kann, was zu einem Verbindungsabbruch und zu erneuten Verbindungen von Verbrauchern führen würde, was dazu führen würde, dass der Verbraucher hinter der Spitze des Streams zurückbleibt.
+ Wenn es zu einem Anstieg kommt`GetMedia.MillisBehindNow`, schauen Sie sich Ihre Bandbreitenbeschränkungen an, um festzustellen, ob Sie die Daten aufgrund der geringeren Bandbreite langsamer empfangen.
### Liest der Client Daten aus dem Kinesis-Videostream und mit welcher Geschwindigkeit?
**Relevante Metriken:**
+ `GetMedia.OutgoingBytes`
+ `GetMedia.OutgoingFragments`
+ `GetMedia.OutgoingFrames`
+ `GetMediaForFragmentList.OutgoingBytes`
+ `GetMediaForFragmentList.OutgoingFragments`
+ `GetMediaForFragmentList.OutgoingFrames`
**Aktionselemente:**
+ Diese Kennzahlen geben die Geschwindigkeit an, mit der Echtzeit- und archivierte Daten gelesen werden.
### Warum kann der Client keine Daten aus dem Kinesis-Videostream lesen?
**Relevante Metriken:**
+ `GetMedia.ConnectionErrors`
+ `GetMedia.Success`
+ `GetMediaForFragmentList.Success`
+ `PutMedia.IncomingBytes`
**Aktionselemente:**
+ Wenn es eine Zunahme von gibt`GetMedia.ConnectionErrors`, sehen Sie sich die HTTP-Antwort und die Fehlercodes an, die von der `GetMedia` Anfrage zurückgegeben wurden. Weitere Informationen finden Sie unter [AckErrorCode.Values.](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html)
+ Wenn Sie versuchen, die neuesten Daten oder Live-Daten `PutMedia.IncomingBytes` zu lesen, überprüfen Sie, ob Daten in den Stream gelangen, die der Dienst an die Verbraucher senden kann.
+ Wenn es zu einem Rückgang bei `GetMedia.Success` oder kommt`GetMediaForFragmentList.Success`, liegt das wahrscheinlich daran, dass der Dienst die Daten nicht an den Verbraucher senden kann. Wenn der Zustand über einen längeren Zeitraum andauert, erkundigen Sie sich bei Ihrem Kundendienstkontakt, ob ein Problem mit Ihrem Service vorliegt.
# Überwachen Sie den 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-Managementkonsole und öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie in der linken Navigationsleiste unter **Metriken** die Option **Alle Metriken** aus.
1. Wählen Sie die Registerkarte **Durchsuchen** und dann den **EdgeRuntimeAgent**benutzerdefinierten Namespace aus.
Amazon Kinesis Video Streams Edge Agent veröffentlicht die folgenden Metriken unter dem Namespace: `EdgeRuntimeAgent`
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/kinesisvideostreams/latest/dg/monitoring-edge-cloudwatch.html)
## CloudWatch Leitfaden für Kennzahlen für Amazon Kinesis Video Streams Edge Agent
CloudWatch Metriken können nützlich sein, um Antworten auf die folgenden Fragen zu finden:
**Topics**
+ [Hat der Amazon Kinesis Video Streams Edge Agent genügend Speicherplatz für Aufzeichnungen?](#monitoring-edge-space)
+ [Ist der Amazon Kinesis Video Streams Edge Agent am Leben?](#monitoring-edge-alive)
+ [Gibt es ungesunde Jobs?](#monitoring-edge-unhealthy)
+ [Benötigen irgendwelche Jobs externe Eingriffe?](#monitoring-edge-intervention)
### Hat der Amazon Kinesis Video Streams Edge Agent genügend 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. Prüfen Sie die Protokolle und beheben Sie das Problem`StartEdgeConfigurationUpdate`, 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](API_StartEdgeConfigurationUpdate.md)
### 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.
# API-Aufrufe von Amazon Kinesis Video Streams protokollieren mit AWS CloudTrail
Amazon Kinesis Video Streams arbeitet mit einem Service AWS CloudTrail, der eine Aufzeichnung der Aktionen eines Benutzers, einer Rolle oder eines AWS-Service in Amazon Kinesis Video Streams bereitstellt. CloudTrail erfasst alle API-Aufrufe für Amazon Kinesis Video Streams als Ereignisse. Zu den erfassten Aufrufen gehören Aufrufe von der Amazon Kinesis Video Streams Streams-Konsole und Code-Aufrufe an die Amazon Kinesis Video Streams Streams-API-Operationen. Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Bereitstellung von CloudTrail Ereignissen an einen Amazon S3 S3-Bucket aktivieren, einschließlich Ereignissen für Amazon Kinesis Video Streams. Wenn Sie keinen Trail konfigurieren, können Sie die neuesten Ereignisse trotzdem in der CloudTrail Konsole im **Ereignisverlauf** anzeigen. Anhand der von gesammelten Informationen können Sie die Anfrage CloudTrail, die an Amazon Kinesis Video Streams gestellt wurde, die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde, und weitere Details ermitteln.
Weitere Informationen darüber CloudTrail, einschließlich der Konfiguration und Aktivierung, finden Sie im *[AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)*.
## Amazon Kinesis Video Streams und CloudTrail
CloudTrail ist für Ihr AWS Konto aktiviert, wenn Sie das Konto erstellen. Wenn unterstützte Ereignisaktivitäten in Amazon Kinesis Video Streams auftreten, wird diese Aktivität zusammen mit anderen AWS Serviceereignissen im CloudTrail **Ereignisverlauf in einem Ereignis** aufgezeichnet. Sie können aktuelle Ereignisse in Ihrem AWS Konto ansehen, suchen und herunterladen. Weitere Informationen finden Sie unter [Ereignisse mit CloudTrail Ereignisverlauf anzeigen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Für eine fortlaufende Aufzeichnung von Ereignissen in Ihrem AWS Konto, einschließlich Ereignissen für Amazon Kinesis Video Streams, erstellen Sie einen Trail. Ein *Trail* ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie einen Trail in der Konsole anlegen, gilt dieser für alle AWS-Regionen-Regionen. Der Trail protokolliert Ereignisse aus allen Regionen der AWS Partition und übermittelt die Protokolldateien an den von Ihnen angegebenen Amazon S3 S3-Bucket. Darüber hinaus können Sie andere konfigurieren, AWS-Services um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie hier:
+ [Übersicht zum Erstellen eines Trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Unterstützte Dienste und Integrationen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Konfiguration von Amazon SNS SNS-Benachrichtigungen für CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Empfangen von CloudTrail Protokolldateien aus mehreren Regionen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) und [Empfangen von CloudTrail Protokolldateien von mehreren Konten](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Amazon Kinesis Video Streams unterstützt die Protokollierung der folgenden Aktionen als Ereignisse in CloudTrail Protokolldateien:
+ [CreateStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_CreateStream.html)
+ [DeleteStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DeleteStream.html)
+ [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html)
+ [GetDataEndpoint](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_GetDataEndpoint.html)
+ [ListStreams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html)
+ [ListTagsForStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListTagsForStream.html)
+ [TagStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_TagStream.html)
+ [UntagStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_UntagStream.html)
+ [UpdateDataRetention](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_UpdateDataRetention.html)
+ [UpdateStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_UpdateStream.html)
Jeder Ereignis- oder Protokolleintrag enthält Informationen zu dem Benutzer, der die Anforderung generiert hat. Die Identitätsinformationen unterstützen Sie bei der Ermittlung der folgenden Punkte:
+ Ob die Anfrage mit Root- oder -Benutzeranmeldeinformationen ausgeführt wurde.
+ Ob die Anfrage mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen föderierten Benutzer ausgeführt wurde
+ Ob die Anforderung aus einem anderen AWS-Service gesendet wurde.
Weitere Informationen finden Sie unter [CloudTrail userIdentity-Element](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Beispiel: Einträge in der Amazon Kinesis Video Streams Streams-Protokolldatei
Ein Trail ist eine Konfiguration, die die Übertragung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen Amazon S3 S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis ist eine einzelne Anforderung aus einer beliebigen Quelle und enthält Informationen zur angeforderten Aktion, zu Datum und Uhrzeit der Aktion, zu den Anforderungsparametern usw. CloudTrail -Protokolldateien stellen kein geordnetes Stack-Trace der öffentlichen API-Aufrufe dar. Daher werden sie nicht in einer bestimmten Reihenfolge angezeigt.
Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die [CreateStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_CreateStream.html)Aktion demonstriert.
```
{
"Records": [
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2018-05-25T00:16:31Z",
"eventSource": " kinesisvideo.amazonaws.com",
"eventName": "CreateStream",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamName": "VideoStream",
"dataRetentionInHours": 2,
"mediaType": "mediaType",
"kmsKeyId": "arn:aws:kms::us-east-1:123456789012:alias",
"deviceName": "my-device"
},
"responseElements": {
"streamARN":arn:aws:kinesisvideo:us-east-1:123456789012:stream/VideoStream/12345"
},
"requestID": "db6c59f8-c757-11e3-bc3b-57923b443c1c",
"eventID": "b7acfcd0-6ca9-4ee1-a3d7-c4e8d420d99b"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2018-05-25:17:06Z",
"eventSource": " kinesisvideo.amazonaws.com",
"eventName": "DeleteStream",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamARN": "arn:aws:kinesisvideo:us-east-1:012345678910:stream/VideoStream/12345",
"currentVersion": "keqrjeqkj9"
},
"responseElements": null,
"requestID": "f0944d86-c757-11e3-b4ae-25654b1d3136",
"eventID": "0b2f1396-88af-4561-b16f-398f8eaea596"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2014-04-19T00:15:02Z",
"eventSource": " kinesisvideo.amazonaws.com",
"eventName": "DescribeStream",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamName": "VideoStream"
},
"responseElements": null,
"requestID": "a68541ca-c757-11e3-901b-cbcfe5b3677a",
"eventID": "22a5fb8f-4e61-4bee-a8ad-3b72046b4c4d"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2014-04-19T00:15:03Z",
"eventSource": "kinesisvideo.amazonaws.com",
"eventName": "GetDataEndpoint",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamName": "VideoStream",
"aPIName": "LIST_FRAGMENTS"
"
},
"responseElements": null,
"requestID": "a6e6e9cd-c757-11e3-901b-cbcfe5b3677a",
"eventID": "dcd2126f-c8d2-4186-b32a-192dd48d7e33"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2018-05-25T00:16:56Z",
"eventSource": "kinesisvideo.amazonaws.com",
"eventName": "ListStreams",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"maxResults": 100,
"streamNameCondition": {"comparisonValue":"MyVideoStream" comparisonOperator":"BEGINS_WITH"}}
},
"responseElements": null,
"requestID": "e9f9c8eb-c757-11e3-bf1d-6948db3cd570",
"eventID": "77cf0d06-ce90-42da-9576-71986fec411f"
}
]
}
```