Des métriques personnalisées et des métriques étendues que vous pouvez envoyer à CloudWatch et CloudWatch Evidently - Amazon CloudWatch
Métriques personnaliséesMétriques étendues

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.

Des métriques personnalisées et des métriques étendues que vous pouvez envoyer à CloudWatch et CloudWatch Evidently

Par défaut, les moniteurs de l'application RUM envoient des métriques à CloudWatch. Ces mesures et dimensions par défaut sont répertoriées dans CloudWatch les métriques que vous pouvez collecter avec CloudWatch RUM.

Vous pouvez également configurer un moniteur d'application pour exporter les métriques. Le moniteur de l'application peut envoyer des métriques étendues, des métriques personnalisées, ou les deux. Il peut les envoyer à CloudWatch ou à CloudWatch Eviently, ou aux deux.

  • Métriques personnalisées : les métriques personnalisées sont des métriques que vous définissez. Avec les métriques personnalisées, vous pouvez utiliser n'importe quel nom de métrique et n'importe quel espace de noms. Pour obtenir les métriques, vous pouvez utiliser des événements personnalisés, des événements intégrés, des attributs personnalisés ou des attributs par défaut.

    Vous pouvez envoyer des métriques personnalisées aux deux CloudWatch et à CloudWatch Evidently.

  • Métriques étendues : vous permet d'envoyer les métriques CloudWatch RUM par défaut à CloudWatch Evidently pour qu'elles soient utilisées dans les tests Evidently. Vous pouvez également envoyer n'importe laquelle des métriques CloudWatch RUM par défaut CloudWatch avec des dimensions supplémentaires. De cette façon, ces métriques peuvent donner une vue plus fine.

Métriques personnalisées

Pour envoyer des métriques personnalisées, vous devez utiliser les AWS API ou AWS CLI remplacer la console. Pour plus d'informations sur l'utilisation des AWS API, reportez-vous aux PutRumMetricsDestinationsections et BatchCreateRumMetricDefinitions.

Le nombre maximum de définitions de métriques étendues et de métriques personnalisées qu'une destination peut contenir est de 2 000. Pour chaque métrique personnalisée ou étendue que vous envoyez à chaque destination, chaque combinaison de nom de dimension et de valeur de dimension est prise en compte dans cette limite. Cela compte également comme une métrique CloudWatch personnalisée pour la tarification.

L'exemple suivant montre comment créer une métrique personnalisée dérivée d'un événement personnalisé. Voici l'exemple d'événement personnalisé utilisé :

cwr('recordEvent', {
    type: 'my_custom_event', 
    data: {
        location: 'IAD', 
        current_url: 'amazonaws.com', 
        user_interaction: {
            interaction_1 : "click",
            interaction_2 : "scroll"
        }, 
        visit_count:10
    }
})

Compte tenu de cet événement personnalisé, vous pouvez créer une métrique personnalisée qui compte le nombre de visites sur l'URL amazonaws.com depuis des navigateurs Chrome. La définition suivante crée une métrique nommée AmazonVisitsCount dans votre compte, dans l'espace de noms RUM/CustomMetrics/PageVisits.

{
    "AppMonitorName":"customer-appMonitor-name",
    "Destination":"CloudWatch",
    "MetricDefinitions":[
        {
            "Name":"AmazonVisitsCount",
            "Namespace":"PageVisit",
            "ValueKey":"event_details.visit_count",
            "UnitLabel":"Count",
            "DimensionKeys":{
                "event_details.current_url": "URL"
            },
            "EventPattern":"{\"metadata\":{\"browserName\":[\"Chrome\"]},\"event_type\":[\"my_custom_event\"],\"event_details\": {\"current_url\": [\"amazonaws.com\"]}}" 
        }
    ]
}

Métriques étendues

Si vous configurez des métriques étendues, vous pouvez faire l'une des deux choses suivantes ou les deux :

  • Envoyez les métriques CloudWatch RUM par défaut à CloudWatch Evidently pour qu'elles soient utilisées dans les expériences Evidently. Seuls les WebVitalsLargestContentfulPaintindicateurs PerformanceNavigationDurationPerformanceResourceDuration, WebVitalsCumulativeLayoutShift, WebVitalsFirstInputDelay, et peuvent être envoyés à Evidently.

  • Envoyez n'importe laquelle des métriques CloudWatch RUM par défaut à CloudWatch avec des dimensions supplémentaires afin qu'elles vous offrent une vue plus précise. Par exemple, vous pouvez voir les métriques spécifiques à un certain navigateur utilisé par vos utilisateurs, ou les métriques pour les utilisateurs dans une géolocalisation spécifique.

Pour plus d'informations sur les métriques CloudWatch RUM par défaut, consultezCloudWatch métriques que vous pouvez collecter avec CloudWatch RUM.

Le nombre maximum de définitions de métriques étendues et de métriques personnalisées qu'une destination peut contenir est de 2 000. Pour chaque métrique étendue ou personnalisée que vous envoyez à chaque destination, chaque combinaison de nom de dimension et de valeur de dimension compte comme une métrique étendue pour cette limite. Cela compte également comme une métrique CloudWatch personnalisée pour la tarification.

Lorsque vous envoyez des métriques étendues à CloudWatch, vous pouvez utiliser la console CloudWatch RUM pour créer des CloudWatch alarmes sur celles-ci.

Les métriques étendues sont facturées en tant que métriques CloudWatch personnalisées. Pour plus d’informations, consultez Tarification d’Amazon CloudWatch.

Les dimensions suivantes sont prises en charge pour les métriques étendues pour tous les noms de métriques que les moniteurs d'applications peuvent envoyer. Ces noms de métriques sont répertoriés dans CloudWatch métriques que vous pouvez collecter avec CloudWatch RUM.

  • BrowserName

    Exemples de valeurs de dimension : Chrome, Firefox, Chrome Headless

  • CountryCode Ceci utilise le format ISO-3166, avec des codes à deux lettres.

    Exemples de valeurs de dimension : US, JP, DE

  • DeviceType

    Exemples de valeurs de dimension : desktop, mobile, tablet, embedded

  • FileType

    Exemples de valeurs de dimension : Image, Stylesheet

  • OSName

    Exemples de valeurs de dimension : Linux, Windows, iOS, Android

  • PageId

Configuration des métriques étendues à l'aide de la console

Pour utiliser la console pour envoyer des métriques étendues à CloudWatch, procédez comme suit.

Pour envoyer des métriques étendues à CloudWatch Evidently, vous devez utiliser les AWS API ou AWS CLI remplacer la console. Pour plus d'informations sur l'utilisation des AWS API pour envoyer des métriques étendues à l'un ou à l'autre CloudWatch ou à Evidently, consultez PutRumMetricsDestinationet BatchCreateRumMetricDefinitions.

Pour utiliser la console pour configurer un moniteur d'applications et envoyer des métriques étendues RUM à CloudWatch

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

  2. Dans le volet de navigation, choisissez Application Signals, RUM.

  3. Choisissez List view (Vue en liste), puis le nom du moniteur d'application qui doit envoyer les métriques.

  4. Choisissez l'onglet Configuration, puis RUM extended metrics (Métriques étendues RUM).

  5. Choisissez Send metrics (Envoyer les métriques).

  6. Sélectionnez un ou plusieurs noms de métriques à envoyer avec des dimensions supplémentaires.

  7. Sélectionnez un ou plusieurs facteurs à utiliser comme dimensions pour ces métriques. Au fur et à mesure que vous faites vos choix, le nombre de métriques étendues que vos choix créent s'affiche dans Number of extended metrics (Nombre de métriques étendues).

    Ce nombre est calculé en multipliant le nombre de noms de métriques choisis par le nombre de dimensions différentes que vous créez. Ce nombre représente le nombre de métriques personnalisées qui vous sont facturées. Pour plus d'informations sur CloudWatch les tarifs, consultez Amazon CloudWatch Pricing.

    1. Pour envoyer une métrique avec l'ID de page comme dimension, choisissez Browse for page ID (Parcourir les ID de page), puis sélectionnez les ID de page à utiliser.

    2. Pour envoyer une métrique avec le type d'appareil comme dimension, choisissez soit Desktop devices (Appareils de bureau), soit Mobile and tablets (Mobiles et tablettes).

    3. Pour envoyer une métrique avec le système d'exploitation comme dimension, sélectionnez un ou plusieurs systèmes d'exploitation sous Operating system (Système d'exploitation).

    4. Pour envoyer une métrique avec le type de navigateur comme dimension, sélectionnez un ou plusieurs navigateurs sous Browsers (Navigateurs).

    5. Pour envoyer une métrique avec la géolocalisation comme dimension, sélectionnez un ou plusieurs emplacements sous Locations (Emplacements).

      Seuls les emplacements dans lesquels ce moniteur d'application a enregistré des métriques apparaîtront dans la liste de choix.

  8. Lorsque vous avez terminé vos choix, sélectionnez Send metrics (Envoyer les métriques).

  9. (Facultatif) Dans la liste Extended metrics (Métriques étendues), pour créer une alarme qui surveille l'une des métriques, choisissez Create alarm (Créer une alarme) dans la ligne de cette métrique.

    Pour des informations générales sur les CloudWatch alarmes, consultez Utilisation des CloudWatch alarmes Amazon. Pour un didacticiel sur le réglage d'une alarme sur une métrique étendue CloudWatch RUM, voirTutoriel : créer une métrique étendue et la déclencher.

Arrêt de l'envoi de métriques étendues

Pour utiliser la console pour arrêter l'envoi de métriques étendues

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

  2. Dans le volet de navigation, choisissez Application Signals, RUM.

  3. Choisissez List view (Vue en liste), puis le nom du moniteur d'application qui doit envoyer les métriques.

  4. Choisissez l'onglet Configuration, puis RUM extended metrics (Métriques étendues RUM).

  5. Sélectionnez une ou plusieurs combinaisons de noms et de dimensions de métriques à arrêter d'envoyer. Puis, choisissez Actions, Delete (Supprimer).

Tutoriel : créer une métrique étendue et la déclencher

Ce didacticiel explique comment configurer une métrique étendue à envoyer CloudWatch, puis comment définir une alarme sur cette métrique. Dans ce didacticiel, vous allez créer une métrique qui permet de suivre JavaScript les erreurs dans le navigateur Chrome.

Pour configurer cette métrique étendue et définir une alarme sur celle-ci

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

  2. Dans le volet de navigation, choisissez Application Signals, RUM.

  3. Choisissez List view (Vue en liste), puis le nom du moniteur d'application qui doit envoyer la métrique.

  4. Choisissez l'onglet Configuration, puis RUM extended metrics (Métriques étendues RUM).

  5. Choisissez Send metrics (Envoyer les métriques).

  6. Sélectionnez JS ErrorCount.

  7. Sous Browsers (Navigateurs), sélectionnez Chrome.

    Cette combinaison de JS ErrorCount et Chrome enverra une métrique étendue à CloudWatch. La métrique compte JavaScript les erreurs uniquement pour les sessions utilisateur utilisant le navigateur Chrome. Le nom de la métrique sera JsErrorCountet le nom de la dimension sera Browser.

  8. Choisissez Send metrics (Envoyer les métriques).

  9. Dans la liste des métriques étendues, choisissez Créer une alarme dans la ligne qui s'affiche JsErrorCountsous Nom et Chrome sous BrowserName.

  10. Sous Spécifier la métrique et les conditions, vérifiez que le nom de la métrique et BrowserNameles champs sont préremplis avec les valeurs correctes.

  11. Pour Statistic (Statistique), sélectionnez la statistique que vous voulez utiliser pour l'alarme. Average (Moyenne) est un bon choix pour ce type de métrique de comptage.

  12. Pour Période, sélectionnez 5 minutes.

  13. Sous Conditions, procédez comme suit :

    • Choisissez Static.

    • Choisissez Greater (Supérieur) pour spécifier que l'alarme doit passer à l'état ALARM lorsque le nombre d'erreurs est supérieur au seuil que vous allez spécifier.

    • Sous than... (à…), saisissez le nombre correspondant au seuil d'alarme. L'alarme passe à l'état ALARM lorsque le nombre d'erreurs sur une période de 5 minutes dépasse ce nombre.

  14. (Facultatif) Par défaut, l'alarme passe à l'état ALARM dès que le nombre d'erreurs dépasse le nombre seuil que vous avez défini pendant une période de 5 minutes. Vous pouvez, en option, modifier ce paramètre pour que l'alarme ne passe à l'état ALARM que si ce nombre est dépassé pendant plus d'une période de 5 minutes.

    Pour ce faire, sélectionnez Additional configuration (Configuration supplémentaire), puis pour Datapoints to alarm (Points de données à déclencher), indiquez le nombre de périodes de 5 minutes pendant lesquelles le nombre d'erreurs doit dépasser le seuil pour déclencher l'alarme. Par exemple, vous pouvez sélectionner 2 sur 2 pour que l'alarme se déclenche uniquement lorsque deux périodes de 5 minutes consécutives dépassent le seuil, ou 2 sur 3 pour que l'alarme se déclenche si deux des trois périodes de 5 minutes consécutives dépassent le seuil.

    Pour plus d'informations sur ce type d'évaluation d'alarme, consultez Évaluation d'une alerte.

  15. Choisissez Suivant.

  16. Pour Configure actions (Configurer les actions), indiquez ce qui doit se passer lorsque l'alarme passe à l'état d'alarme. Pour recevoir une notification avec Amazon SNS, procédez comme suit :

    • Sélectionnez Ajouter une notification.

    • Choisissez En alarme.

    • Sélectionnez une rubrique SNS existante ou créez-en une nouvelle. Si vous en créez un nouveau, indiquez-lui un nom et ajoutez-lui au moins une adresse e-mail.

  17. Choisissez Suivant.

  18. Saisissez un nom et une description facultative pour l'alarme, puis sélectionnez Next (Suivant).

  19. Passez en revue les détails et sélectionnez Create alarm (Créer l'alarme).