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 personnalisées et métriques étendues que vous pouvez envoyer à CloudWatch 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-metrics.html). Vous pouvez également configurer un moniteur d’application pour exporter des métriques. Le moniteur d’application peut envoyer des métriques étendues, des métriques personnalisées ou les deux. Il peut les envoyer à CloudWatch. + **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 à CloudWatch. + **Métriques étendues** — Vous pouvez 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. **Topics** + [Métriques personnalisées](#CloudWatch-RUM-custom-metrics) + [Métriques étendues](#CloudWatch-RUM-vended-metrics) ## Métriques personnalisées Pour envoyer des métriques personnalisées, vous devez utiliser le AWS APIs ou à la AWS CLI place de la console. Pour plus d'informations sur l'utilisation du AWS APIs, reportez-vous [PutRumMetricsDestination](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_PutRumMetricsDestination.html)aux sections et [BatchCreateRumMetricDefinitions](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_BatchCreateRumMetricDefinitions.html). 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. Vous n'êtes pas facturé pour les métriques personnalisées dérivées de tout type d'événements ou d'attributs du CloudWatch RUM. 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 envoyer n'importe laquelle des métriques CloudWatch RUM par défaut CloudWatch avec des dimensions supplémentaires afin que les métriques vous offrent une vue plus précise. Pour plus d'informations sur les métriques CloudWatch RUM par défaut, consultez[CloudWatch métriques que vous pouvez collecter avec CloudWatch RUM](CloudWatch-RUM-metrics.md). 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. 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 créées pour les métriques par défaut de CloudWatch RUM ne vous sont pas facturées. ### Métriques étendues des applications Web Les dimensions suivantes sont prises en charge pour les métriques étendues des applications Web : + `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` ### Métriques étendues des applications mobiles Les dimensions suivantes sont prises en charge pour les métriques étendues des applications mobiles : + `ScreenName` + Valeur issue de l'attribut de nom d'écran - `attributes.screen.name` de votre application + Exemples de valeurs : HomeScreen SettingsView, ProfilePage + `DeviceModel` + Valeur issue de l'attribut du modèle d'appareil - `resource.attributes.device.model.name` + Exemples de valeurs : iPhone14,3, SM-G998B + `OSVersion` + Valeur provenant de l'attribut de version du système d'exploitation - `resource.attributes.os.version` + Exemples de valeurs : 16,0, 13,0 **Note** Mesures par défaut actuellement prises en charge pour les applications mobiles : `ScreenLoadTime` `ScreenLoadCount``NetworkLatency`,`Http4xxCount`,`Http5xxCount`,`CrashCount`,`ANRCount`,`AppHangCount`,`ColdLaunchTime`,`WarmLaunchTime`,,`SessionCount`, `SpanPayloadSize` et`LogPayloadSize`. ### 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 plus d'informations sur l'utilisation du AWS APIs pour envoyer des métriques étendues à l'un ou l'autre CloudWatch, reportez-vous aux [PutRumMetricsDestination](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_PutRumMetricsDestination.html)sections et [BatchCreateRumMetricDefinitions](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_BatchCreateRumMetricDefinitions.html). **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/](https://console.aws.amazon.com/cloudwatch/). 1. Dans le volet de navigation, sélectionnez **Vigie applicative**, puis **RUM**. 1. Choisissez le nom du moniteur d'application qui doit envoyer les métriques. 1. Choisissez l'onglet **Configuration**, puis **RUM extended metrics** (Métriques étendues RUM). 1. Choisissez **Send metrics** (Envoyer les métriques). 1. Sélectionnez un ou plusieurs noms de métriques à envoyer avec des dimensions supplémentaires. 1. 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. 1. Pour envoyer une métrique avec l'ID de page comme dimension, choisissez **Rechercher l'ID de page**, puis sélectionnez la page IDs à utiliser. 1. 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). 1. 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). 1. Pour envoyer une métrique avec le type de navigateur comme dimension, sélectionnez un ou plusieurs navigateurs sous **Browsers** (Navigateurs). 1. 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. 1. Lorsque vous avez terminé vos choix, sélectionnez **Send metrics** (Envoyer les métriques). 1. (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](CloudWatch_Alarms.md). Pour un didacticiel sur le réglage d'une alarme sur une métrique étendue CloudWatch RUM, voir[Tutoriel : créer une métrique étendue et la déclencher](#CloudWatch-RUM-extended-metrics-alarmtutorial). **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/](https://console.aws.amazon.com/cloudwatch/). 1. Dans le volet de navigation, sélectionnez **Vigie applicative**, puis **RUM**. 1. Choisissez le nom du moniteur d'application qui doit envoyer les métriques. 1. Choisissez l'onglet **Configuration**, puis **RUM extended metrics** (Métriques étendues RUM). 1. 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/](https://console.aws.amazon.com/cloudwatch/). 1. Dans le volet de navigation, sélectionnez **Vigie applicative**, puis **RUM**. 1. Choisissez le nom du moniteur d'application qui doit envoyer la métrique. 1. Choisissez l'onglet **Configuration**, puis **RUM extended metrics** (Métriques étendues RUM). 1. Choisissez **Send metrics** (Envoyer les métriques). 1. Sélectionnez **JSErrorCompter**. 1. Sous **Browsers** (Navigateurs), sélectionnez **Chrome**. Cette combinaison de **JSErrorCount** 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 **JsErrorCount**et le nom de la dimension sera **Browser**. 1. Choisissez **Send metrics** (Envoyer les métriques). 1. Dans la liste des **métriques étendues**, choisissez **Créer une alarme** dans la ligne qui s'affiche **JsErrorCount**sous **Nom** et **Chrome** sous **BrowserName**. 1. Sous **Spécifier la métrique et les conditions**, vérifiez que le **nom de la métrique** et **BrowserName**les champs sont préremplis avec les valeurs correctes. 1. 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. 1. Pour **Période**, sélectionnez **5 minutes**. 1. 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. 1. (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 des alarmes](alarm-evaluation.md). 1. Choisissez **Suivant**. 1. 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. 1. Choisissez **Suivant**. 1. Saisissez un nom et une description facultative pour l'alarme, puis sélectionnez **Next** (Suivant). 1. Passez en revue les détails et sélectionnez **Create alarm** (Créer l'alarme).