Surveillance du streaming en temps réel Amazon IVS - Amazon IVS
Qu’est-ce qu’une session d’étape ?Afficher les sessions d'étape et les participantsAfficher les événements pour un participantAccès aux métriques CloudWatchMétriques CloudWatch : streaming en temps réel IVS

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.

    (Vous pouvez également accéder à la console Amazon IVS via la console de gestion AWS.)

  2. 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.)

  3. Choisissez une étape pour accéder à sa page de détails.

  4. 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.

  5. 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.

Instructions de la console

  1. Accédez à la page de détails du participant en suivant les instructions ci-dessus.

  2. 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 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.

  1. Répertoriez les sessions d’étape pour trouver une session d’étape :

    aws ivs-realtime list-stage-sessions --stage-arn <arn>

  2. Répertoriez les participants à une session d'étape pour trouver un participant :

    aws ivs-realtime list-participants --stage-arn <arn> –session-id <sessionId>

  3. Répertoriez les événements relatifs à une session d'étape et à un participant :

    aws ivs-realtime list-participant-events --stage-arn <arn> --session-id <sessionId> –-participant-id <participantId>

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/.

  2. 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).

  3. 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. Pour obtenir une liste des régions prises en charge, consultez la page Amazon IVS dans les Références générales AWS.

  4. Au bas de l'onglet Parcourir, sélectionnez l'espace de noms IVSRealTime.

  5. Effectuez l’une des actions suivantes :

    1. Dans la barre de recherche, entrez votre ID de ressource (partie de l'ARN, arn:::ivs:stage/<resource id>).

      Sélectionnez ensuite IVSRealTime > Métriques d’étape.

    2. 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 ci-dessous.

  6. Choisissez des métriques pour ajouter au graphique. Les métriques disponibles sont répertoriées dans les Métriques CloudWatch 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.

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 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/<resource id>).

  • 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