Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Surveillez les statistiques d'Amazon Kinesis Video Streams avec CloudWatch Vous pouvez surveiller un flux vidéo Kinesis à l'aide d'Amazon CloudWatch, qui collecte et traite les données brutes d'Amazon Kinesis Video Streams sous forme de mesures lisibles en temps quasi réel. Ces statistiques sont enregistrées pendant une période de 15 mois afin que vous puissiez accéder à des informations historiques et avoir une meilleure idée des performances de votre application ou service Web. Dans la console [ Amazon Kinesis Video Streams](https://console.aws.amazon.com/kinesisvideo/home/), vous pouvez consulter CloudWatch les statistiques relatives à un flux vidéo Amazon Kinesis de deux manières : + Sur la ** page ** Tableau de bord, choisissez l'**onglet Flux ** vidéo dans la ** Account-level ** section Statistiques de la région actuelle. + Choisissez l'onglet **Monitoring (Surveillance)** dans la page de détails du flux vidéo. Amazon Kinesis Video Streams fournit les statistiques suivantes : | Métrique | Description | | --- | --- | | ArchivedFragmentsConsumed.Media | Le nombre de points de quota de fragments de média consommés par toutes les API. Pour une explication du concept de points de quota, voir[Fragment-metadata et quotas de médias fragmentés](limits.md#fragment_based_throttling).Unités : nombre | | ArchivedFragmentsConsumed.Metadata | Nombre de points de quota de métadonnées de fragments consommés par toutes les API. Pour une explication du concept de points de quota, voir[Fragment-metadata et quotas de médias fragmentés](limits.md#fragment_based_throttling).Unités : nombre | | `PutMedia.Requests` | Le nombre de demandes d'`PutMedia`API pour un flux donné.
Unités : nombre | | `PutMedia.IncomingBytes` | Le nombre d'octets reçus dans le `PutMedia` cadre du flux.
Unités : octets | | `PutMedia.IncomingFragments` | Le nombre de fragments complets reçus dans le `PutMedia` cadre du flux.
Unités : nombre | | `PutMedia.IncomingFrames` | Le nombre de trames complètes reçues dans le `PutMedia` cadre du flux.
Unités : nombre | | `PutMedia.ActiveConnections` | Nombre total de connexions à l'hôte de service.
Unités : nombre | | `PutMedia.ConnectionErrors` | Les erreurs lors de l'établissement de la `PutMedia` connexion pour le flux.
Unités : nombre | | `PutMedia.FragmentIngestionLatency` | Décalage horaire entre le moment où le premier et le dernier octet d'un fragment sont reçus par Amazon Kinesis Video Streams.
Unités : millisecondes | | `PutMedia.FragmentPersistLatency` | Temps écoulé entre la réception et l'archivage de l'intégralité des données du fragment.
Unités : nombre | | `PutMedia.Latency` | La différence de temps entre la demande et la réponse HTTP au InletService moment de l'établissement de la connexion.
Unités : nombre | | `PutMedia.BufferingAckLatency` | Différence de temps entre le moment où le premier octet d'un nouveau fragment est reçu par Amazon Kinesis Video Streams et le moment où l'ACK de mise en mémoire tampon est envoyé pour le fragment.
Unités : millisecondes | | `PutMedia.ReceivedAckLatency` | Différence de temps entre le moment où le dernier octet d'un nouveau fragment est reçu par Amazon Kinesis Video Streams et le moment où l'ACK reçu est envoyé pour le fragment.
Unités : millisecondes | | `PutMedia.PersistedAckLatency` | Différence de temps entre le moment où le dernier octet d'un nouveau fragment est reçu par Amazon Kinesis Video Streams et le moment où l'ACK persistant est envoyé pour le fragment.
Unités : millisecondes | | `PutMedia.ErrorAckCount` | Le nombre d'Error ACK envoyés lors de `PutMedia` l'exécution du stream.
Unités : nombre | | `PutMedia.Success` | 1 pour chaque fragment écrit avec succès ; 0 pour chaque fragment ayant échoué. La valeur moyenne de cette métrique indique le nombre de fragments valides complets envoyé.
Unités : nombre | | `GetMedia.Requests` | Le nombre de demandes d'`GetMedia`API pour un flux donné.
Unités : nombre | | `GetMedia.OutgoingBytes` | Le nombre total d'octets envoyés par le service dans le cadre de l'`GetMedia`API pour un flux donné.
Unités : octets | | `GetMedia.OutgoingFragments` | Le nombre de fragments envoyés lors de l'`GetMedia`exécution du stream.
Unités : nombre | | `GetMedia.OutgoingFrames` | Le nombre de trames envoyées pendant `GetMedia` le flux donné.
Unités : nombre | | `GetMedia.MillisBehindNow` | La différence de temps entre l'horodatage actuel du serveur et l'horodatage du dernier fragment envoyé par le serveur.
Unités : millisecondes | | `GetMedia.ConnectionErrors` | Nombre de connexions qui n'ont pas été correctement établies.
Unités : nombre | | `GetMedia.Success` | 1 pour chaque fragment envoyé avec succès ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `GetMediaForFragmentList.OutgoingBytes` | Le nombre total d'octets envoyés par le service dans le cadre de l'`GetMediaForFragmentList`API pour un flux donné.
Unités : octets | | `GetMediaForFragmentList.OutgoingFragments` | Le nombre total de fragments envoyés par le service dans le cadre de l'`GetMediaForFragmentList`API pour un flux donné.
Unités : nombre | | `GetMediaForFragmentList.OutgoingFrames` | Le nombre total de trames envoyées par le service dans le cadre de l'`GetMediaForFragmentList`API pour un flux donné.
Unités : nombre | | `GetMediaForFragmentList.Requests` | Le nombre de demandes d'`GetMediaForFragmentList`API pour un flux donné.
Unités : nombre | | `GetMediaForFragmentList.Success` | 1 pour chaque fragment envoyé avec succès ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `ListFragments.Latency` | La latence de l'`ListFragments`API appelle le nom de flux donné.
Unités : millisecondes | | `ListFragments.Requests` | Le nombre de demandes d'`ListFragments`API pour un flux donné.
Unités : nombre | | `ListFragments.Success` | 1 pour chaque demande ayant abouti ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `GetHLSStreamingSessionURL.Latency` | La latence de l'`GetHLSStreamingSessionURL`API appelle le nom de flux donné.
Unités : millisecondes | | `GetHLSStreamingSessionURL.Requests` | Le nombre de demandes d'`GetHLSStreamingSessionURL`API pour un flux donné.
Unités : nombre | | `GetHLSStreamingSessionURL.Success` | 1 pour chaque demande ayant abouti ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `GetHLSMasterPlaylist.Latency` | La latence de l'`GetHLSMasterPlaylist`API appelle le nom de flux donné.
Unités : millisecondes | | `GetHLSMasterPlaylist.Requests` | Le nombre de demandes d'`GetHLSMasterPlaylist`API pour un flux donné.
Unités : nombre | | `GetHLSMasterPlaylist.Success` | 1 pour chaque demande ayant abouti ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `GetHLSMediaPlaylist.Latency` | La latence de l'`GetHLSMediaPlaylist`API appelle le nom de flux donné.
Unités : millisecondes | | `GetHLSMediaPlaylist.Requests` | Le nombre de demandes d'`GetHLSMediaPlaylist`API pour un flux donné.
Unités : nombre | | `GetHLSMediaPlaylist.Success` | 1 pour chaque demande ayant abouti ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `GetMP4InitFragment.Latency` | La latence de l'`GetMP4InitFragment`API appelle le nom de flux donné.
Unités : millisecondes | | `GetMP4InitFragment.Requests` | Le nombre de demandes d'`GetMP4InitFragment`API pour un flux donné.
Unités : nombre | | `GetMP4InitFragment.Success` | 1 pour chaque demande ayant abouti ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `GetMP4MediaFragment.Latency` | La latence de l'`GetMP4MediaFragment`API appelle le nom de flux donné.
Unités : millisecondes | | `GetMP4MediaFragment.Requests` | Le nombre de demandes d'`GetMP4MediaFragment`API pour un flux donné.
Unités : nombre | | `GetMP4MediaFragment.Success` | 1 pour chaque demande ayant abouti ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `GetMP4MediaFragment.OutgoingBytes` | Le nombre total d'octets envoyés par le service dans le cadre de l'`GetMP4MediaFragment`API pour un flux donné.
Unités : octets | | `GetTSFragment.Latency` | La latence de l'`GetTSFragment`API appelle le nom de flux donné.
Unités : millisecondes | | `GetTSFragment.Requests` | Le nombre de demandes d'`GetTSFragment`API pour un flux donné.
Unités : nombre | | `GetTSFragment.Success` | 1 pour chaque demande ayant abouti ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `GetTSFragment.OutgoingBytes` | Le nombre total d'octets envoyés par le service dans le cadre de l'`GetTSFragment`API pour un flux donné.
Unités : octets | | `GetDASHStreamingSessionURL.Latency` | La latence de l'`GetDASHStreamingSessionURL`API appelle le nom de flux donné.
Unités : millisecondes | | `GetDASHStreamingSessionURL.Requests` | Le nombre de demandes d'`GetDASHStreamingSessionURL`API pour un flux donné.
Unités : nombre | | `GetDASHStreamingSessionURL.Success` | 1 pour chaque demande ayant abouti ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `GetDASHManifest.Latency` | La latence de l'`GetDASHManifest`API appelle le nom de flux donné.
Unités : millisecondes | | `GetDASHManifest.Requests` | Le nombre de demandes d'`GetDASHManifest`API pour un flux donné.
Unités : nombre | | `GetDASHManifest.Success` | 1 pour chaque demande ayant abouti ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `GetClip.Latency` | La latence de l' GetClip API nécessite le nom du flux vidéo donné.
Unités : millisecondes | | `GetClip.Requests` | Le nombre de demandes d' GetClip API pour un flux vidéo donné.
Unités : nombre | | `GetClip.Success` | 1 pour chaque demande ayant abouti ; 0 pour chaque échec. La valeur moyenne indique le taux de réussite. Les échecs incluent à la fois 400 erreurs (utilisateur) et 500 erreurs (système). Pour plus d'informations sur l'activation d'un résumé des demandes et des réponses, y compris les identifiants de AWS demande, consultez la section Enregistrement [ Request/Response récapitulatif](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response).
Unités : nombre | | `GetClip.OutgoingBytes` | Le nombre total d'octets envoyés par le service dans le cadre de l' GetClip API pour un flux vidéo donné.
Unités : octets | ## CloudWatch conseils en matière de métriques CloudWatch les métriques peuvent aider à trouver des réponses aux questions suivantes : **Topics** + [Les données parviennent-elles au service Amazon Kinesis Video Streams ?](#monitoring-cloudwatch-guidance-incoming) + [Pourquoi les données ne sont-elles pas correctement ingérées par le service Amazon Kinesis Video Streams ?](#monitoring-cloudwatch-guidance-errors) + [Pourquoi les données ne peuvent-elles pas être lues depuis le service Amazon Kinesis Video Streams au même rythme que celles envoyées par le producteur ?](#monitoring-cloudwatch-guidance-rate) + [Pourquoi la console ne lit-elle aucune vidéo, ou pourquoi la vidéo est-elle lue avec un retard ?](#monitoring-cloudwatch-guidance-novideo) + [Quel est le retard dans la lecture des données en temps réel et pourquoi le client est-il en retard par rapport à la tête du flux ?](#monitoring-cloudwatch-guidance-delay) + [Le client lit-il les données du flux vidéo Kinesis, et à quel rythme ?](#monitoring-cloudwatch-guidance-isread) + [Pourquoi le client ne peut-il pas lire les données du flux vidéo Kinesis ?](#monitoring-cloudwatch-guidance-noread) ### Les données parviennent-elles au service Amazon Kinesis Video Streams ? **Métriques pertinentes :** + `PutMedia.IncomingBytes` + `PutMedia.IncomingFragments` + `PutMedia.IncomingFrames` **Éléments d'action :** + En cas de baisse de ces statistiques, vérifiez si votre application envoie toujours des données au service. + Vérifiez la bande passante réseau. Si votre bande passante réseau est insuffisante, cela peut ralentir la vitesse de réception des données par le service. ### Pourquoi les données ne sont-elles pas correctement ingérées par le service Amazon Kinesis Video Streams ? **Métriques pertinentes :** + `PutMedia.Requests` + `PutMedia.ConnectionErrors` + `PutMedia.Success` + `PutMedia.ErrorAckCount` **Éléments d'action :** + En cas d'augmentation`PutMedia.ConnectionErrors`, examinez la réponse HTTP et les codes d'erreur reçus par le client producteur pour voir quelles erreurs se produisent lors de l'établissement de la connexion. + En cas de baisse `PutMedia.Success` ou d'augmentation`PutMedia.ErrorAckCount`, examinez le code d'erreur ack dans les réponses ack envoyées par le service pour comprendre pourquoi l'ingestion de données échoue. Pour de plus amples informations, veuillez consulter [AckErrorCode.Values](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html). ### Pourquoi les données ne peuvent-elles pas être lues depuis le service Amazon Kinesis Video Streams au même rythme que celles envoyées par le producteur ? **Métriques pertinentes :** + `PutMedia.FragmentIngestionLatency` + `PutMedia.IncomingBytes` **Éléments d'action :** + En cas de baisse de ces statistiques, vérifiez la bande passante réseau de vos connexions. Low-bandwidth les connexions pourraient faire en sorte que les données atteignent le service à un débit inférieur. ### Pourquoi la console ne lit-elle aucune vidéo, ou pourquoi la vidéo est-elle lue avec un retard ? **Métriques pertinentes :** + `PutMedia.FragmentIngestionLatency` + `PutMedia.FragmentPersistLatency` + `PutMedia.Success` + `ListFragments.Latency` + `PutMedia.IncomingFragments` **Éléments d'action :** + En cas d'augmentation `PutMedia.FragmentIngestionLatency` ou de baisse`PutMedia.IncomingFragments`, vérifiez la bande passante du réseau et vérifiez si les données sont toujours envoyées. + S'il y a une erreur`PutMedia.Success`, vérifiez les codes d'erreur de retour. Pour de plus amples informations, veuillez consulter [AckErrorCode.Values](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html). + En cas d'augmentation de `PutMedia.FragmentPersistLatency` ou`ListFragments.Latency`, il est fort probable que vous rencontriez un problème de service. Si le problème persiste pendant une période prolongée, contactez votre service client pour savoir s'il y a un problème avec votre service. ### Quel est le retard dans la lecture des données en temps réel et pourquoi le client est-il en retard par rapport à la tête du flux ? **Métriques pertinentes :** + `GetMedia.MillisBehindNow` + `GetMedia.ConnectionErrors` + `GetMedia.Success` **Éléments d'action :** + En cas d'augmentation`GetMedia.ConnectionErrors`, le consommateur risque de prendre du retard dans la lecture du flux, en raison de fréquentes tentatives de reconnexion au flux. Regardez les response/error codes HTTP renvoyés pour la `GetMedia` demande. + S'il y a une baisse`GetMedia.Success`, cela est probablement dû au fait que le service n'est pas en mesure d'envoyer les données au consommateur, ce qui entraînerait une interruption de la connexion, puis une reconnexion des consommateurs, ce qui ferait en sorte que le consommateur serait à la traîne par rapport à la tête du flux. + En cas d'augmentation`GetMedia.MillisBehindNow`, examinez vos limites de bande passante pour voir si vous recevez les données à un rythme plus lent en raison d'une bande passante plus faible. ### Le client lit-il les données du flux vidéo Kinesis, et à quel rythme ? **Métriques pertinentes :** + `GetMedia.OutgoingBytes` + `GetMedia.OutgoingFragments` + `GetMedia.OutgoingFrames` + `GetMediaForFragmentList.OutgoingBytes` + `GetMediaForFragmentList.OutgoingFragments` + `GetMediaForFragmentList.OutgoingFrames` **Éléments d'action :** + Ces mesures indiquent la vitesse à laquelle les données archivées et en temps réel sont lues. ### Pourquoi le client ne peut-il pas lire les données du flux vidéo Kinesis ? **Métriques pertinentes :** + `GetMedia.ConnectionErrors` + `GetMedia.Success` + `GetMediaForFragmentList.Success` + `PutMedia.IncomingBytes` **Éléments d'action :** + En cas d'augmentation`GetMedia.ConnectionErrors`, examinez la réponse HTTP et les codes d'erreur renvoyés par la `GetMedia` requête. Pour de plus amples informations, veuillez consulter [AckErrorCode.Values](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html). + Si vous essayez de lire les données les plus récentes ou en direct, vérifiez `PutMedia.IncomingBytes` si des données entrent dans le flux pour que le service les envoie aux consommateurs. + S'il y a une baisse `GetMedia.Success` ou`GetMediaForFragmentList.Success`, cela est probablement dû au fait que le service n'est pas en mesure d'envoyer les données au consommateur. Si le problème persiste pendant une période prolongée, contactez votre service client pour savoir s'il y a un problème avec votre service.