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 AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. No painel de navegação à esquerda, em Métricas, selecione Todas as métricas.

3. Escolha a guia Procurar e, em seguida, selecione o namespace EdgeRuntimeAgentpersonalizado.

O Amazon Kinesis Video Streams Edge Agent publica as seguintes métricas sob o namespace: EdgeRuntimeAgent

Dimensões	Estado	Descrição
Nome do stream, RecordJob	Running	Publica continuamente quando RecordJob está em execução. Unidades: Nenhuma. “1" é publicado enquanto RecordJob estiver nesse estado.
	FatalError	Publica se houver um erro RecordJob fatal. Unidades: Nenhuma. “1" é publicado uma vez, quando esse evento ocorre. nota Consulte os registros para obter informações adicionais.
	Concluído	Publica quando um RecordJob é concluído. Unidades: Nenhuma. “1" é publicado uma vez, quando esse evento ocorre.
Nome do stream, UploadJob	Running	Publica continuamente quando UploadJob está em execução. Unidades: Nenhuma. “1" é publicado enquanto UploadJob estiver nesse estado.
	FatalError	Publica os erros UploadJob fatais. Unidades: Nenhuma. “1" é publicado uma vez, quando esse evento ocorre. nota Consulte os registros para obter informações adicionais.
	Concluído	Publica quando o UploadJob é concluído. Unidades: Nenhuma. “1" é publicado uma vez, quando esse evento ocorre.
Nome do fluxo	PercentageSpaceUsed	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 Para mais informações. Unidades: Porcentagem (escala 0—1).
Nome da coisa	Vivo	Publica a cada minuto a partir do Amazon Kinesis Video Streams Edge Agent, independentemente de qualquer configuração em execução nele. Isso pode ser usado para entender se o Amazon Kinesis Video Streams Edge Agent está ativo e pronto para aceitar configurações. Unidades: Nenhuma. “1" é publicado a cada minuto.
	RecordJobs.HealthyJobCount	Contagem total de trabalhos de gravação em execução e programados no Amazon Kinesis Video Streams Edge Agent. Unidades: Contagem.
	UploadJobs.HealthyJobCount	Contagem total de trabalhos de upload em execução e programados no Amazon Kinesis Video Streams Edge Agent. Unidades: Contagem.
	RecordJobs.UnhealthyJobCount	Contagem total de trabalhos de registro com erro no momento. Unidades: Contagem.
	UploadJobs.UnhealthyJobCount	Contagem total de trabalhos de upload com erro no momento. Unidades: Contagem.
	RecordJobs.RunningJobCount	Contagem total de trabalhos de registro em execução ativa. Unidades: Contagem.
	UploadJobs.RunningJobCount	Contagem total de trabalhos de upload em execução ativa. Unidades: Contagem.
	RecordJobs.EdgeConfigCount	Contagem total de configurações de registro em andamento no Amazon Kinesis Video Streams Edge Agent. Unidades: Contagem.
	UploadJobs.EdgeConfigCount	Contagem total de configurações de upload em andamento no Amazon Kinesis Video Streams Edge Agent. Unidades: Contagem.

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:

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 agente Amazon Kinesis Video Streams Edge 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

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 API chamada com a configuração para reiniciar trabalhos que encontrem esse problema.