# 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](https://console.aws.amazon.com/ivs).
L'accesso alla console Amazon IVS è possibile anche dalla [Console di gestione AWS](https://console.aws.amazon.com/).
1. Nel riquadro di navigazione, scegli **Fasi**. Se il riquadro di navigazione è compresso, aprirlo prima scegliendo l'icona a hamburger.
1. Scegli la fase per accedere alla rispettiva pagina dei dettagli.
1. 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.
1. 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](broadcast.md).
### Istruzioni per la console
1. Accedi alla pagina dei dettagli del partecipante come indicato sopra.
1. 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](eventbridge.md) 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
1. Elenca le sessioni di fase per trovare una sessione di fase:
```
aws ivs-realtime list-stage-sessions --stage-arn
```
1. Elenca i partecipanti a una sessione di fase per trovare un partecipante:
```
aws ivs-realtime list-participants --stage-arn –session-id
```
1. Elenca gli eventi per una sessione di fase e per il partecipante:
```
aws ivs-realtime list-participant-events --stage-arn --session-id –-participant-id
```
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/](https://console.aws.amazon.com/cloudwatch/).
1. Nella navigazione laterale, espandere il menu a discesa **Metrics (Parametri)**, quindi selezionare **All metrics (Tutti i parametri)**.
1. 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](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/what-is.html#what-is-aws). Per un elenco delle Regioni supportate, consultare la [pagina di Amazon IVS](https://docs.aws.amazon.com/general/latest/gr/ivs.html) nei *Riferimenti generali di AWS*.
1. Nella parte inferiore della scheda **Sfoglia**, seleziona il namespace **IVSRealTime**.
1. Esegui una delle seguenti operazioni:
1. Nella barra di ricerca digitare l'ID della risorsa (parte dell'ARN, `arn:::ivs:stage/`).
**Quindi seleziona IVSRealTime > Parametri fase.**
1. 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](#stage-health-cloudwatch-metrics) qui sotto.
1. Seleziona i parametri da aggiungere al grafico. I parametri disponibili sono elencati nei [Parametri di CloudWatch](#stage-health-cloudwatch-metrics) 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) 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/`).
+ 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 |