# 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](https://console.aws.amazon.com/ivs).
(Também é possível acessar o console do Amazon IVS por meio do [Console de Gerenciamento da AWS](https://console.aws.amazon.com/).)
1. No painel de navegação, selecione **Palcos**. (Se o painel de navegação estiver recolhido, primeiro abra-o escolhendo o ícone de hambúrguer.)
1. Escolha o palco para acessar a respectiva página de detalhes.
1. 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.
1. 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](broadcast.md).
### Instruções do console
1. Navegue para a página de detalhes do participante conforme as instruções acima.
1. 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](eventbridge.md) 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
1. Listar sessões de palco para encontrar uma sessão de palco:
```
aws ivs-realtime list-stage-sessions --stage-arn
```
1. Listar participantes de uma sessão de palco para encontrar um participante:
```
aws ivs-realtime list-participants --stage-arn –session-id
```
1. Listar eventos para uma sessão palco um participante:
```
aws ivs-realtime list-participant-events --stage-arn --session-id –-participant-id
```
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/](https://console.aws.amazon.com/cloudwatch/).
1. Na navegação lateral, expanda a lista suspensa **Metrics** (Métricas) e, em seguida, selecione **All metrics** (Todas as métricas).
1. 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](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/what-is.html#what-is-aws). Para obter uma lista das regiões compatíveis, consulte a [página do Amazon IVS](https://docs.aws.amazon.com/general/latest/gr/ivs.html) na *Referência geral da AWS*.
1. Na parte inferior da guia **Procurar**, selecione o namespace **IVSRealTime**.
1. Execute um destes procedimentos:
1. Na barra de pesquisa, insira o ID do recurso (parte do ARN, `arn:::ivs:stage/`).
Em seguida, selecione **IVSRealtime > Métricas do Stage**.
1. 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](#stage-health-cloudwatch-metrics) abaixo.
1. Escolha as métricas a serem adicionadas ao gráfico. As métricas disponíveis estão listadas em [Métricas do CloudWatch](#stage-health-cloudwatch-metrics) 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) 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/`).
+ 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 |