Monitoramento do streaming de baixa latência do Amazon IVS

Você pode monitorar os recursos do Amazon Interactive Video Service (IVS) usando o Amazon CloudWatch. O CloudWatch coleta e processa dados brutos do Amazon IVS e os transforma em métricas legíveis quase em tempo real. Essas estatísticas são mantidas por 15 meses, de maneira que você pode obter uma perspectiva histórica de como a aplicação da Web ou o serviço está se saindo. É possível definir alarmes para determinados limites e enviar notificações ou realizar ações quando esses limites são atingidos. Para obter mais detalhes, consulte o Guia do usuário do CloudWatch.

O timestamp em uma métrica representa o início do período em que os dados de métricas são acumulados. Por exemplo, suponhamos que você receba um soma de métricas LiveDeliveredTime por minuto de 300 segundos à 01:02:00. Isso significaria que 5 minutos de vídeo foram entregues aos visualizadores durante o período de 1 minuto, de 01:02:00 às 01:02:59.

Para métricas designadas como de alta resolução, o primeiro ponto de dados aparece vários segundos após o início da transmissão. Recomendamos que você especifique um período de 5 segundos ao fazer as solicitações de métricas. (Consulte Resolução no Guia do usuário do Amazon CloudWatch.) Para outras métricas, os dados são emitidos em até 1 minuto do timestamp ao qual se referem.

As métricas de alta resolução são acumuladas ao longo do tempo. A resolução diminui efetivamente à medida que as métricas envelhecem. A programação é:

Para obter informações atuais sobre retenção de dados, procure por “período de retenção” nas Perguntas frequentes sobre o Amazon CloudWatch.

Pré-requisitos

Acessar dados da sessão de transmissão

Usando o endpoint listStreamSessions, você pode acessar uma lista de transmissões que um canal teve por até 60 dias. Esta lista pode incluir uma sessão de transmissão ao vivo (denotada por um endTime vazio).

Você pode obter os dados da sessão para uma transmissão específica por meio do endpoint getStreamSession. Se você não especificar o parâmetro streamId, o endpoint retornará a sessão mais recente. Além disso, você pode chamar periodicamente o endpoint para obter os últimos eventos de transmissão (até os 500 mais recentes).

Instruções do console

Como alternativa, se um ou mais canais já estiverem ativos:

Instruções do AWS SDK

Acessar dados de sessão de transmissão com o AWS SDK é uma opção avançada e exige que você baixe e configure o SDK na aplicação primeiro. As instruções para o AWS SDK usando JavaScript são descritas a seguir.

Pré-requisito: para usar o exemplo de código abaixo, você precisa carregar o AWS JavaScript SDK em sua aplicação. Para obter mais detalhes, consulte .Conceitos básicos do AWS SDK for 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);

Instruções da CLI

Acessar dados de sessão de transmissão com a AWS CLI é uma opção avançada e exige que você baixe e configure a CLI em sua máquina primeiro. Para obter mais detalhes, consulte o Guia do usuário da Interface de Linhas de Comando da AWS.

Veja uma resposta de exemplo para a chamada 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"
        }
    }
}

Filtrar transmissões por integridade

Para encontrar facilmente quais transmissões estão enfrentando problemas, você pode usar listStreams para filtrar transmissões ao vivo por “integridade”.

Instruções do console

Após a filtragem, você pode acessar a página de detalhes de um canal e selecionar a sessão de transmissão ao vivo do canal para acessar detalhes de configuração de entrada e eventos de transmissão.

Instruções da CLI

Usar a AWS CLI é uma opção avançada e exige que você baixe e configure a CLI em sua máquina primeiro. Para obter mais detalhes, consulte o Guia do usuário da Interface de Linhas de Comando da AWS.

Filtrar transmissões por integridade (por exemplo, STARVING):

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

Dimensão de integridade do CloudWatch para ConcurrentStreams

Você pode filtrar ConcurrentStreams por uma Health específica. Consulte Métricas do CloudWatch: streaming de baixa latência do IVS.

Acessar métricas do CloudWatch

O Amazon CloudWatch coleta e processa dados brutos do Amazon IVS e os transforma em métricas legíveis quase em tempo real. Essas estatísticas são mantidas por 15 meses, de maneira que você pode obter uma perspectiva histórica de como a aplicação da Web ou o serviço está se saindo. É possível definir alarmes para determinados limites e enviar notificações ou realizar ações quando esses limites são atingidos. Para obter mais detalhes, consulte o Guia do usuário do CloudWatch.

Observe que as métricas do CloudWatch são acumuladas ao longo do tempo. A resolução diminui efetivamente à medida que as métricas envelhecem. A programação é:

Ao chamar getMetricData, é possível especificar um período de 1, 5 (recomendado), 10, 30 ou qualquer múltiplo de 60 segundos para métricas de alta resolução.

Instruções do console do CloudWatch

Você também pode acessar o gráfico CloudWatch da sessão de transmissão na página de detalhes da sessão de transmissão selecionando o botão View in CloudWatch (Visualizar no CloudWatch).

Instruções da CLI

Você também pode acessar as métricas usando a AWS CLI. Isso exige que você primeiro faça o download e configure a CLI em sua máquina. Para obter mais detalhes, consulte o Guia do usuário da Interface de Linhas de Comando da AWS.

Depois, para acessar as métricas do streaming de baixa latência do Amazon IVS usando a AWS CLI:

Para obter mais informações, consulte Como usar métricas do Amazon CloudWatch no Guia do usuário do Amazon CloudWatch.

Métricas do CloudWatch: streaming de baixa latência do IVS

O Amazon IVS fornece as seguintes métricas no namespace da AWS/IVS.