As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Monitore as métricas do Amazon Kinesis Video Streams com CloudWatch
Você pode monitorar um stream de vídeo do Kinesis usando a Amazon CloudWatch, que coleta e processa dados brutos do Amazon Kinesis Video Streams em métricas legíveis e quase em tempo real. Essas estatísticas são registradas por um período de 15 meses para que você possa acessar informações históricas e ter uma melhor perspectiva sobre o desempenho de seu aplicativo ou serviço da web.
No console do [Amazon Kinesis Video](https://console.aws.amazon.com//kinesisvideo/home/) Streams, você CloudWatch pode visualizar as métricas de um stream de vídeo do Amazon Kinesis de duas maneiras:
+ Na página **Dashboard (Painel)**, selecione a guia **Video streams (Streamings de vídeo)** na seção **Account-level metrics for Current Region (Métricas no nível da conta para a região atual)**.
+ Selecione a guia **Monitoring (Monitoramento)** na página de detalhes do streaming de vídeo.
O Amazon Kinesis Video Streams fornece as seguintes métricas:
| Métrica | Description |
| --- | --- |
| ArchivedFragmentsConsumed.Media | O número de pontos de cota de mídia fragmentada que foram consumidos por todos os. APIs Para obter uma explicação sobre o conceito de pontos de cota, consulte[Cotas de fragmentação de metadados e de mídia fragmentada](limits.md#fragment_based_throttling).Unidades: contagem |
| ArchivedFragmentsConsumed.Metadata | O número de pontos de cota de metadados de fragmentos que foram consumidos por todos os. APIs Para obter uma explicação sobre o conceito de pontos de cota, consulte[Cotas de fragmentação de metadados e de mídia fragmentada](limits.md#fragment_based_throttling).Unidades: contagem |
| `PutMedia.Requests` | O número de solicitações de `PutMedia` API para um determinado stream. Unidades: contagem |
| `PutMedia.IncomingBytes` | O número de bytes recebidos como parte `PutMedia` do fluxo. Unidades: bytes |
| `PutMedia.IncomingFragments` | O número de fragmentos completos recebidos como parte do `PutMedia` fluxo. Unidades: contagem |
| `PutMedia.IncomingFrames` | O número de quadros completos recebidos como parte `PutMedia` do stream. Unidades: contagem |
| `PutMedia.ActiveConnections` | O número total de conexões com o serviço host. Unidades: contagem |
| `PutMedia.ConnectionErrors` | Os erros ao estabelecer `PutMedia` a conexão para o stream. Unidades: contagem |
| `PutMedia.FragmentIngestionLatency` | A diferença de tempo entre quando o primeiro e o último bytes de um fragmento são recebidos pelo Amazon Kinesis Video Streams. Unidade: milissegundos |
| `PutMedia.FragmentPersistLatency` | O tempo decorrido a partir do momento em que os dados completos do fragmento são recebidos e arquivados. Unidades: contagem |
| `PutMedia.Latency` | A diferença de tempo entre a solicitação e a resposta HTTP InletService ao estabelecer a conexão. Unidades: contagem |
| `PutMedia.BufferingAckLatency` | A diferença de tempo entre quando o primeiro byte de um novo fragmento é recebido pelo Amazon Kinesis Video Streams e quando o Buffering ACK é enviado para o fragmento. Unidade: milissegundos |
| `PutMedia.ReceivedAckLatency` | A diferença de tempo entre quando o último byte de um novo fragmento é recebido pelo Amazon Kinesis Video Streams e quando o ACK recebido é enviado para o fragmento. Unidade: milissegundos |
| `PutMedia.PersistedAckLatency` | A diferença de tempo entre o momento em que o último byte de um novo fragmento é recebido pelo Amazon Kinesis Video Streams e o momento em que o ACK persistente é enviado para o fragmento. Unidade: milissegundos |
| `PutMedia.ErrorAckCount` | O número de erros ACKs enviados `PutMedia` durante a execução do stream. Unidades: contagem |
| `PutMedia.Success` | 1 para cada fragmento gravado com êxito; 0 para cada fragmento com falha. O valor médio dessa métrica indica quantos fragmentos completos e válidos são enviados. Unidades: contagem |
| `GetMedia.Requests` | O número de solicitações de `GetMedia` API para um determinado stream. Unidades: contagem |
| `GetMedia.OutgoingBytes` | O número total de bytes enviados do serviço como parte da `GetMedia` API para um determinado stream. Unidades: bytes |
| `GetMedia.OutgoingFragments` | O número de fragmentos enviados durante a execução `GetMedia` do stream. Unidades: contagem |
| `GetMedia.OutgoingFrames` | O número de quadros enviados durante `GetMedia` um determinado fluxo. Unidades: contagem |
| `GetMedia.MillisBehindNow` | A diferença de horário entre o timestamp atual do servidor e o timestamp do servidor do último fragmento enviado. Unidade: milissegundos |
| `GetMedia.ConnectionErrors` | O número de conexões que não foram estabelecidas com êxito. Unidades: contagem |
| `GetMedia.Success` | 1 para cada fragmento enviado com êxito; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `GetMediaForFragmentList.OutgoingBytes` | O número total de bytes enviados do serviço como parte da `GetMediaForFragmentList` API para um determinado stream. Unidades: bytes |
| `GetMediaForFragmentList.OutgoingFragments` | O número total de fragmentos enviados do serviço como parte da `GetMediaForFragmentList` API para um determinado stream. Unidades: contagem |
| `GetMediaForFragmentList.OutgoingFrames` | O número total de quadros enviados do serviço como parte da `GetMediaForFragmentList` API para um determinado stream. Unidades: contagem |
| `GetMediaForFragmentList.Requests` | O número de solicitações de `GetMediaForFragmentList` API para um determinado stream. Unidades: contagem |
| `GetMediaForFragmentList.Success` | 1 para cada fragmento enviado com êxito; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `ListFragments.Latency` | A latência da `ListFragments` API exige o nome do stream fornecido. Unidade: milissegundos |
| `ListFragments.Requests` | O número de solicitações de `ListFragments` API para um determinado stream. Unidades: contagem |
| `ListFragments.Success` | 1 para cada solicitação bem-sucedida; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `GetHLSStreamingSessionURL.Latency` | A latência da `GetHLSStreamingSessionURL` API exige o nome do stream fornecido. Unidade: milissegundos |
| `GetHLSStreamingSessionURL.Requests` | O número de solicitações de `GetHLSStreamingSessionURL` API para um determinado stream. Unidades: contagem |
| `GetHLSStreamingSessionURL.Success` | 1 para cada solicitação bem-sucedida; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `GetHLSMasterPlaylist.Latency` | A latência da `GetHLSMasterPlaylist` API exige o nome do stream fornecido. Unidade: milissegundos |
| `GetHLSMasterPlaylist.Requests` | O número de solicitações de `GetHLSMasterPlaylist` API para um determinado stream. Unidades: contagem |
| `GetHLSMasterPlaylist.Success` | 1 para cada solicitação bem-sucedida; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `GetHLSMediaPlaylist.Latency` | A latência da `GetHLSMediaPlaylist` API exige o nome do stream fornecido. Unidade: milissegundos |
| `GetHLSMediaPlaylist.Requests` | O número de solicitações de `GetHLSMediaPlaylist` API para um determinado stream. Unidades: contagem |
| `GetHLSMediaPlaylist.Success` | 1 para cada solicitação bem-sucedida; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `GetMP4InitFragment.Latency` | A latência da `GetMP4InitFragment` API exige o nome do stream fornecido. Unidade: milissegundos |
| `GetMP4InitFragment.Requests` | O número de solicitações de `GetMP4InitFragment` API para um determinado stream. Unidades: contagem |
| `GetMP4InitFragment.Success` | 1 para cada solicitação bem-sucedida; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `GetMP4MediaFragment.Latency` | A latência da `GetMP4MediaFragment` API exige o nome do stream fornecido. Unidade: milissegundos |
| `GetMP4MediaFragment.Requests` | O número de solicitações de `GetMP4MediaFragment` API para um determinado stream. Unidades: contagem |
| `GetMP4MediaFragment.Success` | 1 para cada solicitação bem-sucedida; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `GetMP4MediaFragment.OutgoingBytes` | O número total de bytes enviados do serviço como parte da `GetMP4MediaFragment` API para um determinado stream. Unidades: bytes |
| `GetTSFragment.Latency` | A latência da `GetTSFragment` API exige o nome do stream fornecido. Unidade: milissegundos |
| `GetTSFragment.Requests` | O número de solicitações de `GetTSFragment` API para um determinado stream. Unidades: contagem |
| `GetTSFragment.Success` | 1 para cada solicitação bem-sucedida; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `GetTSFragment.OutgoingBytes` | O número total de bytes enviados do serviço como parte da `GetTSFragment` API para um determinado stream. Unidades: bytes |
| `GetDASHStreamingSessionURL.Latency` | A latência da `GetDASHStreamingSessionURL` API exige o nome do stream fornecido. Unidade: milissegundos |
| `GetDASHStreamingSessionURL.Requests` | O número de solicitações de `GetDASHStreamingSessionURL` API para um determinado stream. Unidades: contagem |
| `GetDASHStreamingSessionURL.Success` | 1 para cada solicitação bem-sucedida; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `GetDASHManifest.Latency` | A latência da `GetDASHManifest` API exige o nome do stream fornecido. Unidade: milissegundos |
| `GetDASHManifest.Requests` | O número de solicitações de `GetDASHManifest` API para um determinado stream. Unidades: contagem |
| `GetDASHManifest.Success` | 1 para cada solicitação bem-sucedida; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `GetClip.Latency` | A latência da GetClip API exige o nome do stream de vídeo fornecido. Unidade: milissegundos |
| `GetClip.Requests` | O número de solicitações de GetClip API para um determinado stream de vídeo. Unidades: contagem |
| `GetClip.Success` | 1 para cada solicitação bem-sucedida; 0 para cada falha. O valor médio indica a taxa de sucesso. As falhas incluem erros 400 (usuário) e 500 (sistema). Para obter mais informações sobre como habilitar um resumo de solicitações e respostas, incluindo solicitações IDs, consulte AWS Registro de resumo de [solicitações/respostas](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-logging.html#sdk-net-logging-request-response). Unidades: contagem |
| `GetClip.OutgoingBytes` | O número total de bytes enviados do serviço como parte da GetClip API para um determinado stream de vídeo. Unidades: bytes |
## CloudWatch orientação de métricas
CloudWatch as métricas podem ajudar a encontrar respostas para as seguintes perguntas:
**Topics**
+ [Os dados estão chegando ao serviço Amazon Kinesis Video Streams?](#monitoring-cloudwatch-guidance-incoming)
+ [Por que os dados não estão sendo ingeridos com sucesso pelo serviço Amazon Kinesis Video Streams?](#monitoring-cloudwatch-guidance-errors)
+ [Por que os dados não podem ser lidos do serviço Amazon Kinesis Video Streams na mesma taxa em que estão sendo enviados pelo produtor?](#monitoring-cloudwatch-guidance-rate)
+ [Por que não há nenhum vídeo no console ou por que o vídeo está sendo reproduzido com atraso?](#monitoring-cloudwatch-guidance-novideo)
+ [Qual o motivo do atraso na leitura de dados em tempo real e por que o cliente está ficando para trás em relação ao início do streaming?](#monitoring-cloudwatch-guidance-delay)
+ [O cliente está lendo dados do stream de vídeo do Kinesis e em que taxa?](#monitoring-cloudwatch-guidance-isread)
+ [Por que o cliente não consegue ler os dados do stream de vídeo do Kinesis?](#monitoring-cloudwatch-guidance-noread)
### Os dados estão chegando ao serviço Amazon Kinesis Video Streams?
**Métricas relevantes:**
+ `PutMedia.IncomingBytes`
+ `PutMedia.IncomingFragments`
+ `PutMedia.IncomingFrames`
**Itens de ação:**
+ Se houver uma queda nessas métricas, verifique se seu aplicativo ainda está enviando dados para o serviço.
+ Verifique a largura de banda da rede. Se a largura de banda da rede for insuficiente, pode ser que esteja diminuindo a taxa segundo a qual o serviço está recebendo os dados.
### Por que os dados não estão sendo ingeridos com sucesso pelo serviço Amazon Kinesis Video Streams?
**Métricas relevantes:**
+ `PutMedia.Requests`
+ `PutMedia.ConnectionErrors`
+ `PutMedia.Success`
+ `PutMedia.ErrorAckCount`
**Itens de ação:**
+ Se houver um aumento`PutMedia.ConnectionErrors`, veja a resposta HTTP e os códigos de erro recebidos pelo cliente produtor para ver quais erros estão ocorrendo ao estabelecer a conexão.
+ Se houver uma queda `PutMedia.Success` ou um aumento`PutMedia.ErrorAckCount`, veja o código de erro de hack nas respostas de ack enviadas pelo serviço para ver por que a ingestão de dados está falhando. Para obter mais informações, consulte [AckErrorCode.Values.](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html)
### Por que os dados não podem ser lidos do serviço Amazon Kinesis Video Streams na mesma taxa em que estão sendo enviados pelo produtor?
**Métricas relevantes:**
+ `PutMedia.FragmentIngestionLatency`
+ `PutMedia.IncomingBytes`
**Itens de ação:**
+ Se houver uma queda nessas métricas, verifique a largura de banda da rede de suas conexões. As conexões com baixa largura de banda podem fazer com que os dados alcancem o serviço a uma velocidade mais baixa.
### Por que não há nenhum vídeo no console ou por que o vídeo está sendo reproduzido com atraso?
**Métricas relevantes:**
+ `PutMedia.FragmentIngestionLatency`
+ `PutMedia.FragmentPersistLatency`
+ `PutMedia.Success`
+ `ListFragments.Latency`
+ `PutMedia.IncomingFragments`
**Itens de ação:**
+ Se houver um aumento `PutMedia.FragmentIngestionLatency` ou uma queda`PutMedia.IncomingFragments`, verifique a largura de banda da rede e se os dados ainda estão sendo enviados.
+ Se houver uma lista`PutMedia.Success`, verifique os códigos de erro do Rack. Para obter mais informações, consulte [AckErrorCode.Values.](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html)
+ Se houver um aumento em `PutMedia.FragmentPersistLatency` ou`ListFragments.Latency`, é provável que você esteja enfrentando um problema de serviço. Se a condição persistir por um longo período de tempo, verifique com seu contato de atendimento ao cliente se há algum problema com seu serviço.
### Qual o motivo do atraso na leitura de dados em tempo real e por que o cliente está ficando para trás em relação ao início do streaming?
**Métricas relevantes:**
+ `GetMedia.MillisBehindNow`
+ `GetMedia.ConnectionErrors`
+ `GetMedia.Success`
**Itens de ação:**
+ Se houver um aumento`GetMedia.ConnectionErrors`, o consumidor pode estar ficando para trás na leitura do stream, devido às frequentes tentativas de se reconectar ao stream. Veja os response/error códigos HTTP retornados para a `GetMedia` solicitação.
+ Se houver uma queda`GetMedia.Success`, é provável que o serviço não consiga enviar os dados ao consumidor, o que resultaria na queda da conexão, e na reconexão dos consumidores, o que resultaria em um atraso no início da transmissão.
+ Se houver um aumento`GetMedia.MillisBehindNow`, analise seus limites de largura de banda para ver se você está recebendo os dados em uma taxa mais lenta devido à menor largura de banda.
### O cliente está lendo dados do stream de vídeo do Kinesis e em que taxa?
**Métricas relevantes:**
+ `GetMedia.OutgoingBytes`
+ `GetMedia.OutgoingFragments`
+ `GetMedia.OutgoingFrames`
+ `GetMediaForFragmentList.OutgoingBytes`
+ `GetMediaForFragmentList.OutgoingFragments`
+ `GetMediaForFragmentList.OutgoingFrames`
**Itens de ação:**
+ Essas métricas indicam a taxa na qual os dados arquivados e em tempo real estão sendo lidos.
### Por que o cliente não consegue ler os dados do stream de vídeo do Kinesis?
**Métricas relevantes:**
+ `GetMedia.ConnectionErrors`
+ `GetMedia.Success`
+ `GetMediaForFragmentList.Success`
+ `PutMedia.IncomingBytes`
**Itens de ação:**
+ Se houver um aumento`GetMedia.ConnectionErrors`, veja a resposta HTTP e os códigos de erro retornados pela `GetMedia` solicitação. Para obter mais informações, consulte [AckErrorCode.Values.](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kinesisvideo/model/AckErrorCode.Values.html)
+ Se você estiver tentando ler os dados mais recentes ou ativos, verifique `PutMedia.IncomingBytes` se há dados entrando no stream para o serviço enviar aos consumidores.
+ Se houver uma queda `GetMedia.Success` ou`GetMediaForFragmentList.Success`, provavelmente é porque o serviço não consegue enviar os dados ao consumidor. Se a condição persistir por um longo período de tempo, verifique com seu contato de atendimento ao cliente se há algum problema com seu serviço.