

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.

# Métriques de journalisation pour les appels du plan de AWS AppConfig données
<a name="monitoring-data-plane-call-logging"></a>

Si vous avez configuré AWS CloudTrail pour consigner AWS AppConfig les événements liés aux données, vous pouvez activer Amazon CloudWatch Logs pour enregistrer les métriques relatives aux appels vers le plan de AWS AppConfig données. Vous pouvez ensuite rechercher et filtrer les données des CloudWatch journaux dans Logs en créant un ou plusieurs filtres métriques. Les filtres métriques définissent les termes et les modèles à rechercher dans les données du journal lorsqu'elles sont envoyées à CloudWatch Logs. CloudWatch Logs utilise des filtres métriques pour transformer les données des journaux en CloudWatch métriques numériques. Vous pouvez représenter graphiquement les métriques ou les configurer à l'aide d'une alarme.

**Avant de commencer**  
Activez la journalisation des événements liés aux AWS AppConfig données dans AWS CloudTrail. La procédure suivante décrit comment activer la journalisation des métriques pour un suivi * AWS AppConfig existant* dans CloudTrail. Pour plus d'informations sur la façon d'activer la CloudTrail journalisation des appels du forfait de AWS AppConfig données, consultez[AWS AppConfig événements de données dans CloudTrail](logging-using-cloudtrail.md#cloudtrail-data-events).

Utilisez la procédure suivante pour permettre à CloudWatch Logs de consigner les métriques relatives aux appels vers le plan de AWS AppConfig données.

**Pour permettre à CloudWatch Logs de consigner les métriques des appels vers le plan AWS AppConfig de données**

1. Ouvrez la CloudTrail console à l'adresse [https://console.aws.amazon.com/cloudtrail/](https://console.aws.amazon.com/cloudtrail/).

1. Sur le tableau de bord, choisissez votre AWS AppConfig parcours.

1. Dans la section **CloudWatch Journaux**, choisissez **Modifier**.

1. Choisissez **Enabled (Activé)**.

1. Pour **Nom du groupe de journaux**, laissez le nom par défaut ou saisissez-en un. Notez le nom. Vous choisirez le groupe de journaux dans la console CloudWatch Logs ultérieurement.

1. Pour **Nom du rôle (Role name)**, saisissez un nom.

1. Sélectionnez **Enregistrer les modifications**.

Utilisez la procédure suivante pour créer une métrique et un filtre de métriques pour AWS AppConfig in CloudWatch Logs. La procédure décrit comment créer un filtre métrique pour les appels par `operation` et (éventuellement) pour les appels par `operation` et`Amazon Resource Name (ARN)`.

**Pour créer une métrique et un filtre de métriques pour AWS AppConfig in CloudWatch Logs**

1. Ouvrez la CloudWatch console à l'adresse[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le panneau de navigation de gauche, choisissez **Logs** (Journaux), puis **Log groups** (Groupes de journaux).

1. Cochez la case à côté du groupe de AWS AppConfig journaux.

1. Choisissez **Actions**, puis **Create metric filter** (Créer un filtre de métrique).

1. Dans **Nom du filtre**, entrez un nom.

1. Pour **Modèle de filtre**, entrez ce qui suit :

   ```
   { $.eventSource = "appconfig.amazonaws.com" }
   ```

1. (Facultatif) Dans la section **Modèle de test**, choisissez votre groupe de journaux dans la liste **Sélectionnez les données de journal à tester**. Si aucun appel CloudTrail n'a été enregistré, vous pouvez ignorer cette étape.

1. Choisissez **Suivant**.

1. Pour l'**espace de noms métrique**, entrez**AWS AppConfig**.

1. Pour **Metric name (Nom de métrique)**, saisissez **Calls**.

1. Pour **Valeur de la métrique**, saisissez **1**.

1. Ignorez **la valeur par défaut** et **l'unité**.

1. Dans le **champ Nom de la dimension**, entrez**operation**.

1. Pour **Valeur de dimension**, entrez**$.eventName**.

   (Facultatif) Vous pouvez saisir une deuxième dimension qui inclut l'Amazon Resource Name (ARN) effectuant l'appel. Pour ajouter une deuxième dimension, saisissez le **nom de la dimension****resource**. Pour **Valeur de dimension**, entrez**$.resources[0].ARN**.

   Choisissez **Suivant**.

1. Passez en revue les détails du filtre et **créez un filtre métrique**.

(Facultatif) Vous pouvez répéter cette procédure pour créer un nouveau filtre métrique pour un code d'erreur spécifique tel que *AccessDenied*. Si c'est le cas, entrez les informations suivantes :

1. Dans **Nom du filtre**, entrez un nom.

1. Pour **Modèle de filtre**, entrez ce qui suit :

   ```
   { $.errorCode = "{{codename}}" }
   ```

   Par exemple

   ```
   { $.errorCode = "{{AccessDenied}}" }
   ```

1. Pour l'**espace de noms métrique**, entrez**AWS AppConfig**.

1. Pour **Metric name (Nom de métrique)**, saisissez **Errors**.

1. Pour **Valeur de la métrique**, saisissez **1**.

1. Pour **Valeur par défaut**, entrez un zéro (0).

1. Ignorez **l'unité**, **les dimensions** et les **alarmes**.

Après avoir CloudTrail enregistré les appels d'API, vous pouvez consulter les métriques dans CloudWatch. Pour plus d'informations, consultez la section [Affichage de vos statistiques et de vos journaux dans la console](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_View.html) dans le *guide de CloudWatch l'utilisateur Amazon*. Pour plus d'informations sur la façon de localiser une métrique que vous avez créée, voir [Rechercher les métriques disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/finding_metrics_with_cloudwatch.html).

**Note**  
Si vous configurez la métrique d'erreur sans dimension, comme décrit ici, vous pouvez consulter ces métriques sur la page **Mesures sans dimension**.

## Création d'une alarme pour une CloudWatch métrique
<a name="monitoring-data-plane-call-logging-alarms"></a>

Après avoir créé des métriques, vous pouvez créer des alarmes métriques dans CloudWatch. Par exemple, vous pouvez créer une alarme pour la métrique des *AWS AppConfig appels* que vous avez créée lors de la procédure précédente. Plus précisément, vous pouvez créer une alarme pour les appels à l'action d' AWS AppConfig `StartConfigurationSession`API qui dépassent un seuil. Pour plus d'informations sur la création d'une alarme pour une métrique, consultez la section [Création CloudWatch d'une alarme basée sur un seuil statique](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) dans le *guide de CloudWatch l'utilisateur Amazon*. Pour plus d'informations sur les limites par défaut pour les appels au plan de AWS AppConfig données, consultez la section [Limites par défaut du plan de données](https://docs.aws.amazon.com/general/latest/gr/appconfig.html#limits_appconfig) dans le *Référence générale d'Amazon Web Services*.