Monitoraggio dello streaming a bassa latenza di Amazon IVS

Utilizzando Amazon CloudWatch è possibile monitorare le risorse di Amazon Interactive Video Service (IVS). CloudWatch raccoglie ed elabora i dati non elaborati da Amazon IVS trasformandoli in parametri leggibili quasi in tempo reale. Queste statistiche vengono conservate per un periodo di 15 mesi, per permettere l'accesso alle informazioni della cronologia e per offrire una prospettiva migliore sulle prestazioni del servizio o dell'applicazione Web. Esiste la possibilità di impostare allarmi che controllano determinate soglie e inviare notifiche o intraprendere azioni quando queste soglie vengono raggiunte. Per informazioni dettagliate, consultare la Guida per l'utente di CloudWatch.

Il timestamp di un parametro rappresenta l'inizio del periodo durante il quale vengono accumulati i dati dei parametri. Ad esempio, si assuma di ottenere una somma di parametri LiveDeliveredTime al minuto di 300 secondi alle 01:02:00. Ciò significa che gli spettatori hanno ricevuto 5 minuti di video durante il periodo di 1 minuto dalle 01:02:00 alle 01:02:59.

Per i parametri designati come ad alta risoluzione, il primo punto dati viene visualizzato alcuni secondi dopo l'avvio dello streaming. Quando si effettuano le richieste di parametri, si consiglia di specificare un periodo di 5 secondi. (Consultare Risoluzione nella Guida per l'utente di Amazon CloudWatch.) Per altri parametri, i dati vengono emessi entro 1 minuto dal timestamp a cui si riferiscono.

I parametri ad alta risoluzione vengono registrati nel tempo. La risoluzione diminuisce sostanzialmente con l'età dei parametri. Lo schema è il seguente:

Per informazioni aggiornate sulla conservazione dei dati, cercare "periodo di conservazione" in Domande frequenti su Amazon CloudWatch.

Prerequisiti

Accesso ai dati della sessione di streaming

Usando l’operazione listStreamSessions, puoi accedere a un elenco di flussi che un canale ha avuto per un massimo di 60 giorni. Questo elenco può includere una sessione di streaming live (indicata da un endTime vuoto).

Puoi ottenere i dati di sessione per un flusso specifico tramite l'operazione getStreamSession. Se specifichi il parametro streamId, l'operazione restituisce la sessione più recente. Inoltre, puoi chiamare periodicamente l'operazione per ottenere gli ultimi eventi del flusso (fino ai 500 più recenti).

Istruzioni per la console

In alternativa, se uno o più canali sono già attivi:

Istruzioni per SDK AWS

L'accesso ai dati delle sessioni di streaming con un SDK AWS è un'opzione avanzata e richiede prima il download e la configurazione dell'SDK sull'applicazione. Di seguito sono riportate le istruzioni per l'SDK AWS che utilizza JavaScript.

Prerequisito: per utilizzare l'esempio di codice riportato di seguito, è necessario caricare l'SDK AWS JavaScript nell'applicazione. Per informazioni dettagliate, consultare Guida introduttiva all'SDK AWS per JavaScript.

// This first call lists up to 50 stream sessions for a given channel.
const AWS = require("aws-sdk");
const REGION = 'us-west-2';
let channelArn = USE_YOUR_CHANNEL_ARN_HERE;

AWS.config.getCredentials(function(err) {
  if (err) console.log(err.stack);
  // credentials not loaded
  else {
    console.log("Access key:", AWS.config.credentials.accessKeyId);
  }
});

AWS.config.update({region: REGION});
var ivs = new AWS.IVS();

// List Stream Sessions
async function listSessions(arn) {
  const result = await ivs.listStreamSessions({"channelArn": arn}).promise();
  console.log(result.streamSessions);
}
listSessions(channelArn);

// Get Stream Session
async function getSession(arn, id) {
  const result = await ivs.getStreamSession({"channelArn": arn, "streamId": id}).promise();
  console.log(result);

  // This function polls every 3 seconds and prints the latest IVS stream events.
  setInterval(function(){
    console.log(result.streamSession.truncatedEvents);
  }, 3000);
}
getSession(channelArn);

Istruzioni per la CLI

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

Di seguito è riportata una risposta di esempio alla chiamata get-stream-session:

{
    "streamSession": {
        "startTime": "2021-10-22T00:03:57+00:00",
        "streamId": "st-1FQzeLONMT9XTKI43leLSo1",
        "truncatedEvents": [
            {
                "eventTime": "2021-10-22T00:09:30+00:00",
                "name": "Session Ended",
                "type": "IVS Stream State Change"
        	},
            {
                "eventTime": "2021-10-22T00:09:30+00:00",
                "name": "Stream End",
                "type": "IVS Stream State Change"
        	},
        	{
                "eventTime": "2021-10-22T00:03:57+00:00",
                "name": "Stream Start",
                "type": "IVS Stream State Change"
        	},
        	{
                "eventTime": "2021-10-22T00:03:50+00:00",
                "name": "Session Created",
                "type": "IVS Stream State Change"
        	}
        ],
        "endTime": "2021-10-22T00:09:31+00:00",
        "ingestConfiguration": {
            "audio": {
                "channels": 2,
                "codec": "mp4a.40.2",
                "sampleRate": 48000,
                "targetBitrate": 160000
        	},
            "video": {
                "avcLevel": "4.0",
                "avcProfile": "Baseline",
                "codec": "avc1.42C028",
                "encoder": "obs-output module (libobs version 27.0.1)",
                "targetBitrate": 3500000,
                "targetFramerate": 30,
                "videoHeight": 1080,
                "videoWidth": 1920
            }
        },
        "channel": {
            "name": "",
            "ingestEndpoint": "3f234d592b38.global-contribute.live-video.net",
            "authorized": false,
            "latencyMode": "LOW",
            "recordingConfigurationArn": "",
            "type": "STANDARD",
            "playbackUrl": "https://3f234d592b38.us-west-2.playback.live-video.net/api/video/v1/us-west-2.991729659840.channel.dY7LsluQX1gV.m3u8",
            "arn": "arn:aws:ivs:us-west-2:991729659840:channel/dY7LsluQX1gV"
        }
    }
}

Filter Streams by Health (Filtro di flussi per integrità)

Per trovare facilmente i flussi che presentano dei problemi, è possibile utilizzare listStreams per filtrare gli streaming live in base all'integrità.

Istruzioni per la console

Dopo aver applicato il filtro, esiste la possibilità di passare alla pagina dei dettagli di un canale e selezionare la relativa sessione di streaming live in modo da accedere ai dettagli della configurazione di input e agli eventi in streaming.

Istruzioni per la CLI

L'uso di AWS CLI è un'opzione avanzata e richiede prima 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.

Per filtrare i flussi in base all'integrità (ad esempio, STARVING):

aws ivs list-streams --filter-by health=STARVING

Dimensione integrità di CloudWatch per ConcurrentStreams

È possibile filtrare ConcurrentStreams per uno specifico valore di Health. Consulta Parametri di CloudWatch: streaming a bassa latenza IVS.

Accesso ai parametri di CloudWatch

Amazon CloudWatch raccoglie ed elabora i dati non elaborati da Amazon IVS trasformandoli in parametri leggibili quasi in tempo reale. Queste statistiche vengono conservate per un periodo di 15 mesi, per permettere l'accesso alle informazioni della cronologia e per offrire una prospettiva migliore sulle prestazioni del servizio o dell'applicazione Web. Esiste la possibilità di impostare allarmi che controllano determinate soglie e inviare notifiche o intraprendere azioni quando queste soglie vengono raggiunte. Per informazioni dettagliate, consultare la Guida per l'utente di CloudWatch.

Tenere presente che i parametri di CloudWatch vengono registrati nel tempo. La risoluzione diminuisce efficacemente con l'età dei parametri. Lo schema è il seguente:

Quando si chiama getMetricData si può specificare un periodo di 1, 5 (consigliato), 10, 30 o qualsiasi multiplo di 60 secondi per i parametri ad alta risoluzione.

Istruzioni per la console CloudWatch

È 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 a bassa latenza di Amazon IVS utilizzando la CLI di AWS:

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

Parametri di CloudWatch: streaming a bassa latenza IVS

Amazon IVS fornisce i parametri riportati di seguito nello spazio nomi AWS/IVS.