Monitoraggio dell'agente Amazon Kinesis Video Streams Edge con CloudWatch

Puoi monitorare Amazon Kinesis Video Streams Edge Agent utilizzando CloudWatch Amazon, che raccoglie ed elabora i dati grezzi in metriche leggibili quasi in tempo reale. Queste statistiche vengono registrate per un periodo di 15 mesi. Con queste informazioni storiche, puoi avere una prospettiva migliore sulle prestazioni della tua applicazione Web o del servizio Amazon Kinesis Video Streams Edge Agent.

Per visualizzare le metriche, procedi come segue:

1. Accedi AWS Management Console e apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

2. Nella barra di navigazione a sinistra, in Metriche, seleziona Tutte le metriche.

3. Scegli la scheda Sfoglia, quindi seleziona lo spazio dei nomi EdgeRuntimeAgentpersonalizzato.

Amazon Kinesis Video Streams Edge Agent pubblica le seguenti metriche nel namespace: EdgeRuntimeAgent

Dimensioni	Stato	Descrizione
Nome dello stream, RecordJob	In esecuzione	Viene pubblicato continuamente quando RecordJob è in esecuzione. Unità: nessuna. «1" viene pubblicato finché si RecordJob trova in questo stato.
	FatalError	Pubblica in caso di errore RecordJob irreversibile. Unità: nessuna. «1" viene pubblicato una sola volta, quando si verifica questo evento. Nota Per ulteriori informazioni, consulta i log.
	Completato	Pubblica quando un RecordJob è completato. Unità: nessuna. «1" viene pubblicato una volta, quando si verifica questo evento.
Nome dello stream, UploadJob	In esecuzione	Viene pubblicato continuamente quando UploadJob è in esecuzione. Unità: nessuna. «1" viene pubblicato finché si UploadJob trova in questo stato.
	FatalError	Pubblica gli errori UploadJob fatali. Unità: nessuna. «1" viene pubblicato una volta, quando si verifica questo evento. Nota Per ulteriori informazioni, consulta i log.
	Completato	Viene pubblicato quando UploadJob è completato. Unità: nessuna. «1" viene pubblicato una volta, quando si verifica questo evento.
Nome del flusso	PercentageSpaceUsed	Questa è la percentuale utilizzata rispetto allo spazio totale allocato nelle configurazioni di Amazon Kinesis Video Streams Edge Agent per la registrazione di contenuti multimediali. Per ulteriori informazioni, consulta LocalSizeConfig. Unità: percentuale (scala 0—1).
Nome oggetto	Vivo	Pubblica ogni minuto da Amazon Kinesis Video Streams Edge Agent, indipendentemente dalle configurazioni in esecuzione su di esso. Questo può essere usato per capire se l'agente Amazon Kinesis Video Streams Edge è attivo e pronto ad accettare configurazioni. Unità: nessuna. «1" viene pubblicato ogni minuto.
	RecordJobs.HealthyJobCount	Numero totale di processi di registrazione in esecuzione e pianificati su Amazon Kinesis Video Streams Edge Agent. Unità: conteggio.
	UploadJobs.HealthyJobCount	Numero totale di processi di caricamento in esecuzione e pianificati su Amazon Kinesis Video Streams Edge Agent. Unità: conteggio.
	RecordJobs.UnhealthyJobCount	Conteggio totale dei processi di registrazione attualmente non riusciti. Unità: conta.
	UploadJobs.UnhealthyJobCount	Conteggio totale dei processi di caricamento attualmente errati. Unità: conta.
	RecordJobs.RunningJobCount	Numero totale di processi record in esecuzione attiva. Unità: conta.
	UploadJobs.RunningJobCount	Numero totale di processi di caricamento in esecuzione attiva. Unità: conta.
	RecordJobs.EdgeConfigCount	Numero totale di configurazioni di record in corso su Amazon Kinesis Video Streams Edge Agent. Unità: conteggio.
	UploadJobs.EdgeConfigCount	Numero totale di configurazioni di caricamento in corso su Amazon Kinesis Video Streams Edge Agent. Unità: conteggio.

CloudWatch indicazioni sui parametri per Amazon Kinesis Video Streams Edge Agent

CloudWatch le metriche possono essere utili per trovare risposte alle seguenti domande:

Amazon Kinesis Video Streams Edge Agent dispone di spazio sufficiente per registrare?

Metriche pertinenti: PercentageSpaceUsed

Azione: nessuna azione richiesta.

L'agente Amazon Kinesis Video Streams Edge è attivo?

Metriche pertinenti: Alive

Azione: Se in qualsiasi momento smetti di ricevere questa metrica, significa che Amazon Kinesis Video Streams Edge Agent ha riscontrato una o più delle seguenti condizioni:

• Un problema di runtime dell'applicazione: vincoli di memoria o di altre risorse, bug e così via

• Il AWS IoT dispositivo su cui l'agente è in esecuzione al momento dello spegnimento, si è bloccato o è terminato

• Il AWS IoT dispositivo non dispone di connettività di rete

Ci sono lavori non salutari?

Parametri pertinenti:

• RecordJobs.UnhealthyJobCount

• UploadJobs.UnhealthyJobCount

Azione: Ispeziona i log e cerca la metrica. FatalError

• Se la FatalError metrica è presente, si è verificato un errore irreversibile ed è necessario riavviare manualmente il processo. Ispeziona i log e risolvi il problema prima di StartEdgeConfigurationUpdate riavviare manualmente il lavoro.

• Se la FatalError metrica non è presente, si è verificato un errore transitorio (non fatale) e Amazon Kinesis Video Streams Edge Agent sta riprovando a eseguire il lavoro.

Nota

Per fare in modo che l'agente ritenti un lavoro con errore irreversibile, usa. StartEdgeConfigurationUpdate

Qualche lavoro richiede un intervento esterno?

Parametri pertinenti:

• PercentageSpaceUsed— Se questo valore supera un determinato valore, il processo di registrazione viene messo in pausa e riprende solo quando lo spazio è disponibile (quando i file multimediali non sono più disponibili). È possibile inviare una configurazione aggiornata con una versione superiore MaxLocalMediaSizeInMB per aggiornare immediatamente il lavoro.

• RecordJob.FatalError/UploadJob.FatalError— Analizzate i log dell'agente e inviate nuovamente la configurazione per riprendere il lavoro.

Azione: Effettua una chiamata API con la configurazione per riavviare i lavori che presentano questo problema.