Monitoramento do Streaming em tempo real do Amazon IVS - Amazon IVS
O que é uma sessão de palco?Visualizar sessões de palco e participantesVisualizar eventos para um participanteAcessar métricas do CloudWatchMétricas do CloudWatch: streaming em tempo real do IVS

Monitoramento do Streaming em tempo real do Amazon IVS

Este documento fornece detalhes sobre as opções disponíveis para monitorar sua aplicação de streaming em tempo real do IVS.

O que é uma sessão de palco?

Uma sessão de palco começa quando o primeiro participante entra em um palco e termina alguns minutos após o último participante parar de publicar no palco. As sessões de palco ajudam a depurar palcos de longa duração separando eventos e participantes em sessões de curta duração.

Visualizar sessões de palco e participantes

Instruções do console

  1. Abra o console do Amazon IVS.

    (Também é possível acessar o console do Amazon IVS por meio do Console de Gerenciamento da AWS.)

  2. No painel de navegação, selecione Palcos. (Se o painel de navegação estiver recolhido, primeiro abra-o escolhendo o ícone de hambúrguer.)

  3. Escolha o palco para acessar a respectiva página de detalhes.

  4. Role a página para baixo até ver a seção Sessões de palco e selecione uma sessão de palco para ver sua página de detalhes.

  5. Para visualizar os participantes da sessão, role para baixo até ver a seção Participantes e selecione um participante para visualizar a página de detalhes, incluindo gráficos das métricas do Amazon CloudWatch.

Visualizar eventos para um participante

Os eventos são enviados quando o status de um participante em um palco sofre alterações, como ingressar em um palco ou encontrar um erro ao tentar publicar em um palco. Nem todos os erros causam eventos, por exemplo, erros de rede do lado do cliente e erros de assinatura de token não são enviados como eventos. Para lidar com esses erros na aplicação do cliente, use os SDKs de Transmissão do IVS.

Instruções do console

  1. Navegue para a página de detalhes do participante conforme as instruções acima.

  2. Role para baixo até ver a seção Eventos. Isso exibe uma lista ordenada dos eventos do participante. Consulte Como usar o Amazon EventBridge com o Amazon IVS para obter detalhes sobre eventos que são emitidos para os participantes.

Instruções da CLI

Acessar eventos de sessão de palco com a AWS CLI é uma opção avançada e requer que você primeiro faça download e configure a CLI em sua máquina. Para obter mais detalhes, consulte o Guia do usuário da AWS Command Line Interface.

  1. Listar sessões de palco para encontrar uma sessão de palco:

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

  2. Listar participantes de uma sessão de palco para encontrar um participante:

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

  3. Listar eventos para uma sessão palco um participante:

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

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

Acessar métricas do CloudWatch

Para que as métricas do CloudWatch estejam disponíveis, as seguintes versões do SDK de transmissão do IVS são necessárias: Web 1.5.0 ou posterior, Android 1.12.0 ou posterior ou iOS 1.12.0 ou posterior.

Instruções do console do CloudWatch

  1. Abra o console do CloudWatch, em https://console.aws.amazon.com/cloudwatch/.

  2. Na navegação lateral, expanda a lista suspensa Metrics (Métricas) e, em seguida, selecione All metrics (Todas as métricas).

  3. Na guia Procurar, usando o menu suspenso sem rótulo à esquerda, selecione a sua região “inicial”, onde os seus canais foram criados. Para obter mais informações sobre regiões, consulte Solução global, controle regional. Para obter uma lista das regiões compatíveis, consulte a página do Amazon IVS na Referência geral da AWS.

  4. Na parte inferior da guia Procurar, selecione o namespace IVSRealTime.

  5. Execute um destes procedimentos:

    1. Na barra de pesquisa, insira o ID do recurso (parte do ARN, arn:::ivs:stage/<resource id>).

      Em seguida, selecione IVSRealtime > Métricas do Stage.

    2. Se IVSRealTime aparecer como um serviço selecionável em Namespaces da AWS selecione essa opção. Ela estará listada se você usar o streaming em tempo real do Amazon IVS e estiver enviando métricas para o Amazon CloudWatch. (Se a opção IVSRealTime não estiver listada, você não terá nenhuma métrica do Amazon IVS.)

      Em seguida, escolha um agrupamento de dimensões, conforme desejado. As dimensões disponíveis estão listadas em Métricas do CloudWatch abaixo.

  6. Escolha as métricas a serem adicionadas ao gráfico. As métricas disponíveis estão listadas em Métricas do CloudWatch abaixo.

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 em tempo real do Amazon IVS usando a AWS CLI:

  • Em um prompt de comando, execute:

    aws cloudwatch list-metrics --namespace AWS/IVSRealTime

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 em tempo real do IVS

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

Para que as métricas do CloudWatch estejam disponíveis, o Web Broadcast SDK 1.5.2 ou posterior deve ser usado.

A dimensão pode ter os seguintes valores válidos:

  • A dimensão Stage é um ID de recurso (parte do ARN, arn:::stage/<resource id>).

  • A dimensão Participant é um participantID.

  • O SimulcastLayer é “alto”, “médio”, “baixo” ou “nenhum” para um MediaType de “vídeo” ou “nenhum” para um MediaType de “áudio”. Esse valor também pode estar vazio.

  • A dimensão MediaType é "vídeo" ou "áudio" (string).

No caso da replicação de participantes, para o palco de destino, as métricas de integridade do palco existentes incluem todos os participantes replicados (publicadores no palco de origem que são as réplicas de participantes no palco de destino).

Métrica Dimensões Descrição

ConcurrentPublishers

—

Número de participantes que podem publicar em todos os estágios em uma região da AWS.

Unidade: Contagem

Estatísticas válidas: médio, máximo, mínimo

ConcurrentSubscriptions

—

Número de conexões simultâneas entre publicador e assinante em todos os estágios em uma região da AWS.

Unidade: Contagem

Estatísticas válidas: médio, máximo, mínimo

DownloadPacketLoss

—

Porcentagem de pacotes perdidos durante o download do servidor do IVS pelos assinantes.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da perda de pacotes durante o intervalo configurado

DownloadPacketLoss

Platform

Filtros de DownloadPacketLoss por plataforma de assinante.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da perda de pacotes durante o intervalo configurado

DownloadPacketLoss

Platform, SDKVersion

Filtros de DownloadPacketLoss por plataforma de assinante e versão do SDK.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da perda de pacotes durante o intervalo configurado

DownloadPacketLoss

Stage

Filtros de DownloadPacketLoss por estágio de assinante.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da perda de pacotes durante o intervalo configurado

DownloadPacketLoss

Stage, Participant

Filtros DownloadPacketLoss por participante, para assinantes que também são publicadores. As amostras representam a porcentagem de pacotes que foram perdidos pelo assinante durante o download do servidor do IVS. As amostras são emitidas somente quando o participante também é um publicador.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) de quadros abandonados durante o intervalo configurado

DownloadPacketLoss

Stage, Platform

Filtros de DownloadPacketLoss por estágio de assinante e plataforma.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da perda de pacotes durante o intervalo configurado

DownloadPacketLoss

Stage, Platform, SDKVersion

Filtros de DownloadPacketLoss por estágio de assinante, plataforma e versão do SDK.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da perda de pacotes durante o intervalo configurado

DownloadPacketLoss

Stage, SubscriberCountryCode

Filtros de DownloadPacketLoss por estágio de assinante e código do país (ISO 3166).

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da perda de pacotes durante o intervalo configurado

DownloadPacketLoss

SubscriberCountryCode

Filtros de DownloadPacketLoss por código do país do assinante (ISO 3166).

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da perda de pacotes durante o intervalo configurado

DroppedFrames

—

Para assinantes: a porcentagem de quadros de vídeo descartados, calculada somando os quadros recebidos e os quadros descartados de todos os publicadores aos quais o assinante está inscrito.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) de quadros abandonados durante o intervalo configurado

DroppedFrames

Platform

Filtros de DroppedFrames por plataforma de assinante.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) de quadros abandonados durante o intervalo configurado

DroppedFrames

Platform, SDKVersion

Filtros de DroppedFrames por plataforma de assinante e versão do SDK.

Percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) de quadros abandonados durante o intervalo configurado

DroppedFrames

Stage

Filtros de DroppedFrames por estágio.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) de quadros abandonados durante o intervalo configurado

DroppedFrames

Stage, Participant

Filtros de DroppedFrames por estágio e participante. Emitido apenas para assinantes que também são publicadores.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) de quadros abandonados durante o intervalo configurado

DroppedFrames

Stage, Platform

Filtros de DroppedFrames por estágio e plataforma de assinante.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) de quadros abandonados durante o intervalo configurado

DroppedFrames

Stage, Platform, SDKVersion

Filtros de DroppedFrames por estágio, plataforma de assinante e versão do SDK.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) de quadros abandonados durante o intervalo configurado

DroppedFrames

Stage, SubscriberCountryCode

Filtros de DroppedFrames por estágio e país do assinante.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) de quadros abandonados durante o intervalo configurado

DroppedFrames

SubscriberCountryCode

Filtros de DroppedFrames por país do assinante.

Unidade: percentual

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) de quadros abandonados durante o intervalo configurado

PublishBitrate

—

A taxa total na qual um publicador está enviando dados de vídeo e de áudio (a soma em todas as camadas de transmissão simultânea). Isso inclui dados retransmitidos. A taxa de bits pode ser inflada pela perda de pacotes de upload e retransmissões, já que reflete o que o publicador envia e pode não corresponder ao que o IVS recebe ou entrega aos assinantes.

Bits/segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

PublishBitrate

Platform

Filtros de PublishBitrate por plataforma do publicador.

Bits/segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

PublishBitrate

Stage

Filtros de PublishBitrate por estágio.

Unidade: bits por segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

PublishBitrate

Stage, Participant, SimulcastLayer, MediaType

Filtros de PublishBitrate por estágio, camada de transmissão simultânea e tipo de mídia. O ID da camada de transmissão simultânea é definido pelo SDK de transmissão. Quando a transmissão simultânea está desabilitada, o ID dessa camada está definido como "desabilitado". O tipo de mídia é "vídeo" ou "áudio".

Unidade: bits por segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

Publishers

Stage

Número de participantes publicando no Stage.

Unidade: Contagem

Estatísticas válidas: médio, máximo, mínimo

PublishFramerate

Stage, Participant

Com que frequência os quadros de vídeo são recebidos de um determinado publicador. Essa métrica está disponível somente para participantes que publicam em RTMP.

Unidade: contagem/segundo

Estatísticas válidas (média, máxima, mínima): o número médio, o número mais alto ou o número mais baixo (respectivamente) de taxa de quadros durante o intervalo configurado

PublishFramerate

Stage, Participant, SimulcastLayer, MediaType

Com que frequência os quadros de vídeo são recebidos de um determinado publicador. Essa métrica está disponível somente para participantes que publicam em RTMP.

Unidade: contagem/segundo

Estatísticas válidas (média, máxima, mínima): o número médio, o número mais alto ou o número mais baixo (respectivamente) de taxa de quadros durante o intervalo configurado

PublishResolution

Stage, Participant, SimulcastLayer, MediaType

Número de pixels ao longo da menor largura ou altura do quadro. Por exemplo, para um quadro no formato de paisagem de 1920 x 1080, a PublishResolution é 1080. Para um quadro no formato de retrato de 720 x 1280, a PublishResolution é 720.

Unidade: Contagem

Estatísticas válidas: médio, máximo, mínimo

SubscribeBitrate

—

A taxa total na qual um assinante está recebendo dados de vídeo e áudio.

Unidade: bits por segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

SubscribeBitrate

Platform

Filtros de SubscribeBitrate por plataforma de assinante.

Unidade: bits por segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

SubscribeBitrate

Platform, SDKVersion

Filtros de SubscribeBitrate por plataforma de assinante e versão do SDK.

Unidade: bits por segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

SubscribeBitrate

Stage

Filtros de SubscribeBitrate por estágio.

Unidade: bits por segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

SubscribeBitrate

Stage, Participant, MediaType

Filtros de SubscribeBitrate por estágio, participante e tipo de mídia. O tipo de mídia é "vídeo" ou "áudio". As métricas são emitidas somente enquanto o participante assinante está publicando.

Unidade: bits por segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

SubscribeBitrate

Stage, Platform

Filtros de SubscribeBitrate por estágio e plataforma de assinante.

Bits/segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

SubscribeBitrate

Stage, Platform, SDKVersion

Filtros de SubscribeBitrate por estágio, plataforma de assinante e versão do SDK.

Bits/segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

SubscribeBitrate

Stage, SubscriberCountryCode

Filtros de SubscribeBitrate por estágio e código do país do assinante.

Bits/segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

SubscribeBitrate

SubscriberCountryCode

Filtros de SubscribeBitrate por código do país do assinante (ISO 3166-1 alpha-2).

Bits/segundo

Estatísticas válidas: médio, máximo, mínimo: o número médio, o número mais alto ou o número mais baixo (respectivamente) da taxa de bits durante o intervalo configurado

Subscribers

Stage

Número de participantes que são assinantes do Stage. Observe que os participantes que publicam e assinam ativamente são contados tanto como publicadores quanto como assinantes.

Unidade: Contagem

Estatísticas válidas: médio, máximo, mínimo