Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Surveillez l'agent Amazon Kinesis Video Streams Edge avec CloudWatch
<a name="monitoring-edge-cloudwatch"></a>

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/](https://console.aws.amazon.com/cloudwatch/).

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

1. Choisissez l'onglet **Parcourir**, puis sélectionnez l'espace de noms **EdgeRuntimeAgent**personnalisé.

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



- ** Nom du flux, `RecordJob` **
  - **State:** En cours d’exécution / **Description:** Publie en continu lorsque le `RecordJob` est en cours d'exécution.<br />Unités : Aucune. « 1 » est publié tant qu'`RecordJob`il est dans cet état.
  - **State:** FatalError / **Description:** Publie en cas d'erreur `RecordJob` fatale.<br />Unités : Aucune. « 1 » est publié une fois, lorsque cet événement se produit. Consultez les journaux pour plus d'informations. 
  - **State:** Terminé / **Description:** Publie lorsqu'un `RecordJob` est terminé.<br />Unités : Aucune. « 1 » est publié une fois, lorsque cet événement se produit.

- ** Nom du flux, `UploadJob` **
  - **State:** En cours d’exécution / **Description:** Publie en continu lorsque le `UploadJob` est en cours d'exécution.<br />Unités : Aucune. « 1 » est publié tant qu'`UploadJob`il est dans cet état.
  - **State:** FatalError / **Description:** Publie en cas d'erreur `UploadJob` fatale.<br />Unités : Aucune. « 1 » est publié une fois, lorsque cet événement se produit.  Consultez les journaux pour plus d'informations. 
  - **State:** Terminé / **Description:** Publie lorsque le `UploadJob` est terminé.<br />Unités : Aucune. « 1 » est publié une fois, lorsque cet événement se produit.

- ** Nom du stream **
  - **State:** PercentageSpaceUsed
  - **Description:** 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](API_LocalSizeConfig.md).<br />Unités : pourcentage (échelle de 0 à 1). 

- ** Nom de l’objet **
  - **State:** Vivant / **Description:** Publie chaque minute à partir de l'agent Amazon Kinesis Video Streams Edge, quelles que soient les configurations exécutées sur celui-ci.<br />Cela peut être utilisé pour déterminer si l'agent Amazon Kinesis Video Streams Edge est actif et prêt à accepter des configurations.<br />Unités : Aucune. « 1 » est publié toutes les minutes.
  - **State:** RecordJobs.HealthyJobCount / **Description:** Nombre total de tâches d'enregistrement en cours et planifiées sur Amazon Kinesis Video Streams Edge Agent.<br />Unités : Nombre.
  - **State:** UploadJobs.HealthyJobCount / **Description:** Nombre total de tâches de téléchargement en cours et planifiées sur Amazon Kinesis Video Streams Edge Agent.<br />Unités : Nombre.
  - **State:** RecordJobs.UnhealthyJobCount / **Description:** Nombre total de tâches d'enregistrement actuellement erronées.<br />Unités : Nombre.
  - **State:** UploadJobs.UnhealthyJobCount / **Description:** Nombre total de tâches de téléchargement actuellement erronées.<br />Unités : Nombre.
  - **State:** RecordJobs.RunningJobCount / **Description:** Nombre total de tâches d'enregistrement en cours d'exécution active.<br />Unités : Nombre.
  - **State:** UploadJobs.RunningJobCount / **Description:** Nombre total de tâches de téléchargement en cours d'exécution active.<br />Unités : Nombre.
  - **State:** RecordJobs.EdgeConfigCount / **Description:** Nombre total de configurations d'enregistrement en cours de traitement sur Amazon Kinesis Video Streams Edge Agent.<br />Unités : Nombre.
  - **State:** UploadJobs.EdgeConfigCount / **Description:** Nombre total de configurations de téléchargement en cours sur Amazon Kinesis Video Streams Edge Agent.<br />Unités : Nombre.



## CloudWatch conseils relatifs aux métriques pour Amazon Kinesis Video Streams Edge Agent
<a name="monitoring-edge-qa"></a>

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

**Topics**
+ [L'agent Amazon Kinesis Video Streams Edge dispose-t-il de suffisamment d'espace pour enregistrer ?](#monitoring-edge-space)
+ [L'agent Amazon Kinesis Video Streams Edge est-il actif ?](#monitoring-edge-alive)
+ [Y a-t-il des emplois malsains ?](#monitoring-edge-unhealthy)
+ [Certains emplois nécessitent-ils une intervention extérieure ?](#monitoring-edge-intervention)

### L'agent Amazon Kinesis Video Streams Edge dispose-t-il de suffisamment d'espace pour enregistrer ?
<a name="monitoring-edge-space"></a>

**Indicateurs pertinents :** `PercentageSpaceUsed`

**Action :** Aucune action requise.

### L'agent Amazon Kinesis Video Streams Edge est-il actif ?
<a name="monitoring-edge-alive"></a>

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

**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](API_StartEdgeConfigurationUpdate.md)

### Certains emplois nécessitent-ils une intervention extérieure ?
<a name="monitoring-edge-intervention"></a>

**Métriques pertinentes :**
+ `PercentageSpaceUsed`— Si ce chiffre 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 :** effectuez un appel d'API avec la configuration pour redémarrer les tâches qui rencontrent ce problème.