Monitoraggio dello streaming in tempo reale di Amazon IVS - Amazon IVS
Che cos'è una sessione di fase?Visualizzazione delle sessioni e dei partecipanti alla faseVisualizzazione degli eventi per un partecipanteAccesso ai parametri di CloudWatchParametri di CloudWatch: streaming in tempo reale IVS.

Monitoraggio dello streaming in tempo reale di Amazon IVS

Questo documento fornisce dettagli sulle opzioni disponibili per il monitoraggio dell'applicazione di streaming IVS in tempo reale.

Che cos'è una sessione di fase?

Una sessione di fase inizia quando il primo partecipante si unisce a una fase e termina pochi minuti dopo che l'ultimo ha smesso di pubblicare nella fase. Le sessioni di fase aiutano a eseguire il debug delle fasi di lunga durata separando eventi e partecipanti in sessioni di breve durata.

Visualizzazione delle sessioni e dei partecipanti alla fase

Istruzioni per la console

  1. Aprire la Console Amazon IVS.

    L'accesso alla console Amazon IVS è possibile anche dalla Console di gestione AWS.

  2. Nel riquadro di navigazione, scegli Fasi. Se il riquadro di navigazione è compresso, aprirlo prima scegliendo l'icona a hamburger.

  3. Scegli la fase per accedere alla rispettiva pagina dei dettagli.

  4. Scorri la pagina verso il basso fino a visualizzare la sezione Sessioni di fase, quindi seleziona una sessione di fase per visualizzare la rispettiva pagina dei dettagli.

  5. Per visualizzare i partecipanti alla sessione, scorri verso il basso fino a visualizzare la sezione Partecipanti, quindi seleziona un partecipante per visualizzare la relativa pagina dei dettagli, inclusi i grafici per i parametri Amazon CloudWatch.

Visualizzazione degli eventi per un partecipante

Gli eventi vengono inviati quando lo stato di un partecipante in una fase cambia, ad esempio se si unisce a una fase o si verifica un errore durante il tentativo di pubblicazione in una fase. Non tutti gli errori causano eventi; ad esempio, gli errori di rete lato client e gli errori di firma dei token non vengono inviati come eventi. Per gestire questi errori nella tua applicazione client, usa gli SDK di trasmissione IVS.

Istruzioni per la console

  1. Accedi alla pagina dei dettagli del partecipante come indicato sopra.

  2. Scorri verso il basso fino a visualizzare la sezione Eventi. Viene visualizzato un elenco ordinato degli eventi dei partecipanti. Consulta la sezione Utilizzo di Amazon EventBridge con Amazon IVS per dettagli sugli eventi che vengono emessi per i partecipanti.

Istruzioni per la CLI

L'accesso agli eventi delle sessioni di fase con AWS CLI è un'opzione avanzata e richiede prima il download e la configurazione della CLI sul computer in uso. Per maggiori dettagli, consulta la Guida per l'utente dell'interfaccia a riga di comando di AWS.

  1. Elenca le sessioni di fase per trovare una sessione di fase:

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

  2. Elenca i partecipanti a una sessione di fase per trovare un partecipante:

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

  3. Elenca gli eventi per una sessione di fase e per il partecipante:

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

Di seguito è riportata una risposta di esempio alla chiamata 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"
        }
    ]
}

Accesso ai parametri di CloudWatch

Affinché i parametri di CloudWatch siano disponibili, sono necessarie le seguenti versioni SDK di trasmissione IVS: Web 1.5.0 o successive, Android 1.12.0 o successive o iOS 1.12.0 o successive.

Istruzioni per la console CloudWatch

  1. Apri la console CloudWatch all'indirizzo https://console.aws.amazon.com/cloudwatch/.

  2. Nella navigazione laterale, espandere il menu a discesa Metrics (Parametri), quindi selezionare All metrics (Tutti i parametri).

  3. Nella scheda Sfoglia, utilizzando il menu a discesa senza etichetta sulla sinistra, seleziona la propria regione "di origine", ovvero dove sono stati creati i canali. Per ulteriori informazioni sulle Regioni, consultare Soluzione globale, controllo regionale. Per un elenco delle Regioni supportate, consultare la pagina di Amazon IVS nei Riferimenti generali di AWS.

  4. Nella parte inferiore della scheda Sfoglia, seleziona il namespace IVSRealTime.

  5. Esegui una di queste operazioni:

    1. Nella barra di ricerca digitare l'ID della risorsa (parte dell'ARN, arn:::ivs:stage/<resource id>).

      Quindi seleziona IVSRealTime > Parametri fase.

    2. Se IVSRealTime viene visualizzato come servizio selezionabile in Spazi dei nomi AWS, selezionalo. Verrà elencato se utilizzi lo streaming in tempo reale di Amazon IVS e se invia i parametri ad Amazon CloudWatch. (Se IVSRealTime non è presente nell'elenco, allora significa che non si dispone di parametri Amazon IVS).

      Selezione ora il raggruppamento di dimensioni desiderato. Le dimensioni disponibili sono elencate nei Parametri di CloudWatch qui sotto.

  6. Seleziona i parametri da aggiungere al grafico. I parametri disponibili sono elencati nei Parametri di CloudWatch qui sotto.

È inoltre possibile accedere al grafico CloudWatch della sessione di streaming dalla pagina dei dettagli della sessione di streaming, selezionando il pulsante View in CloudWatch (Visualizza in CloudWatch).

Istruzioni per la CLI

È possibile accedere ai parametri anche utilizzando l'interfaccia a riga di comando (CLI) di AWS. Ciò richiede il download e la configurazione della CLI sul computer. Per maggiori dettagli, consultare la Guida per l'utente dell'interfaccia a riga di comando di AWS.

Quindi, per accedere ai parametri dello streaming in tempo reale di Amazon IVS utilizzando la CLI di AWS:

  • Al prompt dei comandi, esegui:

    aws cloudwatch list-metrics --namespace AWS/IVSRealTime

Per ulteriori informazioni, consulta Utilizzo di parametri di Amazon CloudWatch nella Guida per l'utente di Amazon CloudWatch.

Parametri di CloudWatch: streaming in tempo reale IVS.

Amazon IVS fornisce i parametri riportati di seguito nel namespace AWS/IVSRealTime.

Affinché i parametri di CloudWatch siano disponibili, è necessario utilizzare l'SD di trasmissione Web 1.5.2 o versione successiva.

La dimensione può avere i seguenti valori validi:

  • La dimensione Stage è un ID di risorsa (parte dell'ARN, arn:::stage/<resource id>).

  • La dimensione Participant è un participantID.

  • SimulcastLayer è "elevato", "medio", "basso" o "nessuno" per un MediaType di "video" oppure "nessuno" per un MediaType "audio." Questo valore può essere vuoto.

  • La dimensione MediaType è "video" o "audio" (stringa).

Nel caso della replica dei partecipanti, per la fase di destinazione, i parametri di integrità della fas esistenti includono tutti i partecipanti replicati (publisher nella fase di origine che sono partecipanti della replica nella fase di destinazione).

Metrica Dimensioni Descrizione

ConcurrentPublishers

—

Numero massimo di partecipanti che possono pubblicare su tutte le fasi in una regione AWS.

Unità: numero

Statistiche valide: media, minimo, massimo

ConcurrentSubscriptions

—

Numero massimo di connessioni simultanee tra publisher e abbonato in tutte le fasi in una regione AWS.

Unità: numero

Statistiche valide: media, minimo, massimo

DownloadPacketLoss

—

La percentuale di pacchetti persi dagli abbonati durante il download da un server IVS.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di pacchetti persi nell'intervallo configurato

DownloadPacketLoss

Platform

Filtra DownloadPacketLoss per piattaforma di abbonati.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di pacchetti persi nell'intervallo configurato

DownloadPacketLoss

Platform, SDKVersion

Filtra DownloadPacketLoss per piattaforma di abbonati e versione di SDK.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di pacchetti persi nell'intervallo configurato

DownloadPacketLoss

Stage

Filtra DownloadPacketLoss per livello di abbonato.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di pacchetti persi nell'intervallo configurato

DownloadPacketLoss

Stage, Participant

Filtra DownloadPacketLoss per partecipante, per gli abbonati che sono anche publisher. Gli esempi rappresentano la percentuale di pacchetti persi da un abbonato durante il download da un server IVS. I campioni vengono emessi solo quando il partecipante è anche un publisher.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di frame eliminati nell'intervallo configurato

DownloadPacketLoss

Stage, Platform

Filtra DownloadPacketLoss per piattaforma e livello di abbonato.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di pacchetti persi nell'intervallo configurato

DownloadPacketLoss

Stage, Platform, SDKVersion

Filtra DownloadPacketLoss per piattaforma e livello di abbonato e versione di SDK.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di pacchetti persi nell'intervallo configurato

DownloadPacketLoss

Stage, SubscriberCountryCode

Filtra DownloadPacketLoss per livello e codice paese (ISO 3166) di abbonato.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di pacchetti persi nell'intervallo configurato

DownloadPacketLoss

SubscriberCountryCode

Filtra DownloadPacketLoss per codice paese (ISO 3166) dell'abbonato.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di pacchetti persi nell'intervallo configurato

DroppedFrames

—

Per gli abbonati: la percentuale di fotogrammi video persi, calcolata aggregando i frame ricevuti e i frame eliminati da tutti gli editori a cui l'abbonato è abbonato.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di frame eliminati nell'intervallo configurato

DroppedFrames

Platform

Filtra DroppedFrames per piattaforma dell'abbonato.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di frame eliminati nell'intervallo configurato

DroppedFrames

Platform, SDKVersion

Filtra DroppedFrames per piattaforma dell'abbonato e versione di SDK.

Percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di frame eliminati nell'intervallo configurato

DroppedFrames

Stage

Filtra DroppedFrames per fase.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di frame eliminati nell'intervallo configurato

DroppedFrames

Stage, Participant

Filtra DroppedFrames per fase e partecipante. Emesso solo per gli abbonati che sono anche publisher.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di frame eliminati nell'intervallo configurato

DroppedFrames

Stage, Platform

Filtra DroppedFrames per fase e piattaforma dell'abbonato.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di frame eliminati nell'intervallo configurato

DroppedFrames

Stage, Platform, SDKVersion

Filtra DroppedFrames per fase e piattaforma dell'abbonato e per versione di SDK.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di frame eliminati nell'intervallo configurato

DroppedFrames

Stage, SubscriberCountryCode

Filtra DroppedFrames per fase e paese dell'abbonato.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di frame eliminati nell'intervallo configurato

DroppedFrames

SubscriberCountryCode

Filtra DroppedFrames per paese dell'abbonato.

Unità: percentuale

Statistiche valide: media, massimo, minimo. Il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di frame eliminati nell'intervallo configurato

PublishBitrate

—

La velocità totale con cui un determinato publisher invia dati video e audio (sommati tra tutti i livelli di simulcast). Ciò include i dati ritrasmessi. Il bitrate può essere gonfiato dalla perdita di pacchetti di upload e dalle ritrasmissioni, poiché riflette ciò che il publisher invia e potrebbe non corrispondere a ciò che IVS riceve o fornisce agli abbonati.

Bit/secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

PublishBitrate

Platform

Filtra PublishBitrate per piattaforma del publisher.

Bit/secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

PublishBitrate

Stage

Filtra PublishBitrate per fase.

Unità: bit al secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

PublishBitrate

Stage, Participant, SimulcastLayer, MediaType

Filtra PublishBitrate per fase, partecipante, livello di simulcast e tipo di supporto. L'ID del layer simulcast è impostato dall'SDK di trasmissione. Quando il simulcast è disabilitato, questo ID di livello verrà impostato su "disabilitato". Il tipo di supporto è "video" o "audio".

Unità: bit al secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

Publishers

Stage

Numero di partecipanti che pubblicano sulla fase.

Unità: numero

Statistiche valide: media, minimo, massimo

PublishFramerate

Stage, Participant

La frequenza con cui i fotogrammi video vengono ricevuti da un determinato publisher. Questa metrica è disponibile solo per i partecipanti che pubblicano tramite RTMP.

Unità: numero al secondo

Statistiche valide: media, massimo, minimo. Il valore medio, più grande o più piccolo (rispettivamente) di framerate nell'intervallo configurato

PublishFramerate

Stage, Participant, SimulcastLayer, MediaType

La frequenza con cui i fotogrammi video vengono ricevuti da un determinato publisher. Questa metrica è disponibile solo per i partecipanti che pubblicano tramite RTMP.

Unità: numero al secondo

Statistiche valide: media, massimo, minimo. Il valore medio, più grande o più piccolo (rispettivamente) di framerate nell'intervallo configurato

PublishResolution

Stage, Participant, SimulcastLayer, MediaType

Numero di pixel sul lato inferiore della larghezza o dell'altezza della cornice. Ad esempio, per un frame orizzontale di dimensioni 1920x1080, PublishResolution è 1080. Per un frame verticale di dimensioni 720x1280, la PublishResolution è 720.

Unità: numero

Statistiche valide: media, minimo, massimo

SubscribeBitrate

—

La velocità totale alla quale un determinato abbonato riceve dati audio e video

Unità: bit al secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

SubscribeBitrate

Platform

Filtra SubscribeBitrate per piattaforma dell'abbonato.

Unità: bit al secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

SubscribeBitrate

Platform, SDKVersion

Filtra SubscribeBitrate per piattaforma dell'abbonato e versione di SDK.

Unità: bit al secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

SubscribeBitrate

Stage

Filtra SubscribeBitrate per fase.

Unità: bit al secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

SubscribeBitrate

Stage, Participant, MediaType

Filtra SubscribeBitrate per fase, partecipante e tipo di supporto. Il tipo di supporto è "video" o "audio". Questo parametro viene emesso solo durante la pubblicazione da parte del partecipante abbonato.

Unità: bit al secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

SubscribeBitrate

Stage, Platform

Filtra SubscribeBitrate per fase e piattaforma dell'abbonato.

Bit/secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

SubscribeBitrate

Stage, Platform, SDKVersion

Filtra SubscribeBitrate per fase e piattaforma dell'abbonato e per versione di SDK.

Bit/secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

SubscribeBitrate

Stage, SubscriberCountryCode

Filtra SubscribeBitrate per fase e codice paese dell'abbonato.

Bit/secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

SubscribeBitrate

SubscriberCountryCode

Filtra SubscribeBitrate per codice paese dell'abbonato (ISO 3166-1 alpha-2).

Bit/secondo

Statistiche valide: media, massimo, minimo: il numero medio, il numero più grande o il numero più piccolo (rispettivamente) di bitrate nell'intervallo configurato

Subscribers

Stage

Numero di partecipanti abbonati alla fase. Tieni presente che i partecipanti che pubblicano e si abbonano attivamente vengono conteggiati sia come publisher che come abbonati.

Unità: numero

Statistiche valide: media, minimo, massimo