

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 o Amazon Kinesis Video Streams Edge Agent com CloudWatch
<a name="monitoring-edge-cloudwatch"></a>

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`



- ** Nome do stream, `RecordJob` **
  - **Estado:** Em execução / **Description:** Publica continuamente quando `RecordJob` está em execução.<br />Unidades: Nenhuma. “1" é publicado enquanto `RecordJob` estiver nesse estado.
  - **Estado:** FatalError / **Description:** Publica se houver um erro `RecordJob` fatal.<br />Unidades: Nenhuma. “1" é publicado uma vez, quando esse evento ocorre. Consulte os registros para obter informações adicionais. 
  - **Estado:** Completed / **Description:** Publica quando um `RecordJob` é concluído.<br />Unidades: Nenhuma. “1" é publicado uma vez, quando esse evento ocorre.

- ** Nome do stream, `UploadJob` **
  - **Estado:** Em execução / **Description:** Publica continuamente quando `UploadJob` está em execução.<br />Unidades: Nenhuma. “1" é publicado enquanto `UploadJob` estiver nesse estado.
  - **Estado:** FatalError / **Description:** Publica os erros `UploadJob` fatais.<br />Unidades: Nenhuma. “1" é publicado uma vez, quando esse evento ocorre.  Consulte os registros para obter informações adicionais. 
  - **Estado:** Completed / **Description:** Publica quando o `UploadJob` é concluído.<br />Unidades: Nenhuma. “1" é publicado uma vez, quando esse evento ocorre.

- ** Nome do fluxo **
  - **Estado:** PercentageSpaceUsed
  - **Description:** Essa é a porcentagem usada do espaço total alocado nas configurações do Amazon Kinesis Video Streams Edge Agent para mídia de gravação. Consulte [LocalSizeConfig](API_LocalSizeConfig.md) para obter mais informações.<br />Unidades: Porcentagem (escala 0—1). 

- ** Nome da coisa **
  - **Estado:** Vivo / **Description:** Publica a cada minuto a partir do Amazon Kinesis Video Streams Edge Agent, independentemente de qualquer configuração em execução nele.<br />Isso pode ser usado para entender se o Amazon Kinesis Video Streams Edge Agent está ativo e pronto para aceitar configurações.<br />Unidades: Nenhuma. “1" é publicado a cada minuto.
  - **Estado:** RecordJobs.HealthyJobCount / **Description:** Contagem total de trabalhos de gravação em execução e programados no Amazon Kinesis Video Streams Edge Agent.<br />Unidades: contagem.
  - **Estado:** UploadJobs.HealthyJobCount / **Description:** Contagem total de trabalhos de upload em execução e programados no Amazon Kinesis Video Streams Edge Agent.<br />Unidades: contagem.
  - **Estado:** RecordJobs.UnhealthyJobCount / **Description:** Contagem total de trabalhos de registro com erro no momento.<br />Unidades: contagem.
  - **Estado:** UploadJobs.UnhealthyJobCount / **Description:** Contagem total de trabalhos de upload com erro no momento.<br />Unidades: contagem.
  - **Estado:** RecordJobs.RunningJobCount / **Description:** Contagem total de trabalhos de registro em execução ativa.<br />Unidades: contagem.
  - **Estado:** UploadJobs.RunningJobCount / **Description:** Contagem total de trabalhos de upload em execução ativa.<br />Unidades: contagem.
  - **Estado:** RecordJobs.EdgeConfigCount / **Description:** Contagem total de configurações de registro em andamento no Amazon Kinesis Video Streams Edge Agent.<br />Unidades: contagem.
  - **Estado:** UploadJobs.EdgeConfigCount / **Description:** Contagem total de configurações de upload em andamento no Amazon Kinesis Video Streams Edge Agent.<br />Unidades: contagem.



## CloudWatch orientação de métricas para o Amazon Kinesis Video Streams Edge Agent
<a name="monitoring-edge-qa"></a>

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?
<a name="monitoring-edge-space"></a>

**Métricas relevantes:** `PercentageSpaceUsed`

**Ação:** Nenhuma ação é necessária.

### O Amazon Kinesis Video Streams Edge Agent está vivo?
<a name="monitoring-edge-alive"></a>

**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?
<a name="monitoring-edge-unhealthy"></a>

**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?
<a name="monitoring-edge-intervention"></a>

**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.