# Surveillance du streaming en temps réel Amazon IVS
Ce document fournit des détails sur les options disponibles pour surveiller votre application de diffusion IVS en temps réel.
## Qu’est-ce qu’une session d’étape ?
Une *session* d'étape commence lorsque le premier participant rejoint une étape et se termine quelques minutes après que le dernier participant cesse d'être diffusé sur l'étape. Les sessions d'étape facilitent le débogage des étapes de longue durée en séparant les événements et les participants en étapes de courte durée.
## Afficher les sessions d'étape et les participants
### Instructions de la console
1. Ouvrez la [console Amazon IVS](https://console.aws.amazon.com/ivs).
(Vous pouvez également accéder à la console Amazon IVS via la [console de gestion AWS](https://console.aws.amazon.com/).)
1. Dans le panneau de navigation, choisissez **Étapes**. (Si le volet de navigation est réduit, ouvrez-le d’abord en choisissant l’icône en forme de hamburger.)
1. Choisissez une étape pour accéder à sa page de détails.
1. Faites défiler la page vers le bas jusqu’à la section **Sessions d’étape**, puis sélectionnez une session d’étape pour afficher sa page de détails.
1. Pour afficher les participants à la session, faites défiler la page vers le bas jusqu’à la section **Participants**, puis sélectionnez un participant pour afficher sa page de détails, y compris des tableaux pour les métriques Amazon CloudWatch.
## Afficher les événements pour un participant
Les événements sont envoyés lorsque le statut d'un participant change dans une scène, par exemple lorsqu'il rejoint une scène ou qu'il rencontre une erreur lors de la tentative de publication sur une scène. Les erreurs ne provoquent pas toutes des événements. Par exemple, les erreurs réseau côté client et les erreurs de signature de jeton ne sont pas envoyées en tant qu'événements. Pour gérer ces erreurs dans votre application cliente, utilisez les [kits SDK de diffusion IVS](broadcast.md).
### Instructions de la console
1. Accédez à la page de détails du participant en suivant les instructions ci-dessus.
1. Faites défiler la page vers le bas jusqu'à la section **Événements**. Cette section affiche une liste ordonnée des événements des participants. Consultez la section [Utilisation d'Amazon EventBridge avec Amazon IVS](eventbridge.md) pour en savoir plus sur les événements émis pour les participants.
### Instructions de la CLI
L'accès aux événements des sessions de scène à partir de l'AWS CLI est une option avancée. Vous devez d'abord télécharger et configurer la CLI sur votre machine. Pour plus de détails, consultez le [Guide de l'utilisateur de l'Interface de ligne de commande AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
1. Répertoriez les sessions d’étape pour trouver une session d’étape :
```
aws ivs-realtime list-stage-sessions --stage-arn
```
1. Répertoriez les participants à une session d'étape pour trouver un participant :
```
aws ivs-realtime list-participants --stage-arn –session-id
```
1. Répertoriez les événements relatifs à une session d'étape et à un participant :
```
aws ivs-realtime list-participant-events --stage-arn --session-id –-participant-id
```
Voici un exemple de réponse à l’appel `list-participant-events` :
```
{
"events": [
{
"eventTime": "2023-04-04T22:48:41+00:00",
"name": "JOINED",
"participantId": "AdRezBl021t0"
},
{
"eventTime": "2023-04-04T22:48:41+00:00",
"name": "SUBSCRIBE_STARTED",
"participantId": "AdRezBl021t0",
"remoteParticipantId": "Ou5b5n5XLMdC"
},
{
"eventTime": "2023-04-04T22:49:45+00:00",
"name": "SUBSCRIBE_STOPPED",
"participantId": "AdRezBl021t0",
"remoteParticipantId": "Ou5b5n5XLMdC"
},
{
"eventTime": "2023-04-04T22:49:45+00:00",
"name": "LEFT",
"participantId": "AdRezBl021t0"
}
]
}
```
## Accès aux métriques CloudWatch
Pour que les métriques CloudWatch soient disponibles, les versions du SDK de diffusion IVS sont requises : Web 1.5.0 ou une version ultérieure, Android 1.12.0 ou une version ultérieure ou iOS 1.12.0 ou une version ultérieure.
### Instructions pour la console CloudWatch
1. Ouvrez la console CloudWatch à l’adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Dans le panneau latéral de navigation, développez le menu déroulant **Metrics** (Métriques), puis sélectionnez **All metrics** (Toutes les métriques).
1. Sous l'onglet **Parcourir**, à l'aide de la liste déroulante sans étiquette à gauche, sélectionnez votre région « d'accueil » dans laquelle votre ou vos canaux ont été créés. Pour en savoir plus sur les régions, consultez [Solution mondiale, contrôle régional](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/what-is.html#what-is-aws). Pour obtenir une liste des régions prises en charge, consultez la [page Amazon IVS](https://docs.aws.amazon.com/general/latest/gr/ivs.html) dans les *Références générales AWS*.
1. Au bas de l'onglet **Parcourir**, sélectionnez l'espace de noms **IVSRealTime**.
1. Effectuez l’une des actions suivantes :
1. Dans la barre de recherche, entrez votre ID de ressource (partie de l'ARN, `arn:::ivs:stage/`).
Sélectionnez ensuite **IVSRealTime > Métriques d’étape**.
1. Si **IVSRealTime** apparaît comme un service sélectionnable sous **Espaces de noms AWS**, sélectionnez-le. Il sera répertorié si vous utilisez le Streaming en temps réel Amazon IVS et qu'il envoie des métriques à Amazon CloudWatch. (Si **IVSRealTime** n'est pas répertorié, vous ne disposez pas de métriques Amazon IVS.)
Choisissez ensuite un groupe de *dimensions* comme vous le souhaitez ; les dimensions disponibles sont répertoriées dans les [Métriques CloudWatch](#stage-health-cloudwatch-metrics) ci-dessous.
1. Choisissez des métriques pour ajouter au graphique. Les métriques disponibles sont répertoriées dans les [Métriques CloudWatch](#stage-health-cloudwatch-metrics) ci-dessous.
Vous pouvez également accéder au graphique CloudWatch de votre session de flux de streaming à partir de la page de détails de ladite session, en sélectionnant le bouton **View in CloudWatch** (Afficher dans CloudWatch).
### Instructions de la CLI
Vous pouvez également accéder aux métriques à l'aide de l'AWS CLI. Pour cela, vous devez d'abord télécharger et configurer la CLI sur votre machine. Pour plus de détails, consultez le [Guide de l’utilisateur de l’Interface de ligne de commande AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
Ensuite, pour accéder aux métriques de streaming en temps réel Amazon IVS à l'aide de l'AWS CLI :
+ À partir d’une invite de commande, exécutez :
```
aws cloudwatch list-metrics --namespace AWS/IVSRealTime
```
Pour de plus amples informations, consultez [Utilisation des métriques Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) dans le *Guide de l’utilisateur Amazon CloudWatch*.
## Métriques CloudWatch : streaming en temps réel IVS
Amazon IVS fournit les métriques suivantes dans l'espace de noms **AWS/IVSRealTime**.
Pour que les métriques CloudWatch soient disponibles, vous devez utiliser le SDK de diffusion Web 1.5.2 ou une version ultérieure.
La dimension peut avoir les valeurs valides suivantes :
+ La dimension `Stage` est un ID de ressource (partie de l'ARN, `arn:::stage/`).
+ La dimension `Participant` est un `participantID`.
+ La valeur de `SimulcastLayer` est « hi », « mid », « low » ou « none » pour un `MediaType` de type « video », ou « none » pour un `MediaType` de type « audio ». Cette valeur peut également être vide.
+ La dimension `MediaType` est « vidéo » ou « audio » (chaîne).
Dans le cas de la réplication des participants, pour l’étape de destination, les métriques de l’état de l’étape existantes incluent tous les participants répliqués (diffuseurs de publication de l’étape source qui sont des participants en réplica à l’étape de destination).
| Métrique | Dimensions | Description |
| --- | --- | --- |
| `ConcurrentPublishers` | — | Nombre de participants publiant sur toutes les étapes dans une région AWS.
Unité : nombre
Statistiques valides : Moyenne, Maximum, Minimum |
| `ConcurrentSubscriptions` | — | Nombre de connexions simultanées entre diffuseurs de publication et abonnés sur toutes les étapes dans une région AWS.
Unité : nombre
Statistiques valides : Moyenne, Maximum, Minimum |
| `DownloadPacketLoss` | — | Pourcentage de paquets perdus par l’abonné au cours d’un téléchargement depuis le serveur IVS.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) de paquets perdus sur l’intervalle configuré |
| `DownloadPacketLoss` | `Platform` | Filtre `DownloadPacketLoss` par plateforme d’abonnés.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) de paquets perdus sur l’intervalle configuré |
| `DownloadPacketLoss` | `Platform, SDKVersion` | Filtre `DownloadPacketLoss` par plateforme d’abonnés et par version du kit SDK.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) de paquets perdus sur l’intervalle configuré |
| `DownloadPacketLoss` | `Stage` | Filtre `DownloadPacketLoss` par étape d’abonnés.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) de paquets perdus sur l’intervalle configuré |
| `DownloadPacketLoss` | `Stage, Participant` | Filtre `DownloadPacketLoss` par participant, pour les abonnés qui sont également des diffuseurs de publication. Les exemples représentent le pourcentage de paquets perdus par l’abonné au cours d’un téléchargement depuis le serveur IVS. Les exemples ne sont émis que lorsque le participant est également un diffuseur de publication.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) d’images abandonnées sur l’intervalle configuré |
| `DownloadPacketLoss` | `Stage, Platform` | Filtre `DownloadPacketLoss` par étape d’abonnés et par plateforme.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) de paquets perdus sur l’intervalle configuré |
| `DownloadPacketLoss` | `Stage, Platform, SDKVersion` | Filtre `DownloadPacketLoss` par étape d’abonnés, par plateforme et par version du kit SDK.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) de paquets perdus sur l’intervalle configuré |
| `DownloadPacketLoss` | `Stage, SubscriberCountryCode` | Filtre `DownloadPacketLoss` par étape d’abonnés et par code pays (ISO 3166).
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) de paquets perdus sur l’intervalle configuré |
| `DownloadPacketLoss` | `SubscriberCountryCode` | Filtre `DownloadPacketLoss` par code de pays d’abonnés (ISO 3166).
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) de paquets perdus sur l’intervalle configuré |
| `DroppedFrames` | `—` | Pour les abonnés : le pourcentage d’images vidéo perdues, calculé en agrégeant les images reçues et les images supprimées pour tous les éditeurs auxquels l’utilisateur est abonné.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) d’images abandonnées sur l’intervalle configuré |
| `DroppedFrames` | `Platform` | Filtre `DroppedFrames` par plateforme d’abonné.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) d’images abandonnées sur l’intervalle configuré |
| `DroppedFrames` | `Platform, SDKVersion` | Filtre `DroppedFrames` par plateforme d’abonné et par version du kit SDK.
Pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) d’images abandonnées sur l’intervalle configuré |
| `DroppedFrames` | `Stage` | Filtre `DroppedFrames` par étape.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) d’images abandonnées sur l’intervalle configuré |
| `DroppedFrames` | `Stage, Participant` | Filtre `DroppedFrames` par étape et par participant. Uniquement émis pour les abonnés qui sont également des diffuseurs de publication.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) d’images abandonnées sur l’intervalle configuré |
| `DroppedFrames` | `Stage, Platform` | Filtre `DroppedFrames` par étape et par plateforme d’abonné.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) d’images abandonnées sur l’intervalle configuré |
| `DroppedFrames` | `Stage, Platform, SDKVersion` | Filtre `DroppedFrames` par étape, par plateforme d’abonné et par version du kit SDK.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) d’images abandonnées sur l’intervalle configuré |
| `DroppedFrames` | `Stage, SubscriberCountryCode` | Filtre `DroppedFrames` par étape et par pays d’abonné.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) d’images abandonnées sur l’intervalle configuré |
| `DroppedFrames` | `SubscriberCountryCode` | Filtre `DroppedFrames` par pays d’abonné.
Unité : pourcentage
Statistiques valides : Moyenne, Maximum, Minimum – Débit moyen, maximum et minimum (respectivement) d’images abandonnées sur l’intervalle configuré |
| `PublishBitrate` | `—` | Le débit total auquel un diffuseur de publication envoie des données vidéo et audio (additionnées pour toutes les couches de diffusion simulcast). Cela inclut les données retransmises. Ce débit peut être gonflé par la perte de paquets de téléchargement et les retransmissions, car cela reflète ce que le diffuseur de publication envoie et peut ne pas correspondre à ce qu’IVS reçoit ou livre aux abonnés.
Bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `PublishBitrate` | `Platform` | Filtre `PublishBitrate` par plateforme de diffuseur de publication.
Bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `PublishBitrate` | `Stage` | Filtre `PublishBitrate` par étape.
Unité : bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `PublishBitrate` | `Stage, Participant, SimulcastLayer, MediaType` | Filtre `PublishBitrate` par étape, participant, couche simulcast et type de média. L'ID de couche simulcast est défini par le kit SDK de diffusion. Lorsque simulcast est désactivé, cet ID de couche sera défini sur « désactivé ». Le type de média est « vidéo » ou « audio ».
Unité : bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `Publishers` | `Stage` | Nombre de participants publiant sur l'étape.
Unité : nombre
Statistiques valides : Moyenne, Maximum, Minimum |
| `PublishFramerate` | `Stage, Participant` | Fréquence à laquelle les images vidéo sont reçues d’un diffuseur de publication donné. Cette métrique est disponible uniquement pour les participants publiant via RTMP.
Unité : nombre/seconde
Statistiques valides : Moyenne, Maximum, Minimum – nombre moyen, maximum ou minimum d’images par seconde (fréquence d’images) sur l’intervalle configuré |
| `PublishFramerate` | `Stage, Participant, SimulcastLayer, MediaType` | Fréquence à laquelle les images vidéo sont reçues d’un diffuseur de publication donné. Cette métrique est disponible uniquement pour les participants publiant via RTMP.
Unité : nombre/seconde
Statistiques valides : Moyenne, Maximum, Minimum – nombre moyen, maximum ou minimum d’images par seconde (fréquence d’images) sur l’intervalle configuré |
| `PublishResolution` | `Stage, Participant, SimulcastLayer, MediaType` | Nombre de pixels sur la plus petite des valeurs entre la largeur et la hauteur de l’image. Par exemple, pour une image paysage de 1920 x 1080, la résolution de publication est 1080. Pour une image portrait de 720 x 1280, la résolution de publication est 720.
Unité : nombre
Statistiques valides : Moyenne, Maximum, Minimum |
| `SubscribeBitrate` | `—` | Le débit total auquel un abonné reçoit des données vidéo et audio
Unité : bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `SubscribeBitrate` | `Platform` | Filtre `SubscribeBitrate` par plateforme d’abonné.
Unité : bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `SubscribeBitrate` | `Platform, SDKVersion` | Filtre `SubscribeBitrate` par plateforme d’abonné et par version du kit SDK.
Unité : bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `SubscribeBitrate` | `Stage` | Filtre `SubscribeBitrate` par étape.
Unité : bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `SubscribeBitrate` | `Stage, Participant, MediaType` | Filtre `SubscribeBitrate` par étape, participant et type de média. Le type de média est « vidéo » ou « audio ». Cette métrique n’est émise que lorsque le participant abonné publie également.
Unité : bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `SubscribeBitrate` | `Stage, Platform` | Filtre `SubscribeBitrate` par étape et par plateforme d’abonné.
Bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `SubscribeBitrate` | `Stage, Platform, SDKVersion` | Filtre `SubscribeBitrate` par étape, par plateforme d’abonné et par version du kit SDK.
Bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `SubscribeBitrate` | `Stage, SubscriberCountryCode` | Filtre `SubscribeBitrate` par étape et par code pays d’abonné.
Bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l’intervalle configuré |
| `SubscribeBitrate` | `SubscriberCountryCode` | Filtre `SubscribeBitrate` par code de pays d’abonné (ISO 3166-1 alpha-2).
Bits/seconde
Statistiques valides : Moyenne, Maximum, Minimum – Débit binaire moyen, maximum et minimum (respectivement) au cours de l'intervalle configuré |
| `Subscribers` | `Stage` | Nombre de participants abonnés à l'étape. Notez que les participants qui publient et s'abonnent activement sont considérés à la fois comme éditeurs et comme abonnés.
Unité : nombre
Statistiques valides : Moyenne, Maximum, Minimum |