

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`

[\[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
<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.