Monitoraggio dello streaming in tempo reale di Amazon IVS

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 Fase. 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. Aprire 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 lo spazio dei nomi 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 nello spazio nomi 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 "no-rid" per un MediaType di "video" oppure "disabilitato" per un MediaType "audio." Questo valore può essere vuoto.

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

Metrica	Dimensione	Description
DownloadPacketLoss	Stage	Ogni esempio rappresenta la percentuale di pacchetti persi da un determinato abbonato 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	Stage,Participant	Filtri DownloadPacketLoss per partecipante, per gli abbonati che sono anche editori. 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 editore. 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	Ogni esempio rappresenta la percentuale di frame che sono stati eliminati da un determinato 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,Participant	Filtri DroppedFrames per partecipante, per gli abbonati che sono anche editori. Gli esempi rappresentano la percentuale di fotogrammi interrotti tra il partecipante abbonato e tutti gli editori presenti sullo stage. I campioni vengono emessi solo quando il partecipante è anche un editore. 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	Stage	I campioni emessi rappresentano la velocità totale con cui un determinato editore invia dati video e audio (sommati tra tutti i livelli di simulcast). 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	Filtri PublishBitrate per 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
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	Stage	I campioni emessi rappresentano 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	Stage,Participant,MediaType	Filtri SubscribeBitrate per partecipante, per gli abbonati che sono anche editori. Gli esempi rappresentano il bitrate per il quale un determinato abbonato riceve il dato MediaType. Gli esempi vengono emessi 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
Subscribers	Stage	Numero di partecipanti abbonati alla fase. Tieni presente che i partecipanti che pubblicano e si abbonano attivamente vengono conteggiati sia come editori che come abbonati. Unità: numero Statistiche valide: media, minimo, massimo