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 pour en faire des indicateurs lisibles en temps quasi réel. Ces statistiques sont enregistrées pendant une période de 15 mois afin que vous puissiez accéder aux 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 CloudWatch consulter les statistiques d'un flux vidéo Amazon Kinesis de deux manières : + Dans la page **Dashboard (Tableau de bord)** choisissez l'onglet **Video streams (Flux vidéo)** dans la section **Account-level metrics for Current Region (Métriques au niveau du compte pour 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 | Nombre de points de quota de fragments multimédias consommés par tous les APIs. Pour une explication du concept de points de quota, voir[Quotas de métadonnées et de médias fragmentés](limits.md#fragment_based_throttling).Unités : nombre | | ArchivedFragmentsConsumed.Metadata | Le nombre de points de quota de métadonnées de fragments qui ont été consommés par tous les APIs. Pour une explication du concept de points de quota, voir[Quotas de métadonnées et 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 d'images 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 InletService pendant l'établissement de la connexion. Unités : nombre | | `PutMedia.BufferingAckLatency` | Décalage horaire entre le moment où le premier octet d'un nouveau fragment est reçu par Amazon Kinesis Video Streams et le moment où le Buffering ACK est envoyé pour le fragment. Unités : millisecondes | | `PutMedia.ReceivedAckLatency` | Décalage horaire 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` | Décalage horaire entre le moment où le dernier octet d'un nouveau fragment est reçu par Amazon Kinesis Video Streams et le moment où le Persisted ACK est envoyé pour le fragment. Unités : millisecondes | | `PutMedia.ErrorAckCount` | Le nombre d'erreurs ACKs envoyées lors de l'`PutMedia`exécution du flux. 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` | 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 flux. 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é. 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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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` | 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` | 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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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` | 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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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` | 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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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 AWS demandes IDs, consultez la section Enregistrement du résumé des [demandes/réponses](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` | 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 sur les 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 à partir du 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 lise-t-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 voir pourquoi l'ingestion des données échoue. Pour plus d'informations, consultez [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 à partir du 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 indicateurs, vérifiez la bande passante réseau de vos connexions. Les connexions à bande passante faible peuvent entraîner des ralentissements de débit dans la transmission des données vers le service. ### 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. + En cas de baisse`PutMedia.Success`, vérifiez les codes d'erreur du pack. Pour plus d'informations, consultez [AckErrorCode.Values.](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html) + S'il y a une 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 stream, en raison des fréquentes tentatives de reconnexion au stream. Regardez les response/error codes HTTP renvoyés pour la `GetMedia` requête. + En cas de 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 perte de connexion, et des reconnexions avec les clients, ce qui entraînerait un retard par rapport à la tête du stream. + 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 lise-t-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 indicateurs 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 plus d'informations, consultez [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 temps réel, vérifiez `PutMedia.IncomingBytes` si des données entrent dans le flux pour que le service les envoie aux clients. + S'il y a une baisse `GetMedia.Success``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.