Mesures de journalisation pour les appels du plan de AWS AppConfig données

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 avec une alarme.

Avant de commencer

Activez la journalisation des événements liés aux AWS AppConfig données dansAWS CloudTrail. La procédure suivante décrit comment activer la journalisation des métriques pour un suivi AWS AppConfigexistant dans CloudTrail. Pour plus d'informations sur la façon d'activer la CloudTrail journalisation des appels du forfait de AWS AppConfig données, consultezAWS AppConfigévénements de données dans CloudTrail.

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/.

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

3. Dans la section CloudWatch Journaux, choisissez Modifier.

4. Choisissez Enabled (Activé).

5. 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.

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

7. 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 etAmazon 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'adressehttps://console.aws.amazon.com/cloudwatch/.

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

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

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

5. Dans Nom du filtre, entrez un nom.

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

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

7. (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.

8. Choisissez Suivant.

9. Pour l'espace de noms métrique, entrezAWS AppConfig.

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

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

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

13. Dans Nom de la dimension, entrezoperation.

14. 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 dimensionresource. Pour Valeur de dimension, entrez$.resources[0].ARN.

    Choisissez Suivant.

15. 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.

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

   { $.errorCode = "codename" }

   Par exemple

   { $.errorCode = "AccessDenied" }

3. Pour l'espace de noms métrique, entrezAWS AppConfig.

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

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

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

7. 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 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.

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

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 AppConfigappels 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 AppConfigStartConfigurationSessionAPI 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 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 dans le Référence générale d'Amazon Web Services.