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á.
# Monitoramento dos Amazon Kinesis Video Streams
O monitoramento é uma parte importante da manutenção da confiabilidade, disponibilidade e desempenho do Amazon Kinesis Video Streams AWS e de suas soluções. Recomendamos coletar dados de monitoramento de todas as partes da sua AWS solução para ajudá-lo a depurar uma falha multiponto, caso ocorra. Antes de começar a monitorar o Amazon Kinesis Video Streams, recomendamos que você crie um plano de monitoramento que inclua respostas às seguintes perguntas:
+ Quais são seus objetivos de monitoramento?
+ Quais recursos você vai monitorar?
+ Com que frequência você vai monitorar esses recursos?
+ Quais ferramentas de monitoramento você usará?
+ Quem realizará o monitoramento das tarefas?
+ Quem deve ser notificado quando algo der errado?
Depois de definir suas metas de monitoramento e criar seu plano de monitoramento, a próxima etapa é estabelecer uma linha de base para o desempenho normal do Amazon Kinesis Video Streams em seu ambiente. Você deve medir o desempenho do Amazon Kinesis Video Streams em vários momentos e sob diferentes condições de carga. Ao monitorar o Amazon Kinesis Video Streams, armazene um histórico dos dados de monitoramento que você coletou. Você pode comparar o desempenho atual do Amazon Kinesis Video Streams com esses dados históricos para ajudá-lo a identificar padrões normais de desempenho e anomalias de desempenho e criar métodos para resolver problemas que possam surgir.
**Topics**
+ [Monitore as métricas do Amazon Kinesis Video Streams com CloudWatch](monitoring-cloudwatch.md)
+ [Monitore o Amazon Kinesis Video Streams Edge Agent com CloudWatch](monitoring-edge-cloudwatch.md)
+ [Registre chamadas de API do Amazon Kinesis Video Streams com AWS CloudTrail](monitoring-cloudtrail.md)
# 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.
# Monitore o Amazon Kinesis Video Streams Edge Agent com CloudWatch
Você pode monitorar o Amazon Kinesis Video Streams Edge Agent usando a CloudWatch Amazon, que coleta e processa dados brutos em métricas legíveis, quase em tempo real. Essas estatísticas são registradas por um período de 15 meses. Com essas informações históricas, você pode ter uma perspectiva melhor sobre o desempenho da sua aplicação web ou do serviço Amazon Kinesis Video Streams Edge Agent.
Para visualizar as métricas, faça o seguinte:
1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação à esquerda, em **Métricas**, selecione **Todas as métricas**.
1. Escolha a guia **Procurar** e, em seguida, selecione o namespace **EdgeRuntimeAgent**personalizado.
O Amazon Kinesis Video Streams Edge Agent publica as seguintes métricas sob o namespace: `EdgeRuntimeAgent`
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/kinesisvideostreams/latest/dg/monitoring-edge-cloudwatch.html)
## CloudWatch orientação de métricas para o Amazon Kinesis Video Streams Edge Agent
CloudWatch as métricas podem ser úteis para encontrar respostas para as seguintes perguntas:
**Topics**
+ [O Amazon Kinesis Video Streams Edge Agent tem espaço suficiente para gravar?](#monitoring-edge-space)
+ [O Amazon Kinesis Video Streams Edge Agent está vivo?](#monitoring-edge-alive)
+ [Existem empregos insalubres?](#monitoring-edge-unhealthy)
+ [Algum trabalho precisa de intervenção externa?](#monitoring-edge-intervention)
### O Amazon Kinesis Video Streams Edge Agent tem espaço suficiente para gravar?
**Métricas relevantes:** `PercentageSpaceUsed`
**Ação:** Nenhuma ação é necessária.
### O Amazon Kinesis Video Streams Edge Agent está vivo?
**Métricas relevantes:** `Alive`
**Ação:** Se em algum momento você parar de receber essa métrica, isso significa que o Amazon Kinesis Video Streams Edge **Agent encontrou um ou mais dos** seguintes:
+ Um problema de tempo de execução do aplicativo: memória ou outra restrição de recursos, bug e assim por diante
+ O AWS IoT dispositivo em que o agente está executando foi desligado, travado ou encerrado
+ O AWS IoT dispositivo não tem conectividade de rede
### Existem empregos insalubres?
**Métricas relevantes:**
+ `RecordJobs.UnhealthyJobCount`
+ `UploadJobs.UnhealthyJobCount`
**Ação:** inspecione os registros e procure a `FatalError` métrica.
+ Se a `FatalError` métrica **estiver** presente, um erro fatal foi encontrado e você precisará reiniciar manualmente o trabalho. Inspecione os registros e corrija o problema antes de usar `StartEdgeConfigurationUpdate` para reiniciar manualmente o trabalho.
+ Se a `FatalError` métrica **não** estiver presente, um erro transitório (não fatal) foi encontrado e o Amazon Kinesis Video Streams Edge Agent está tentando realizar o trabalho novamente.
**nota**
Para que o agente tente novamente um trabalho com erro fatal, use. [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md)
### Algum trabalho precisa de intervenção externa?
**Métricas relevantes:**
+ `PercentageSpaceUsed`— Se isso exceder um determinado valor, o trabalho de gravação será pausado e retomado somente quando houver espaço disponível (quando a mídia sair da retenção). Você pode enviar uma configuração atualizada com uma superior `MaxLocalMediaSizeInMB` para atualizar o trabalho imediatamente.
+ `RecordJob.FatalError`/`UploadJob.FatalError`— Investigue os registros do agente e envie a configuração novamente para que o trabalho seja retomado.
**Ação:** faça uma chamada de API com a configuração para reiniciar trabalhos que encontrem esse problema.
# Registre chamadas de API do Amazon Kinesis Video Streams com AWS CloudTrail
O Amazon Kinesis Video Streams AWS CloudTrail trabalha com, um serviço que fornece um registro das ações realizadas por um usuário, uma função AWS service (Serviço da AWS) ou um no Amazon Kinesis Video Streams. CloudTrail captura todas as chamadas de API para o Amazon Kinesis Video Streams como eventos. As chamadas capturadas incluem chamadas do console do Amazon Kinesis Video Streams e chamadas de código para as operações da API do Amazon Kinesis Video Streams. Se você criar uma trilha, poderá habilitar a entrega contínua de CloudTrail eventos para um bucket do Amazon S3, incluindo eventos para o Amazon Kinesis Video Streams. Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no **Histórico de eventos**. Usando as informações coletadas por CloudTrail, você pode determinar a solicitação que foi feita ao Amazon Kinesis Video Streams, o endereço IP a partir do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e detalhes adicionais.
Para saber mais CloudTrail, inclusive como configurá-lo e ativá-lo, consulte o *[Guia AWS CloudTrail do usuário](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)*.
## Amazon Kinesis Video Streams e CloudTrail
CloudTrail é ativado em sua AWS conta quando você cria a conta. Quando uma atividade de evento suportada ocorre no Amazon Kinesis Video Streams, essa atividade é registrada CloudTrail em um evento junto AWS com outros eventos de serviço no histórico de **eventos**. Você pode visualizar, pesquisar e baixar eventos recentes em sua AWS conta. Para obter mais informações, consulte [Visualização de eventos com histórico de CloudTrail eventos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Para um registro contínuo dos eventos em sua AWS conta, incluindo eventos do Amazon Kinesis Video Streams, crie uma trilha. Uma *trilha* permite CloudTrail entregar arquivos de log para um bucket do Amazon S3. Por padrão, quando você cria uma trilha no console, ela é aplicada a todas as Regiões da AWS. A trilha registra eventos de todas as regiões na AWS partição e entrega os arquivos de log ao bucket do Amazon S3 que você especificar. Além disso, você pode configurar outros Serviços da AWS para analisar e agir com base nos dados do evento coletados nos CloudTrail registros. Para saber mais, consulte:
+ [Visão Geral para Criar uma Trilha](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Serviços e integrações compatíveis](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configurando notificações do Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Recebendo arquivos de CloudTrail log de várias regiões](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [recebendo arquivos de CloudTrail log de várias contas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
O Amazon Kinesis Video Streams oferece suporte ao registro das seguintes ações como CloudTrail eventos em arquivos de log:
+ [CreateStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_CreateStream.html)
+ [DeleteStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DeleteStream.html)
+ [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html)
+ [GetDataEndpoint](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_GetDataEndpoint.html)
+ [ListStreams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html)
+ [ListTagsForStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListTagsForStream.html)
+ [TagStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_TagStream.html)
+ [UntagStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_UntagStream.html)
+ [UpdateDataRetention](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_UpdateDataRetention.html)
+ [UpdateStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_UpdateStream.html)
Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar o seguinte:
+ Se a solicitação foi feita com credenciais de usuário raiz ou do
+ Se a solicitação foi feita com credenciais de segurança temporárias de um perfil ou de um usuário federado
+ Se a solicitação foi feita por outro AWS service (Serviço da AWS).
Para obter mais informações, consulte [Elemento userIdentity do CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Exemplo: entradas do arquivo de log do Amazon Kinesis Video Streams
Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log para um bucket do Amazon S3 que você especificar. CloudTrail os arquivos de log contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte e inclui informações sobre a ação solicitada, a data e hora da ação, parâmetros de solicitação, e assim por diante. arquivos de log do CloudTrail não são um rastreamento de pilha ordenada das chamadas da API pública. Assim, elas não são exibidas em nenhuma ordem específica.
O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a [CreateStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_CreateStream.html)ação.
```
{
"Records": [
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2018-05-25T00:16:31Z",
"eventSource": " kinesisvideo.amazonaws.com",
"eventName": "CreateStream",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamName": "VideoStream",
"dataRetentionInHours": 2,
"mediaType": "mediaType",
"kmsKeyId": "arn:aws:kms::us-east-1:123456789012:alias",
"deviceName": "my-device"
},
"responseElements": {
"streamARN":arn:aws:kinesisvideo:us-east-1:123456789012:stream/VideoStream/12345"
},
"requestID": "db6c59f8-c757-11e3-bc3b-57923b443c1c",
"eventID": "b7acfcd0-6ca9-4ee1-a3d7-c4e8d420d99b"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2018-05-25:17:06Z",
"eventSource": " kinesisvideo.amazonaws.com",
"eventName": "DeleteStream",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamARN": "arn:aws:kinesisvideo:us-east-1:012345678910:stream/VideoStream/12345",
"currentVersion": "keqrjeqkj9"
},
"responseElements": null,
"requestID": "f0944d86-c757-11e3-b4ae-25654b1d3136",
"eventID": "0b2f1396-88af-4561-b16f-398f8eaea596"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2014-04-19T00:15:02Z",
"eventSource": " kinesisvideo.amazonaws.com",
"eventName": "DescribeStream",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamName": "VideoStream"
},
"responseElements": null,
"requestID": "a68541ca-c757-11e3-901b-cbcfe5b3677a",
"eventID": "22a5fb8f-4e61-4bee-a8ad-3b72046b4c4d"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2014-04-19T00:15:03Z",
"eventSource": "kinesisvideo.amazonaws.com",
"eventName": "GetDataEndpoint",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"streamName": "VideoStream",
"aPIName": "LIST_FRAGMENTS"
"
},
"responseElements": null,
"requestID": "a6e6e9cd-c757-11e3-901b-cbcfe5b3677a",
"eventID": "dcd2126f-c8d2-4186-b32a-192dd48d7e33"
},
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Alice",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"userName": "Alice"
},
"eventTime": "2018-05-25T00:16:56Z",
"eventSource": "kinesisvideo.amazonaws.com",
"eventName": "ListStreams",
"awsRegion": "us-east-1",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version Linux/x.xx",
"requestParameters": {
"maxResults": 100,
"streamNameCondition": {"comparisonValue":"MyVideoStream" comparisonOperator":"BEGINS_WITH"}}
},
"responseElements": null,
"requestID": "e9f9c8eb-c757-11e3-bf1d-6948db3cd570",
"eventID": "77cf0d06-ce90-42da-9576-71986fec411f"
}
]
}
```