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.
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 dans le Guide de l'utilisateur AWS Systems Manager.
Packages :
AWSObservabilityExporter-JMXExporterInstallAndConfigure
Vous pouvez récupérer des métriques Java spécifiques à une charge de travail à partir de Prometheus JMX Exporter
Pour utiliser AWS Systems Manager Distributor 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_HOME 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
-
En fonction de vos préférences, préparez le fichier de configuration YAML de l'exportateur JMX de Prometheus situé dans le
référentiel Prometheus. GitHub Utilisez l'exemple de descriptions de configuration et d'options pour vous guider. -
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
. -
Accédez à la console du Distributeur SSM
et ouvrez l'onglet Owned by Amazon (Propriété d'Amazon. Sélectionnez AWSObservabilityExporter-JMXExporterInstallAndConfigureet choisissez Installer une fois. -
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_PARAMETER_STORE_NAME>
}}", "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
-
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
-
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
,, etInstanceId
) 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
-
-
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
etsap
), 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"]
-
-
Vérifiez que l' CloudWatch agent est installé sur votre EC2 instance Amazon et que la version est 1.247346.1b249759 ou ultérieure. Pour installer l' CloudWatchagent sur votre EC2 instance, consultez la section Installation de l' CloudWatch agent. Pour vérifier la version, consultez la section Recherche d'informations sur les versions des CloudWatch agents.
-
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. 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 * 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
Pour utiliser AWS Systems Manager Distributor 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 dans le Guide de l'utilisateur AWS Secrets Manager . Le secret doit présenter le format suivant :
{ "username": "
<database_user>
", "password": "<database_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
-
Création d'un paramètre SSM dans le stockage de paramètres SSM
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' EC2 instance Amazon avec la
SYSTEM
base de données active, et elle restera inactive sur les autres EC2 instances afin d'éviter la duplication des métriques. L'exportateur peut extraire toutes les informations du locataire de la base de données à partir deSYSTEM
la base de données. -
Créer un paramètre SSM dans Stockage de paramètres SSM
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
SUSE / hanadb_exporter
dépôt sur GitHub. -
Accédez à la console du Distributeur SSM
et ouvrez l'onglet Owned by Amazon (Propriété d'Amazon. Sélectionnez AWSObservabilityExporter-SAP- HANADBExporter InstallAndConfigure * et choisissez Installer une fois. -
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": "<SAP_DATABASE_SID>", "SSM_EXPORTER_METRICS_1": "{{ssm:<SSM_FIRST_METRICS_PARAMETER_STORE_NAME>}}", "SSM_EXPORTER_METRICS_2": "{{ssm:<SSM_SECOND_METRICS_PARAMETER_STORE_NAME>}}" }
-
Sélectionnez les EC2 instances Amazon avec la base de données SAP HANA, puis choisissez Run.
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
Pour utiliser AWS Systems Manager Distributor 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
-
Créez un paramètre SSM dans le stockage de paramètres SSM
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
ClusterLabs / ha_cluster_exporter
dépôt sur GitHub. -
Accédez à la console du Distributeur SSM
et ouvrez l'onglet Owned by Amazon (Propriété d'Amazon. AWSObservabilityExporter-HAClusterExporterInstallAndConfigureSélectionnez*, puis choisissez Installer une fois. -
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>*}}" }
-
Sélectionnez les EC2 instances Amazon avec la base de données SAP HANA, puis choisissez Run.
AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure
Vous pouvez récupérer des métriques SAP spécifiques à la charge de travail NetWeaver depuis Prometheus SAP Host Exporter
Pour utiliser le Distributeur AWS Systems Manager 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
-
Créez un paramètre SSM dans le stockage de paramètres SSM
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 estfalse
.
-
Accédez à la console du Distributeur SSM
et ouvrez l'onglet Owned by Amazon (Propriété d'Amazon. Sélectionnez AWSObservabilityExporter-SAP- SAPHost ExporterInstallAndConfigure et choisissez Installer une fois. -
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": "<SAP_DATABASE_SID>
", "SSM_INSTANCES_NUM": "<instances_number seperated by comma>
" }Exemple
{ "SSM_EXPORTER_CONFIG": "{{ssm:exporter_config_paramter}}", "SSM_INSTANCES_NUM": "11,12,10", "SSM_SID": "PR1" }
-
Sélectionnez les EC2 instances Amazon 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. Le point de terminaison local n'est accessible qu'aux utilisateurs du système d'exploitation de l' EC2 instance Amazon. 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
Pour utiliser le Distributeur AWS Systems Manager 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
-
EC2 Instance Amazon 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 dans le Guide de l'utilisateur AWS Secrets Manager . Le secret doit présenter le format suivant :
{ "data_source_name":"sqlserver://
<username>
:<password>
@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
-
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
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: <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'
-
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
. -
Accédez à la console du Distributeur SSM
et ouvrez l'onglet Owned by Amazon (Propriété d'Amazon. Sélectionnez AWSObservabilityExporter-SQLExporterInstallAndConfigureet choisissez Installer une fois. -
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_PARAMETER_STORE_NAME>
}}", "SSM_PROMETHEUS_PORT": "9399
", "SSM_WORKLOAD_NAME": "SQL
" } -
Sélectionnez l' EC2 instance Amazon avec la base de données SQL Server, puis choisissez Exécuter.