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. # Activer les signaux CloudWatch d'application Utilisez les signaux d' CloudWatch application pour piloter automatiquement vos applications AWS afin de suivre les performances des applications par rapport à vos objectifs commerciaux. Application Signals vous fournit une vue unifiée et centrée sur les applications de vos applications Java, de leurs dépendances et de leurs limites. Pour de plus amples informations, veuillez consulter [Application Signals](CloudWatch-Application-Monitoring-Sections.md). CloudWatch Application Signals utilise l' CloudWatch agent pour recevoir des métriques et des traces de vos applications instrumentées automatiquement, appliquer éventuellement des règles pour réduire la cardinalité élevée, puis publier la télémétrie traitée sur. CloudWatch Vous pouvez fournir une configuration personnalisée à l' CloudWatch agent spécifiquement pour les signaux d'application à l'aide du fichier de configuration de l'agent. Pour commencer, la présence d'une `application_signals` section sous la `metrics_collected` section au sein de la `logs` section du fichier de configuration de l'agent indique que l' CloudWatch agent recevra des métriques de vos applications instrumentées automatiquement. De même, la présence d'une `application_signals` section sous la `traces_collected` section au sein de la `traces` section du fichier de configuration de l'agent indique que l' CloudWatch agent est activé pour recevoir des traces de vos applications instrumentées automatiquement. En outre, vous pouvez éventuellement transmettre des règles de configuration personnalisées afin de réduire la publication de télémétrie à cardinalité élevée, comme indiqué dans cette section. + Pour les clusters Amazon EKS, lorsque vous installez le module complémentaire [Amazon CloudWatch Observability](install-CloudWatch-Observability-EKS-addon.md) EKS, l' CloudWatch agent est activé par défaut pour recevoir à la fois des métriques et des traces de vos applications instrumentées automatiquement. Si vous souhaitez éventuellement transmettre des règles de configuration personnalisées, vous pouvez le faire en transmettant une configuration d’agent personnalisée au module complémentaire Amazon EKS lorsque vous le créez ou le mettez à jour en utilisant une configuration supplémentaire, comme indiqué dans [(Facultatif) Configuration supplémentaire](install-CloudWatch-Observability-EKS-addon.md#install-CloudWatch-Observability-EKS-addon-configuration). + Pour RedHat for OpenShift on AWS (ROSA), lorsque vous installez l'opérateur de l' CloudWatch agent à l'aide de diagrammes de référence, l' CloudWatch agent est activé par défaut pour recevoir à la fois des métriques et des traces de vos applications instrumentées automatiquement. Si vous souhaitez transmettre des règles de configuration personnalisées, vous pouvez le faire en fournissant une configuration personnalisée de l’agent via les Charts de Helm, comme décrit dans [(Facultatif) Configuration supplémentaire](install-CloudWatch-Observability-EKS-addon.md#install-CloudWatch-Observability-EKS-addon-configuration). + Pour les autres plateformes prises en charge, notamment Amazon EC2, vous devez démarrer l' CloudWatch agent avec une configuration d'agent qui active les signaux d'application en spécifiant les `application_signals` sections et éventuellement les règles de configuration personnalisées, comme indiqué plus loin dans cette section. Vous trouverez ci-dessous un aperçu des champs du fichier de configuration de l' CloudWatch agent liés aux signaux CloudWatch d'application. + `logs` + `metrics_collected`— Ce champ peut contenir des sections spécifiant que l'agent doit collecter des journaux afin de permettre des cas d'utilisation tels que CloudWatch Application Signals et Container Insights avec une meilleure observabilité pour Amazon EKS. **Note** Auparavant, cette section était également utilisée pour spécifier que l'agent doit collecter les journaux au format de métrique intégrée. Ces paramètres ne sont plus nécessaires. + `application_signals`(Facultatif) Spécifie que vous souhaitez permettre à CloudWatch Application Signals de recevoir des métriques de vos applications instrumentées automatiquement afin de faciliter les signaux d' CloudWatch application. + `rules` : (facultatif) un ensemble de règles permettant de sélectionner de manière conditionnelle des métriques et des suivis et d’appliquer des actions pour gérer les scénarios de cardinalité élevée. Chaque règle peut contenir les champs suivants : + `rule_name` : (facultatif) le nom de la règle. + `selectors` : (facultatif) un ensemble de métriques et d’analyseur de dimension de suivis. Chaque sélecteur doit fournir les champs suivants : + `dimension` : obligatoire si `selectors` n’est pas vide. Cela indique la dimension des métriques et des suivis à utiliser comme filtre. + `match` : obligatoire si `selectors` n’est pas vide. Un motif de caractères génériques utilisé pour faire correspondre les valeurs de la dimension spécifiée. + `action` : (facultatif) action à appliquer aux métriques et aux suivis correspondant aux sélecteurs spécifiés. La valeur de `action` doit être l’un des mots clés suivants : + `keep`Spécifie de n'envoyer que les métriques et les traces CloudWatch si elles correspondent au`selectors`. + `drop` : spécifie de supprimer la métrique et les suivis qui correspondent aux `selectors`. + `replace` : spécifie de remplacer les dimensions des métriques et des suivis correspondantes aux `selectors`. Ils sont remplacés conformément à la section `replacements`. + `replacements` Obligatoire si `action` a pour valeur `replace`. Un tableau de paires de dimensions / valeurs qui seront appliquées aux métriques et aux suivis qui correspondent aux `selectors` spécifiés lorsque `action` est `replace`. Chaque remplacement doit fournir les champs suivants : + `target_dimension` : obligatoire si `replacements` n’est pas vide. Spécifie la dimension à remplacer. + `value` : obligatoire si `replacements` n’est pas vide. La valeur par laquelle remplacer la valeur `target_dimension` d’origine. + `limiter`(Facultatif) Utilisez cette section pour limiter le nombre de mesures et de dimensions auxquelles Application Signals envoie CloudWatch, afin d'optimiser vos coûts. + `disabled` (Facultatif) Si `true`, la fonctionnalité de limitation des métriques est désactivée. La valeur par défaut est `false`. + `drop_threshold`(Facultatif) Le nombre maximum de métriques distinctes par service dans un intervalle de rotation qui peuvent être exportées par un CloudWatch agent. La valeur par défaut est 500. + `rotation_interval` (Facultatif) Intervalle auquel le limiteur réinitialise les enregistrements métriques pour le comptage des distinctions. Ceci est exprimé sous la forme d’une chaîne avec une séquence de nombres et un suffixe d’unité. Les fractions sont prises en charge. Les suffixes d'unités pris en charge sont `s``m`,`h`, `ms``us`, et. `ns` La valeur par défaut est `1h` pour une heure. + `log_dropped_metrics`(Facultatif) Spécifie si l'agent doit écrire des journaux dans les journaux de l' CloudWatch agent lorsque les métriques Application Signals sont supprimées. La valeur par défaut est `false`. **Note** Pour activer cette journalisation, le paramètre `debug` de la section `agent` doit également être défini sur `true`. + `traces` + `traces_collected` + `application_signals` : facultatif. Spécifiez-le pour permettre à l' CloudWatchagent de recevoir des traces de vos applications instrumentées automatiquement afin de faciliter les signaux CloudWatch d'application. **Note** Même si les règles personnalisées `application_signals` sont spécifiées dans la section `metrics_collected` contenue dans la section `logs`, elles s’appliquent également implicitement à la section `traces_collected`. Le même ensemble de règles s’appliquera à la fois aux métriques et aux suivis. Lorsqu’il existe plusieurs règles comportant des actions différentes, elles s’appliquent dans l’ordre suivant : `keep`, puis `drop`, puis `replace`. Voici un exemple de fichier de configuration d' CloudWatch agent complet qui applique des règles personnalisées. ``` { "logs": { "metrics_collected": { "application_signals": { "rules": [ { "rule_name": "keep01", "selectors": [ { "dimension": "Service", "match": "pet-clinic-frontend" }, { "dimension": "RemoteService", "match": "customers-service" } ], "action": "keep" }, { "rule_name": "drop01", "selectors": [ { "dimension": "Operation", "match": "GET /api/customer/owners/*" } ], "action": "drop" }, { "rule_name": "replace01", "selectors": [ { "dimension": "Operation", "match": "PUT /api/customer/owners/*/pets/*" }, { "dimension": "RemoteOperation", "match": "PUT /owners" } ], "replacements": [ { "target_dimension": "Operation", "value": "PUT /api/customer/owners/{ownerId}/pets{petId}" } ], "action": "replace" } ] } } }, "traces": { "traces_collected": { "application_signals": {} } } } ``` Dans l’exemple de fichier de configuration précédent, les `rules` sont traitées comme suit : 1. La règle `keep01` garantit que toute métrique et tout suivi dont la dimension `Service` est `pet-clinic-frontend` et la dimension `RemoteService` est `customers-service` sont conservées. 1. Pour les métriques et les suivis traités après application de `keep01`, la règle `drop01` garantit que les métriques et les suivis dont la dimension `Operation` est `GET /api/customer/owners/*` sont supprimées. 1. Pour les métriques et les suivis traités après application de `drop01`, la règle `replace01` met à jour les métriques et les suivis dont la dimension `Operation` est `PUT /api/customer/owners/*/pets/*` et la dimension `RemoteOperation` est `PUT /owners` telles que leur dimension `Operation` est désormais remplacée par la valeur `PUT /api/customer/owners/{ownerId}/pets{petId}`. Voici un exemple complet de fichier de CloudWatch configuration qui gère la cardinalité dans Application Signals en modifiant la limite des métriques à 100, en activant la journalisation des métriques supprimées et en fixant l'intervalle de rotation à deux heures. ``` { "logs": { "metrics_collected": { "application_signals": { "limiter": { "disabled": false, "drop_threshold": 100, "rotation_interval": "2h", "log_dropped_metrics": true } } }, "traces": { "traces_collected": { "application_signals": {} } } } } ```