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. # Comment fonctionne Amazon CloudWatch Application Insights CloudWatch Application Insights permet de surveiller les ressources de vos applications. Les informations suivantes décrivent le fonctionnement d’Application Insights. **Topics** + [Comment Application Insights surveille les applications](#appinsights-how-works-sub) + [Conservation des données](#appinsights-retention) + [Quotas](#appinsights-limits) + [AWS Packages Systems Manager (SSM) utilisés par CloudWatch Application Insights](appinsights-ssm-packages.md) + [AWS Documents Systems Manager (SSM) utilisés par CloudWatch Application Insights](appinsights-ssm-documents.md) ## Comment Application Insights surveille les applications Les informations suivantes décrivent comment Application Insights surveille les applications. **Détection et configuration d'applications** La première fois qu'une application est ajoutée à CloudWatch Application Insights, elle analyse les composants de l'application pour recommander des indicateurs clés, des journaux et d'autres sources de données à surveiller pour votre application. Vous pouvez ensuite configurer votre application en fonction de ces recommandations. **Prétraitement des données** CloudWatch Application Insights analyse en permanence les sources de données surveillées dans les ressources de l'application afin de détecter les anomalies métriques et de consigner les erreurs (observations). **Détection intelligente des problèmes** Le moteur CloudWatch Application Insights détecte les problèmes de votre application en corrélant les observations à l'aide d'algorithmes de classification et de règles intégrées. Pour faciliter le dépannage, il crée des CloudWatch tableaux de bord automatisés, qui incluent des informations contextuelles sur les problèmes. **Alerte et action** Lorsqu' CloudWatch Application Insights détecte un problème avec votre application, il génère CloudWatch des événements pour vous en informer. Pour plus d'informations sur la configuration de ces événements, consultez [CloudWatch Événements Application Insights pour les problèmes détectés](appinsights-cloudwatch-events.md). En outre, vous pouvez [configurer les notifications Amazon SNS](appinsights-problem-notifications.md) pour recevoir des alertes en cas de problèmes détectés. **Exemple de scénario** Vous avez une application .NET ASP basée sur une base de données SQL Server. Soudain, votre base de données commence à présenter un dysfonctionnement en raison d'une haute sollicitation de la mémoire. Cela conduit à la dégradation des performances de l'application et éventuellement à des erreurs HTTP 500 au niveau de vos serveurs web et de votre équilibreur de charge. Grâce à CloudWatch Application Insights et à ses analyses intelligentes, vous pouvez identifier la couche applicative à l'origine du problème en consultant le tableau de bord créé dynamiquement qui affiche les métriques associées et les extraits de fichier journal. Dans ce cas, le problème peut se situer sur la couche de base de données SQL. ## Conservation des données CloudWatch Application Insights conserve les problèmes pendant 55 jours et les observations pendant 60 jours. ## Quotas Pour connaître les quotas par défaut pour CloudWatch Application Insights, consultez la section [Points de terminaison et quotas Amazon CloudWatch Application Insights](https://docs.aws.amazon.com/general/latest/gr/applicationinsights.html). Sauf indication contraire, chaque quota est établi par AWS région. Veuillez contacter [Support AWS](https://console.aws.amazon.com/support/home#/case/create?issueType=technical) pour demander une augmentation du quota de votre service. De nombreux services contiennent des quotas qui ne peuvent pas être augmentés. Pour plus d'informations sur les quotas d'un service spécifique, consultez la documentation de ce service. # AWS Packages Systems Manager (SSM) utilisés par CloudWatch Application Insights Les packages répertoriés dans cette section sont utilisés par Application Insights et peuvent être gérés et déployés indépendamment avec AWS Systems Manager Distributor. Pour plus d'informations sur le distributeur SSM, consultez [AWS Distributeur Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) dans le *Guide de l'utilisateur AWS Systems Manager*. **Topics** + [`AWSObservabilityExporter-JMXExporterInstallAndConfigure`](#configure-java) + [`AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure`](#appinsights-ssm-sap-prometheus) + [`AWSObservabilityExporter-HAClusterExporterInstallAndConfigure`](#appinsights-ssm-sap-prometheus-ha) + [`AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure`](#appinsights-ssm-sap-host-exporter) + [`AWSObservabilityExporter-SQLExporterInstallAndConfigure`](#appinsights-ssm-sql-prometheus) ## `AWSObservabilityExporter-JMXExporterInstallAndConfigure` Vous pouvez récupérer des métriques Java spécifiques à une charge de travail à partir de [Prometheus JMX Exporter](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) pour Application Insights pour configurer et surveiller les alertes. Dans la console Application Insights, dans la page **Gérer la surveillance**, sélectionnez **Application JAVA** à partir du menu déroulant **Niveau Application**. Ensuite, sous **Configuration de l'exportateur JAVA Prometheus**, sélectionnez votre **Méthode de collecte** et votre **Numéro de port JMX**. Pour utiliser [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) pour empaqueter, installer et configurer le package d'exportation Prometheus JMX AWS fourni indépendamment d'Application Insights, procédez comme suit. **Conditions préalables à l'utilisation du package SSM de Prometheus JMX Exporter** + Agent SSM Agent version 2.3.1550.0 ou ultérieure installée + La variable d'environnement JAVA\$1HOME est définie **Installation et configuration du package `AWSObservabilityExporter-JMXExporterInstallAndConfigure`** Le package `AWSObservabilityExporter-JMXExporterInstallAndConfigure` est un package Distributeur SSM que vous pouvez utiliser pour installer et configurer [Prometheus JMX Exporter](https://github.com/prometheus/jmx_exporter). Lorsque des métriques Java sont envoyées par l'exportateur JMX Prometheus, CloudWatch l'agent peut être configuré pour récupérer les métriques du service. CloudWatch 1. En fonction de vos préférences, préparez le [fichier de configuration YAML de l'exportateur JMX de Prometheus situé dans le](https://github.com/prometheus/jmx_exporter#configuration) référentiel Prometheus. GitHub Utilisez l'exemple de descriptions de configuration et d'options pour vous guider. 1. Copiez le fichier de configuration YAML de Prometheus JMX Exporter codé en Base64 vers un nouveau paramètre SSM dans le [stockage de paramètres SSM](https://console.aws.amazon.com/systems-manager/parameters). 1. Accédez à la console du [Distributeur SSM](https://console.aws.amazon.com/systems-manager/distributor) et ouvrez l'onglet **Owned by Amazon (Propriété d'Amazon**. Sélectionnez **AWSObservabilityExporter-JMXExporterInstallAndConfigure**et choisissez **Installer une fois**. 1. Mettez à jour le paramètre SSM que vous avez créé dans la première étape en remplaçant « Arguments supplémentaires » par ce qui suit : ``` { "SSM_EXPORTER_CONFIGURATION": "{{ssm:}}", "SSM_EXPOSITION_PORT": "9404" } ``` **Note** Le port 9404 est le port par défaut utilisé pour envoyer des métriques Prometheus JMX. Vous pouvez mettre à jour ce port. **Exemple : configurer CloudWatch l'agent pour récupérer les métriques Java** 1. Installez le Prometheus JMX Exporter, comme décrit dans la procédure précédente. Vérifiez ensuite qu'il est correctement installé sur votre instance en vérifiant l'état du port. Exemple d'installation réussie sur une instance Windows ``` PS C:\> curl http://localhost:9404 (http://localhost:9404/) StatusCode : 200 StatusDescription : OK Content : # HELP jvm_info JVM version info ``` Exemple d'installation réussie sur une instance Linux ``` $ curl localhost:9404 # HELP jmx_config_reload_failure_total Number of times configuration have failed to be reloaded. # TYPE jmx_config_reload_failure_total counter jmx_config_reload_failure_total 0.0 ``` 1. Créez le fichier YAML de découverte de service Prometheus. L'exemple de fichier de découverte de service suivant effectue les opérations suivantes : + Spécifie le port hôte de Prometheus JMX Exporter comme `localhost: 9404`. + Attache des étiquettes (`Application``ComponentName`,, et`InstanceId`) aux métriques, qui peuvent être définies comme des dimensions CloudWatch métriques. ``` $ cat prometheus_sd_jmx.yaml - targets: - 127.0.0.1:9404 labels: Application: myApp ComponentName: arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/sampl-Appli-MMZW8E3GH4H2/aac36d7fea2a6e5b InstanceId: i-12345678901234567 ``` 1. Créez le fichier de configuration YAML de Prometheus JMX Exporter. L'exemple de fichier de configuration suivant spécifie les éléments suivants : + Intervalle de travail d'extraction des métriques et délai d'expiration. + Les travaux de récupération de métriques (`jmx` et `sap`), qui comprennent le nom de la tâche, la série chronologique maximale renvoyée à la fois et le chemin du fichier de découverte de service. ``` $ cat prometheus.yaml global: scrape_interval: 1m scrape_timeout: 10s scrape_configs: - job_name: jmx sample_limit: 10000 file_sd_configs: - files: ["/tmp/prometheus_sd_jmx.yaml"] - job_name: sap sample_limit: 10000 file_sd_configs: - files: ["/tmp/prometheus_sd_sap.yaml"] ``` 1. Vérifiez que l' CloudWatch agent est installé sur votre instance Amazon EC2 et que la version est 1.247346.1b249759 ou ultérieure. Pour installer l' CloudWatchagent sur votre instance EC2, consultez la section [Installation de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html). Pour vérifier la version, consultez la section [Recherche d'informations sur les versions des CloudWatch agents](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/troubleshooting-CloudWatch-Agent.html#CloudWatch-Agent-troubleshooting-agent-version). 1. Configurez l' CloudWatch agent. Pour plus d'informations sur la configuration du fichier de configuration de l' CloudWatch agent, voir [Création ou modification manuelle du fichier de configuration de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html). L'exemple de fichier de configuration d' CloudWatch agent suivant effectue les opérations suivantes : + Spécifie le chemin de fichier de configuration YAML de Prometheus JMX Exporter. + Spécifie le groupe de journaux cible dans lequel publier les journaux de mesures EMF. + Spécifie deux ensembles de dimensions pour chaque nom de métrique. + Envoie 8 métriques (4 noms de métriques \$1 2 ensembles de dimensions par nom de métrique) CloudWatch métriques. ``` { "logs":{ "logs_collected":{ .... }, "metrics_collected":{ "prometheus":{ "cluster_name":"prometheus-test-cluster", "log_group_name":"prometheus-test", "prometheus_config_path":"/tmp/prometheus.yaml", "emf_processor":{ "metric_declaration_dedup":true, "metric_namespace":"CWAgent", "metric_unit":{ "jvm_threads_current":"Count", "jvm_gc_collection_seconds_sum":"Second", "jvm_memory_bytes_used":"Bytes" }, "metric_declaration":[ { "source_labels":[ "job" ], "label_matcher":"^jmx$", "dimensions":[ [ "InstanceId", "ComponentName" ], [ "ComponentName" ] ], "metric_selectors":[ "^java_lang_threading_threadcount$", "^java_lang_memory_heapmemoryusage_used$", "^java_lang_memory_heapmemoryusage_committed$" ] } ] } } } }, "metrics":{ .... } } ``` ## `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure` Vous pouvez récupérer des métriques SAP HANA spécifiques à une charge de travail depuis [l'exportateur de base de données Prometheus HANA](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) pour Application Insights pour configurer et surveiller les alertes. Pour plus d’informations, consultez [Configurer votre base de données SAP HANA pour la surveillance](appinsights-tutorial-sap-hana.md#appinsights-tutorial-sap-hana-set-up) dans ce guide. Pour utiliser [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) pour empaqueter, installer et configurer le package d'exportation de base de données Prometheus HANA AWS fourni indépendamment d'Application Insights, procédez comme suit. **Conditions préalables à l'utilisation du package SSM d'exportateur de base de données Prometheus HANA** + Agent SSM Agent version 2.3.1550.0 ou version ultérieure installée + Base de données SAP HANA + Système d'exploitation Linux (SUSE Linux, RedHat Linux) + Un secret avec les informations d'identification de surveillance de base de données SAP HANA AWS Secrets Manager. Créez un secret en utilisant le format key/value par paires, spécifiez le nom d'utilisateur de la clé et entrez l'utilisateur de la base de données pour la valeur. Ajoutez un second mot de passe, puis pour Value (Valeur), saisissez le mot de passe. Pour plus d'informations sur la création de secrets, consultez la rubrique [Création d'un secret ](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) dans le *Guide de l'utilisateur AWS Secrets Manager *. Le secret doit présenter le format suivant : ``` { "username": "", "password": "" } ``` **Installation et configuration du package `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure`** Le package `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure` est un package Distributeur SSM que vous pouvez utiliser pour installer et configurer [l'exportateur de base de données Prometheus HANA](https://github.com/prometheus/jmx_exporter). Lorsque les métriques de base de données HANA sont envoyées par l'exportateur de base de données Prometheus HANA, CloudWatch l'agent peut être configuré pour récupérer les métriques du service. CloudWatch 1. Création d'un paramètre SSM dans [le stockage de paramètres SSM](https://console.aws.amazon.com/systems-manager/parameters) pour stocker les configurations de l'exportateur. Voici un exemple de valeur de paramètre. ``` {\"exposition_port\":9668,\"multi_tenant\":true,\"timeout\":600,\"hana\":{\"host\":\"localhost\",\"port\":30013,\"aws_secret_name\":\"HANA_DB_CREDS\",\"scale_out_mode\":true}} ``` **Note** Dans cet exemple, l'exportation s'exécute uniquement sur l'instance Amazon EC2 à l'aide de l'option active `SYSTEM` et elle restera inactive sur les autres instances EC2 afin d'éviter les doublons de métriques. L'exportateur peut extraire toutes les informations du locataire de la base de données à partir de `SYSTEM` la base de données. 1. Créer un paramètre SSM dans [Stockage de paramètres SSM](https://console.aws.amazon.com/systems-manager/parameters) pour stocker les requêtes de métriques de l'exportateur. Le package peut accepter plusieurs paramètres de métriques. Chaque paramètre doit avoir un format d'objet JSON valide. Voici un exemple de valeur de paramètre : ``` {\"SELECT MAX(TIMESTAMP) TIMESTAMP, HOST, MEASURED_ELEMENT_NAME CORE, SUM(MAP(CAPTION, 'User Time', TO_NUMBER(VALUE), 0)) USER_PCT, SUM(MAP(CAPTION, 'System Time', TO_NUMBER(VALUE), 0)) SYSTEM_PCT, SUM(MAP(CAPTION, 'Wait Time', TO_NUMBER(VALUE), 0)) WAITIO_PCT, SUM(MAP(CAPTION, 'Idle Time', 0, TO_NUMBER(VALUE))) BUSY_PCT, SUM(MAP(CAPTION, 'Idle Time', TO_NUMBER(VALUE), 0)) IDLE_PCT FROM sys.M_HOST_AGENT_METRICS WHERE MEASURED_ELEMENT_TYPE = 'Processor' GROUP BY HOST, MEASURED_ELEMENT_NAME;\":{\"enabled\":true,\"metrics\":[{\"name\":\"hanadb_cpu_user\",\"description\":\"Percentage of CPU time spent by HANA DB in user space, over the last minute (in seconds)\",\"labels\":[\"HOST\",\"CORE\"],\"value\":\"USER_PCT\",\"unit\":\"percent\",\"type\":\"gauge\"},{\"name\":\"hanadb_cpu_system\",\"description\":\"Percentage of CPU time spent by HANA DB in Kernel space, over the last minute (in seconds)\",\"labels\":[\"HOST\",\"CORE\"],\"value\":\"SYSTEM_PCT\",\"unit\":\"percent\",\"type\":\"gauge\"},{\"name\":\"hanadb_cpu_waitio\",\"description\":\"Percentage of CPU time spent by HANA DB in IO mode, over the last minute (in seconds)\",\"labels\":[\"HOST\",\"CORE\"],\"value\":\"WAITIO_PCT\",\"unit\":\"percent\",\"type\":\"gauge\"},{\"name\":\"hanadb_cpu_busy\",\"description\":\"Percentage of CPU time spent by HANA DB, over the last minute (in seconds)\",\"labels\":[\"HOST\",\"CORE\"],\"value\":\"BUSY_PCT\",\"unit\":\"percent\",\"type\":\"gauge\"},{\"name\":\"hanadb_cpu_idle\",\"description\":\"Percentage of CPU time not spent by HANA DB, over the last minute (in seconds)\",\"labels\":[\"HOST\",\"CORE\"],\"value\":\"IDLE_PCT\",\"unit\":\"percent\",\"type\":\"gauge\"}]}} ``` Pour plus d'informations sur les requêtes de métriques, consultez le [https://github.com/SUSE/hanadb_exporter/blob/master/metrics.json](https://github.com/SUSE/hanadb_exporter/blob/master/metrics.json)dépôt sur GitHub. 1. Accédez à la console du [Distributeur SSM](https://console.aws.amazon.com/systems-manager/distributor) et ouvrez l'onglet **Owned by Amazon (Propriété d'Amazon**. Sélectionnez **AWSObservabilityExporter-SAP- HANADBExporter InstallAndConfigure \$1** et choisissez **Installer une fois**. 1. Mettez à jour le paramètre SSM que vous avez créé dans la première étape en remplaçant « Arguments supplémentaires » par ce qui suit : ``` { "SSM_EXPORTER_CONFIG": "{{ssm:<*SSM_CONFIGURATIONS_PARAMETER_STORE_NAME>*}}", "SSM_SID": "", "SSM_EXPORTER_METRICS_1": "{{ssm:}}", "SSM_EXPORTER_METRICS_2": "{{ssm:}}" } ``` 1. Sélectionnez les instances Amazon EC2 avec base de données SAP HANA, puis sélectionnez **Run (Exécuter)**. ## `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure` Vous pouvez récupérer des métriques de cluster haute disponibilité (HA) spécifiques à la charge de travail à partir de [l'exportateur de cluster Prometheus HANA](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) pour Application Insights afin de configurer et de surveiller les alertes pour une configuration de haute disponibilité de base de données SAP HANA. Pour plus d’informations, consultez [Configurer votre base de données SAP HANA pour la surveillance](appinsights-tutorial-sap-hana.md#appinsights-tutorial-sap-hana-set-up) dans ce guide. Pour utiliser [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) pour empaqueter, installer et configurer le package d'exportation de clusters Prometheus HA AWS fourni indépendamment d'Application Insights, procédez comme suit. **Conditions préalables à l'utilisation du package SSM de l'exportateur de cluster Prometheus HA** + Agent SSM Agent version 2.3.1550.0 ou version ultérieure installée + Cluster HA pour Pacemaker, Corosync, SBD et DRBD + Système d'exploitation Linux (SUSE Linux, RedHat Linux) **Installation et configuration du package `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure`** Le package `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure` est un package de distributeur SSM que vous pouvez utiliser pour installer et configurer l'exportateur de cluster Prometheus HA. Lorsque les métriques du cluster sont envoyées par l'exportateur de base de données Prometheus HANA, CloudWatch l'agent peut être configuré pour récupérer les métriques du service. CloudWatch 1. Créez un paramètre SSM dans le [stockage de paramètres SSM](https://console.aws.amazon.com/systems-manager/parameters) pour stocker les configurations de l'exportateur au format JSON. Voici un exemple de valeur de paramètre. ``` {\"port\":\"9664\",\"address\":\"0.0.0.0\",\"log-level\":\"info\",\"crm-mon-path\":\"/usr/sbin/crm_mon\",\"cibadmin-path\":\"/usr/sbin/cibadmin\",\"corosync-cfgtoolpath-path\":\"/usr/sbin/corosync-cfgtool\",\"corosync-quorumtool-path\":\"/usr/sbin/corosync-quorumtool\",\"sbd-path\":\"/usr/sbin/sbd\",\"sbd-config-path\":\"/etc/sysconfig/sbd\",\"drbdsetup-path\":\"/sbin/drbdsetup\",\"enable-timestamps\":false} ``` Pour plus d'informations sur les configurations de l'exportateur, consultez le [https://github.com/ClusterLabs/ha_cluster_exporter/blob/master/ha_cluster_exporter.yaml](https://github.com/ClusterLabs/ha_cluster_exporter/blob/master/ha_cluster_exporter.yaml)dépôt sur GitHub. 1. Accédez à la console du [Distributeur SSM](https://console.aws.amazon.com/systems-manager/distributor) et ouvrez l'onglet **Owned by Amazon (Propriété d'Amazon**. **AWSObservabilityExporter-HAClusterExporterInstallAndConfigureSélectionnez\$1**, puis choisissez **Installer une fois**. 1. Mettez à jour le paramètre SSM que vous avez créé dans la première étape en remplaçant « Arguments supplémentaires » par ce qui suit : ``` { "SSM_EXPORTER_CONFIG": "{{ssm:<*SSM_CONFIGURATIONS_PARAMETER_STORE_NAME>*}}" } ``` 1. Sélectionnez les instances Amazon EC2 avec base de données SAP HANA, puis sélectionnez **Run (Exécuter)**. ## `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure` Vous pouvez récupérer des métriques SAP spécifiques à la charge de travail NetWeaver depuis [Prometheus SAP Host Exporter](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) for Application Insights afin de configurer et de surveiller les alarmes pour les déploiements SAP Distributed et High Availability. NetWeaver Pour utiliser le [Distributeur AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) pour packager, installer et configurer le package exportateur d'hôte SAP indépendamment d'Application Insights, effectuez les étapes suivantes. **Conditions préalables à l'utilisation du package SSM de l'exportateur d'hôte SAP de Prometheus** + Agent SSM Agent version 2.3.1550.0 ou version ultérieure installée + Serveurs NetWeaver d'applications SAP + Système d'exploitation Linux (SUSE Linux, RedHat Linux) **Installation et configuration du package `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure`** Le `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure` package est un package SSM Distributor que vous pouvez utiliser pour installer et configurer l'exportateur de métriques SAP NetWeaver Prometheus. Lorsque NetWeaver les métriques SAP sont envoyées par l'exportateur Prometheus, CloudWatch l'agent peut être configuré pour récupérer les métriques du service. CloudWatch 1. Créez un paramètre SSM dans le [stockage de paramètres SSM](https://console.aws.amazon.com/systems-manager/parameters) pour stocker les configurations de l'exportateur au format JSON. Voici un exemple de valeur de paramètre. ``` {\"address\":\"0.0.0.0\",\"port\":\"9680\",\"log-level\":\"info\",\"is-HA\":false} ``` + **address** L'adresse cible à laquelle envoyer les métriques Prometheus. La valeur par défaut est `localhost`. + **port** Le port cible vers lequel envoyer les métriques Prometheus. La valeur par défaut est `9680`. + **is-HA** `true`pour les déploiements SAP NetWeaver High Availability. Pour tous les autres déploiements, la valeur est `false`. 1. Accédez à la console du [Distributeur SSM](https://console.aws.amazon.com/systems-manager/distributor) et ouvrez l'onglet **Owned by Amazon (Propriété d'Amazon**. Sélectionnez **AWSObservabilityExporter-SAP- SAPHost ExporterInstallAndConfigure** et choisissez **Installer une fois**. 1. Mettez à jour le paramètre SSM que vous avez créé dans la première étape en remplaçant « Arguments supplémentaires » par ce qui suit : ``` { "SSM_EXPORTER_CONFIG": "{{ssm:}}", "SSM_SID": "", "SSM_INSTANCES_NUM": "" } ``` **Exemple** ``` { "SSM_EXPORTER_CONFIG": "{{ssm:exporter_config_paramter}}", "SSM_INSTANCES_NUM": "11,12,10", "SSM_SID": "PR1" } ``` 1. **Sélectionnez les instances Amazon EC2 avec les NetWeaver applications SAP, puis choisissez Exécuter.** **Note** L'exportateur Prometheus gère les métriques NetWeaver SAP sur un point de terminaison local. Seuls les utilisateurs du système d'exploitation de l'instance Amazon EC2 peuvent accéder au point de terminaison local. Par conséquent, après l'installation du package de l'exportateur, les métriques sont disponibles pour tous les utilisateurs du système d'exploitation. Le point de terminaison local par défaut est `localhost:9680/metrics`. ## `AWSObservabilityExporter-SQLExporterInstallAndConfigure` Vous pouvez récupérer des métriques SQL Server spécifiques à une charge de travail à partir de [Prometheus SQL Exporter](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) pour Application Insights pour surveiller des métriques clés. Pour utiliser le [Distributeur AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) pour packager, installer et configurer le package exportateur de SQL indépendamment d'Application Insights, effectuez les étapes suivantes. **Conditions préalables à l'utilisation du package SSM de Prometheus SQL Exporter** + Agent SSM Agent version 2.3.1550.0 ou version ultérieure installée + Instance Amazon EC2 exécutant SQL Server sous Windows avec authentification utilisateur SQL Server activée. + Un utilisateur de SQL Server disposant des autorisations suivantes : ``` GRANT VIEW ANY DEFINITION TO ``` ``` GRANT VIEW SERVER STATE TO ``` + Un secret contenant la chaîne de connexion à la base de données utilisant AWS Secrets Manager. Pour plus d'informations sur la création de secrets, consultez la rubrique [Création d'un secret ](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) dans le *Guide de l'utilisateur AWS Secrets Manager *. Le secret doit présenter le format suivant : ``` { "data_source_name":"sqlserver://:@localhost:1433" } ``` **Note** Si le mot de passe ou le nom d'utilisateur contient des caractères spéciaux, vous devez les encoder en pourcentage pour garantir une connexion réussie à la base de données. **Installation et configuration du package `AWSObservabilityExporter-SQLExporterInstallAndConfigure`** Le package `AWSObservabilityExporter-SQLExporterInstallAndConfigure` est un package Distributeur SSM que vous pouvez utiliser pour installer et configurer l'exportateur de métriques SQL Prometheus. Lorsque les métriques sont envoyées par l'exportateur Prometheus, CloudWatch l'agent peut être configuré pour récupérer les métriques du service. CloudWatch 1. En fonction de vos préférences, préparez la configuration YAML de SQL Exporter. L'exemple de configuration suivant comporte une seule métrique configurée. Utilisez l'[exemple de configuration](https://github.com/burningalchemist/sql_exporter/blob/master/examples/sql_exporter.yml) pour mettre à jour la configuration avec des métriques supplémentaires ou pour créer votre propre configuration. ``` --- global: scrape_timeout_offset: 500ms min_interval: 0s max_connections: 3 max_idle_connections: 3 target: aws_secret_name: collectors: - mssql_standard collectors: - collector_name: mssql_standard metrics: - metric_name: mssql_batch_requests type: counter help: 'Number of command batches received.' values: [cntr_value] query: | SELECT cntr_value FROM sys.dm_os_performance_counters WITH (NOLOCK) WHERE counter_name = 'Batch Requests/sec' ``` 1. Copiez le fichier de configuration YAML de Prometheus SQL Exporter codé en Base64 vers un nouveau paramètre SSM dans le [stockage de paramètres SSM](https://console.aws.amazon.com/systems-manager/parameters). 1. Accédez à la console du [Distributeur SSM](https://console.aws.amazon.com/systems-manager/distributor) et ouvrez l'onglet **Owned by Amazon (Propriété d'Amazon**. Sélectionnez **AWSObservabilityExporter-SQLExporterInstallAndConfigure**et choisissez **Installer une fois**. 1. Remplacez les « arguments supplémentaires » par les informations suivantes. `SSM_PARAMETER_NAME` est le nom du paramètre que vous avez créé à l'étape 2. ``` { "SSM_EXPORTER_CONFIGURATION": "{{ssm:}}", "SSM_PROMETHEUS_PORT": "9399", "SSM_WORKLOAD_NAME": "SQL" } ``` 1. Sélectionnez l'instance Amazon EC2 avec la base de données SQL Server, puis choisissez Exécuter. # AWS Documents Systems Manager (SSM) utilisés par CloudWatch Application Insights Application Insights utilise les documents SSM répertoriés dans cette section pour définir les actions qu’ AWS Systems Manager effectue sur vos instances gérées. Ces documents utilisent les fonctionnalités `Run Command` de Systems Manager pour automatiser les tâches nécessaires à la mise en œuvre des fonctionnalités de surveillance d’Application Insights. Les plannings d’exécution de ces documents sont gérés par Application Insights et ne peuvent pas être modifiés. Pour plus d’informations sur les documents SSM, veuillez consulter la rubrique [Documents AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/documents.html) dans le *Guide de l’utilisateur AWS Systems Manager *. ## Documents gérés par CloudWatch Application Insights Le tableau suivant répertorie les documents SSM gérés par Application Insights. | Nom du document | Description | Calendrier d’exécution | | --- | --- | --- | | `AWSEC2-DetectWorkload` | Détecte automatiquement les applications exécutées dans votre environnement d’application pouvant être configurées pour être surveillées par Application Insights. | Ce document est diffusé toutes les heures dans votre environnement d'application pour obtenir des informations détaillées sur up-to-date l'application. | | `AWSEC2-CheckPerformanceCounterSets` | Vérifie si les espaces de noms Performance Counter sont activés sur vos instances Windows Amazon EC2. | Ce document s’exécute toutes les heures dans votre environnement d’application et ne surveille les métriques de Performance Counter que si les espaces de noms correspondants sont activés. | | `AWSEC2-ApplicationInsightsCloudwatchAgentInstallAndConfigure` | Installe et configure l' CloudWatch agent en fonction de la configuration de surveillance des composants de votre application. | Ce document est exécuté toutes les 30 minutes pour garantir que la configuration de l' CloudWatch agent est toujours précise et up-to-date. Le document s’exécute également immédiatement après une modification apportée à votre configuration de surveillance des applications, telle que l’ajout ou la suppression de métriques ou la mise à jour des configurations des journaux. | ## Documents gérés par AWS Systems Manager Les documents suivants sont utilisés par CloudWatch Application Insights et gérés par Systems Manager. **`AWS-ConfigureAWSPackage`** Application Insights utilise ce document pour installer et désinstaller les packages de distribution Prometheus Exporter, pour collecter des métriques spécifiques à la charge de travail et pour permettre une surveillance complète des charges de travail sur les instances Amazon EC2 du client. CloudWatch Application Insights installe les packages de distribution Prometheus Exporter uniquement si la charge de travail cible corrélée est exécutée sur votre instance. Le tableau suivant répertorie les packages du distributeur Prometheus Exporter et les charges de travail cibles corrélées. | Nom du package du distributeur Prometheus Exporter | Charge de travail cible | | --- | --- | | `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure` | SAP HANA HA | | `AWSObservabilityExporter-JMXExporterInstallAndConfigure` | Java/JMX | | `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure` | SAP HANA | | `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure` | NetWeaver | | `AWSObservabilityExporter-SQLExporterInstallAndConfigure` | SQL Server (Windows) et SAP ASE (Linux) | **`AmazonCloudWatch-ManageAgent`** Application Insights utilise ce document pour gérer le statut et la configuration de l' CloudWatch agent sur vos instances et pour collecter des métriques internes au niveau du système et des journaux à partir des instances Amazon EC2 sur tous les systèmes d'exploitation.