Surveillez l'agent Amazon Kinesis Video Streams Edge avec CloudWatch

Vous pouvez surveiller l'agent Amazon Kinesis Video Streams Edge à l'aide d' CloudWatchAmazon, qui collecte et traite les données brutes pour en faire des indicateurs lisibles en temps quasi réel. Ces statistiques sont enregistrées pour une période de 15 mois. Grâce à ces informations historiques, vous pouvez avoir une meilleure idée des performances de votre application Web ou du service Amazon Kinesis Video Streams Edge Agent.

Pour consulter les statistiques, procédez comme suit :

1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Dans le volet de navigation de gauche, sous Mesures, sélectionnez Toutes les mesures.

3. Choisissez l'onglet Parcourir, puis sélectionnez l'espace de noms EdgeRuntimeAgentpersonnalisé.

L'agent Amazon Kinesis Video Streams Edge publie les statistiques suivantes sous l'EdgeRuntimeAgentespace de noms :

Dimensions	État	Description
Nom du flux, RecordJob	En cours d'exécution	Publie en continu lorsque le RecordJob est en cours d'exécution. Unités : Aucune. « 1 » est publié tant qu'RecordJobil est dans cet état.
	FatalError	Publie en cas d'erreur RecordJob fatale. Unités : Aucune. « 1 » n'est publié qu'une seule fois, lorsque cet événement se produit. Note Consultez les journaux pour plus d'informations.
	Terminé	Publie lorsqu'un RecordJob est terminé. Unités : Aucune. « 1 » n'est publié qu'une seule fois, lorsque cet événement se produit.
Nom du flux, UploadJob	En cours d'exécution	Publie en continu lorsque le UploadJob est en cours d'exécution. Unités : Aucune. « 1 » est publié tant qu'UploadJobil est dans cet état.
	FatalError	Publie en cas d'erreur UploadJob fatale. Unités : Aucune. « 1 » n'est publié qu'une seule fois, lorsque cet événement se produit. Note Consultez les journaux pour plus d'informations.
	Terminé	Publie lorsque le UploadJob est terminé. Unités : Aucune. « 1 » n'est publié qu'une seule fois, lorsque cet événement se produit.
Nom du flux	PercentageSpaceUsed	Il s'agit du pourcentage utilisé par rapport à l'espace total alloué dans les configurations de l'agent Amazon Kinesis Video Streams Edge pour l'enregistrement de supports. Pour plus d’informations, consultez LocalSizeConfig. Unités : pourcentage (échelle de 0 à 1).
Nom de l'objet	Vivant	Publie chaque minute depuis l'agent Amazon Kinesis Video Streams Edge, quelles que soient les configurations exécutées sur celui-ci. Cela peut être utilisé pour déterminer si l'agent Amazon Kinesis Video Streams Edge est actif et prêt à accepter des configurations. Unités : Aucune. « 1 » est publié toutes les minutes.
	RecordJobs.HealthyJobCount	Nombre total de tâches d'enregistrement en cours et planifiées sur Amazon Kinesis Video Streams Edge Agent. Unités : Nombre.
	UploadJobs.HealthyJobCount	Nombre total de tâches de téléchargement en cours et planifiées sur Amazon Kinesis Video Streams Edge Agent. Unités : Nombre.
	RecordJobs.UnhealthyJobCount	Nombre total de tâches d'enregistrement actuellement erronées. Unités : Nombre.
	UploadJobs.UnhealthyJobCount	Nombre total de tâches de téléchargement actuellement erronées. Unités : Nombre.
	RecordJobs.RunningJobCount	Nombre total de tâches d'enregistrement en cours d'exécution active. Unités : Nombre.
	UploadJobs.RunningJobCount	Nombre total de tâches de téléchargement en cours d'exécution active. Unités : Nombre.
	RecordJobs.EdgeConfigCount	Nombre total de configurations d'enregistrement en cours de traitement sur Amazon Kinesis Video Streams Edge Agent. Unités : Nombre.
	UploadJobs.EdgeConfigCount	Nombre total de configurations de téléchargement en cours sur Amazon Kinesis Video Streams Edge Agent. Unités : Nombre.

CloudWatch conseils relatifs aux métriques pour Amazon Kinesis Video Streams Edge Agent

CloudWatch les métriques peuvent être utiles pour trouver des réponses aux questions suivantes :

L'agent Amazon Kinesis Video Streams Edge dispose-t-il de suffisamment d'espace pour enregistrer ?

Indicateurs pertinents : PercentageSpaceUsed

Action : Aucune action n'est requise.

L'agent Amazon Kinesis Video Streams Edge est-il actif ?

Indicateurs pertinents : Alive

Action : Si, à un moment donné, vous ne recevez plus cette métrique, cela signifie que l'agent Amazon Kinesis Video Streams Edge a rencontré un ou plusieurs des problèmes suivants :

• Un problème d'exécution de l'application : contrainte de mémoire ou autre contrainte de ressources, bogue, etc.

• L' AWS IoT appareil sur lequel l'agent est en cours d'exécution lors de l'arrêt, s'est écrasé ou s'est arrêté

• L' AWS IoT appareil n'est pas connecté au réseau

Y a-t-il des emplois insalubres ?

Métriques pertinentes :

• RecordJobs.UnhealthyJobCount

• UploadJobs.UnhealthyJobCount

Action : Inspectez les journaux et recherchez la FatalError métrique.

• Si la FatalError métrique est présente, une erreur fatale s'est produite et vous devez redémarrer le travail manuellement. Inspectez les journaux et corrigez le problème avant StartEdgeConfigurationUpdate de recommencer manuellement le travail.

• Si la FatalError métrique n'est pas présente, une erreur passagère (non fatale) s'est produite et l'agent Amazon Kinesis Video Streams Edge tente à nouveau la tâche.

Note

Pour que l'agent tente à nouveau une tâche fatalement erronée, utilisez. StartEdgeConfigurationUpdate

Certains emplois nécessitent-ils une intervention extérieure ?

Métriques pertinentes :

• PercentageSpaceUsed— Si cette valeur dépasse une certaine valeur, le travail d'enregistrement est suspendu et ne reprend que lorsque l'espace est disponible (lorsque le support n'est plus conservé). Vous pouvez envoyer une configuration mise à jour avec une valeur supérieure MaxLocalMediaSizeInMB pour mettre à jour la tâche immédiatement.

• RecordJob.FatalError/UploadJob.FatalError— Examinez les journaux de l'agent et renvoyez la configuration pour que le travail reprenne.

Action : passez un API appel avec la configuration pour redémarrer les tâches qui rencontrent ce problème.