Paquetes de Systems Manager (SSM) de AWS que Información de aplicaciones de CloudWatch utiliza
Información de aplicaciones utiliza los paquetes que se enumeran en esta sección y se pueden administrar e implementar de forma independiente con Distributor de AWS Systems Manager. Para obtener más información acerca de SSM Distributor, consulte AWS Systems Manager Distributor en la Guía del usuario de Systems Manager de AWS.
Paquetes:
AWSObservabilityExporter-JMXExporterInstallAndConfigure
Puede recuperar métricas Java específicas de la carga de trabajo desde Prometheus JMX exporter
Para utilizar Distributor de AWS Systems Manager para instalar y configurar el paquete JMX Exporter de Prometheus que proporciona AWS independientemente de Información de aplicaciones, siga los pasos que se describen a continuación.
Prerrequisitos para usar el paquete SSM del JMX Exporter de Prometheus
-
Debe contar con la versión 2.3.1550.0 de SSM Agent instalada o una posterior
-
La variable de entorno JAVA_HOME debe estar establecida
Instale y configure el paquete AWSObservabilityExporter-JMXExporterInstallAndConfigure
El paquete AWSObservabilityExporter-JMXExporterInstallAndConfigure
es un paquete de SSM Distributor que puede usar para instalar y configurar Prometheus JMX Exporter
-
En función de sus preferencias, prepare el Prometheus JMX Exporter YAML configuration file
(Archivo de configuración YAML del exportador JMX de Prometheus) ubicado en el repositorio Prometheus de GitHub. Utilice la configuración de ejemplo y las descripciones de opciones a modo de guía. -
Copie el archivo de configuración YAML del JMX Exporter de Prometheus codificado como Base64 a un nuevo parámetro SSM en el SSM Parameter Store
(Almacén de parámetros de SSM). -
Diríjase a la consola SSM Distributor
y abra la pestaña Owned by Amazon (Perteneciente a Amazon). Seleccione AWSObservabilityExporter-JMXExporterInstallAndConfigure y elija Install one time (Instalar una vez). -
Actualice el parámetro de SSM que creó en el primer paso mediante el reemplazo de ‘Argumentos adicionales’ por lo siguiente:
{ "SSM_EXPORTER_CONFIGURATION": "{{ssm:
<SSM_PARAMETER_STORE_NAME>
}}", "SSM_EXPOSITION_PORT": "9404" }nota
El puerto 9404 es el puerto predeterminado que se utiliza para enviar métricas de JMX de Prometheus. Puede actualizar este puerto.
Ejemplo: Configurar el agente de CloudWatch para recuperar métricas de Java
-
Instale JMX Exporter de Prometheus, como se describe en el procedimiento anterior. A continuación, verifique el estado del puerto para comprobar que se haya instalado correctamente en la instancia.
Ejemplo de instalación exitosa en la instancia de Windows
PS C:\> curl http://localhost:9404 (http://localhost:9404/) StatusCode : 200 StatusDescription : OK Content : # HELP jvm_info JVM version info
Ejemplo de instalación exitosa en la instancia de 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
-
Cree el archivo YAML de detección del servicio Prometheus. El siguiente ejemplo de archivo de detección de servicios realiza lo siguiente:
-
Especifica el puerto del host del JMX Exporter de Prometheus como
localhost: 9404
. -
Adjunta etiquetas (
Application
,ComponentName
, yInstanceId
) a las métricas, que se pueden establecer como dimensiones métricas de CloudWatch.
$ 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
-
-
Cree el archivo YAML de configuración del JMX Exporter de Prometheus. El siguiente ejemplo de archivo de configuración especifica lo siguiente:
-
El intervalo de trabajo de recuperación de métricas y el período de tiempo de espera.
-
Los trabajos de recuperación de métricas (
jmx
ysap
), también conocidos como “raspado”, que incluyen el nombre del trabajo, la serie temporal máxima devuelta a la vez y la ruta del archivo de detección de servicios.
$ 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"]
-
-
Verifique que el agente de CloudWatch esté instalado en la instancia de Amazon EC2 y que la versión sea 1.247346.1b249759 o una posterior. Para instalar el agente de CloudWatch en la instancia EC2, consulte Installing the CloudWatch Agent (Instalación del agente de CloudWatch). Para verificar la versión, consulte Finding information about CloudWatch agent versions (Búsqueda de información acerca de las versiones del agente CloudWatch).
-
Configure el agente de CloudWatch. Para obtener más información acerca de cómo se configurar el archivo de configuración del agente de CloudWatch, consulte Manually create or edit the CloudWatch agent configuration file (Crear o editar manualmente el archivo de configuración del agente de CloudWatch). En el siguiente ejemplo de archivo de configuración del agente de CloudWatch se realiza lo siguiente:
-
Se especifica la ruta del archivo de configuración del JMX Exporter de Prometheus.
-
Se especifica el grupo de registros de destino en el que se publicarán los registros de las métricas EMF.
-
Se especifican dos conjuntos de dimensiones para cada nombre de métrica.
-
Se envían 8 métricas de CloudWatch (4 nombres de métricas y 2 conjuntos de dimensiones por nombre de métrica).
{ "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
Puede recuperar métricas de SAP HANA específicas de la carga de trabajo desde el exportador de base de datos HANA de Prometheus
Para utilizar Distributor de AWS Systems Manager para armar, instalar y configurar el paquete exportador de base de datos HANA de Prometheus que proporciona AWS independientemente de Información de aplicaciones, siga los pasos que se describen a continuación.
Requisitos previos para usar el paquete SSM del exportador de base de datos HANA de Prometheus
-
Debe contar con la versión 2.3.1550.0 de SSM Agent instalada o una posterior
-
Base de datos SAP HANA
-
Sistema operativo Linux (SUSE Linux, RedHat Linux)
-
Un secreto con las credenciales de monitoreo de bases de datos SAP HANA, mediante AWS Secrets Manager. Cree un secreto mediante el formato de pares clave-valor, especifique el nombre de usuario clave e ingrese el usuario de la base de datos en el valor. Agregue una segunda contraseña clave y, a continuación, ingrese la contraseña para el valor. Para obtener más información acerca de la creación de secretos, consulte Crear un secreto en la Guía del usuario de AWS Secrets Manager. El secreto debe tener el siguiente formato:
{ "username": "
<database_user>
", "password": "<database_password>
" }
Instale y configure el paquete AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure
El paquete AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure
es un paquete de SSM Distributor que puede usar para instalar y configurar Prometheus HANA database Exporter
-
Cree un parámetro SSM en Almacén de parámetros SSM
para almacenar las configuraciones del exportador. A continuación se muestra un valor de parámetro de ejemplo. {\"exposition_port\":9668,\"multi_tenant\":true,\"timeout\":600,\"hana\":{\"host\":\"localhost\",\"port\":30013,\"aws_secret_name\":\"HANA_DB_CREDS\",\"scale_out_mode\":true}}
nota
En este ejemplo, la exportación se ejecuta solo en la instancia de Amazon EC2 con la base de datos del
SYSTEM
activo y permanece inactiva en las demás instancias de EC2 para evitar métricas duplicadas. El exportador puede recuperar toda la información del inquilino de la base de datos desde la base de datos delSYSTEM
. -
Cree un parámetro SSM en SSM Parameter Store
para almacenar las consultas de métricas del exportador. El paquete puede aceptar más de un parámetro de métrica. Cada parámetro debe tener un formato de objeto JSON válido. A continuación se muestra un valor parámetro de ejemplo: {\"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\"}]}}
Para obtener más información acerca de las consultas de métricas, consulte el repositorio de
SUSE / hanadb_exporter
en GitHub. -
Diríjase a la consola SSM Distributor
y abra la pestaña Owned by Amazon (Perteneciente a Amazon). Seleccione AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure* y elija Install one time (Instalar una vez). -
Actualice el parámetro de SSM que creó en el primer paso mediante el reemplazo de ‘Argumentos adicionales’ por lo siguiente:
{ "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>}}" }
-
Seleccione las instancias de Amazon EC2 con base de datos SAP HANA y luego elija Run (Ejecutar).
AWSObservabilityExporter-HAClusterExporterInstallAndConfigure
Puede recuperar métricas de clúster de alta disponibilidad (HA) específicas de la carga de trabajo desde el Exportador de clúster HANA de Prometheus
Para utilizar Distribuidor de AWS Systems Manager para armar, instalar y configurar el paquete exportador de clúster de alta disponibilidad de Prometheus que proporciona AWS independientemente de Información de aplicaciones, siga los pasos que se describen a continuación.
Requisitos previos para usar el paquete SSM del exportador de clúster de alta disponibilidad de Prometheus
-
Debe contar con la versión 2.3.1550.0 de SSM Agent instalada o una posterior
-
Clúster de alta disponibilidad para Pacemaker, Corosync, SBD y DRBD
-
Sistema operativo Linux (SUSE Linux, RedHat Linux)
Instale y configure el paquete AWSObservabilityExporter-HAClusterExporterInstallAndConfigure
El paquete AWSObservabilityExporter-HAClusterExporterInstallAndConfigure
es un paquete de SSM Distributor que puede usar para instalar y configurar el exportador de clúster de alta disponibilidad de Prometheus. Cuando el exportador de base de datos HANA de Prometheus envía métricas de clúster, el agente de CloudWatch se puede configurar para recuperar las métricas del servicio de CloudWatch.
-
Cree un parámetro SSM en SSM Parameter Store
para almacenar las configuraciones del exportador en formato JSON. A continuación se muestra un valor de parámetro de ejemplo. {\"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}
Para obtener más información acerca de las configuraciones del exportador, consulte el repositorio
ClusterLabs / ha_cluster_exporter
en GitHub. -
Diríjase a la consola SSM Distributor
y abra la pestaña Owned by Amazon (Perteneciente a Amazon). Seleccione AWSObservabilityExporter-HAClusterExporterInstallAndConfigure* y luego elija Install one time (Instalar una vez). -
Actualice el parámetro de SSM que creó en el primer paso mediante el reemplazo de ‘Argumentos adicionales’ por lo siguiente:
{ "SSM_EXPORTER_CONFIG": "{{ssm:<*SSM_CONFIGURATIONS_PARAMETER_STORE_NAME>*}}" }
-
Seleccione las instancias de Amazon EC2 con base de datos SAP HANA y luego elija Run (Ejecutar).
AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure
Puede recuperar métricas de SAP NetWeaver específicas de la carga de trabajo desde el exportador de host de Prometheus SAP
Si quiere utilizar el distribuidor de AWS Systems Manager para empaquetar, instalar y configurar el paquete del exportador de host de SAP independientemente de Información de aplicaciones, siga los pasos que se describen a continuación.
Requisitos previos para usar el paquete SSM del exportador de host de Prometheus SAP
-
Debe contar con la versión 2.3.1550.0 de SSM Agent instalada o una posterior
-
Servidores de aplicaciones de SAP NetWeaver
-
Sistema operativo Linux (SUSE Linux, RedHat Linux)
Instale y configure el paquete AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure
El paquete AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure
es un paquete del distribuidor de SSM que puede usar para instalar y configurar el exportador de métricas de Prometheus de SAP NetWeaver. Cuando el exportador de Prometheus envía métricas de SAP NetWeaver, el agente de CloudWatch se puede configurar para recuperar las métricas del servicio CloudWatch.
-
Cree un parámetro SSM en SSM Parameter Store
para almacenar las configuraciones del exportador en formato JSON. A continuación se muestra un valor de parámetro de ejemplo. {\"address\":\"0.0.0.0\",\"port\":\"9680\",\"log-level\":\"info\",\"is-HA\":false}
address
La dirección de destino a la que se enviarán las métricas de Prometheus. El valor predeterminado es
localhost
.puerto
El puerto de destino al que enviarán las métricas de Prometheus. El valor predeterminado es
9680
.is-HA
true
para implementaciones de alta disponibilidad de SAP NetWeaver. Para el resto de implementaciones, el valor esfalse
.
-
Diríjase a la consola SSM Distributor
y abra la pestaña Owned by Amazon (Perteneciente a Amazon). Seleccione AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure y elija Install one time (Instalar una vez). -
Actualice el parámetro de SSM que creó en el primer paso mediante el reemplazo de ‘Argumentos adicionales’ por lo siguiente:
{ "SSM_EXPORTER_CONFIG": "{{ssm:
<SSM_CONFIGURATIONS_PARAMETER_STORE_NAME>
}}", "SSM_SID": "<SAP_DATABASE_SID>
", "SSM_INSTANCES_NUM": "<instances_number seperated by comma>
" }Ejemplo
{ "SSM_EXPORTER_CONFIG": "{{ssm:exporter_config_paramter}}", "SSM_INSTANCES_NUM": "11,12,10", "SSM_SID": "PR1" }
-
Seleccione las instancias de Amazon EC2 con aplicaciones de SAP NetWeaver y luego elija Run (Ejecutar).
nota
El exportador de Prometheus administra las métricas de SAP NetWeaver en un punto de conexión local. Solo los usuarios del sistema operativo de la instancia Amazon EC2 pueden acceder al punto de conexión local. Por lo tanto, una vez instalado el paquete exportador, las métricas estarán disponibles para todos los usuarios del sistema operativo. El punto de conexión local predeterminado es localhost:9680/metrics
.
AWSObservabilityExporter-SQLExporterInstallAndConfigure
Puede recuperar métricas de SQL Server específicas de la carga de trabajo desde el SQL Exporter de Prometheus
Para utilizar Distribuidor de AWS Systems Manager para empaquetar, instalar y configurar el paquete exportador SQL independientemente de Información de aplicaciones, siga los pasos siguientes.
Prerrequisitos para usar el paquete SSM del SQL Exporter de Prometheus
-
Debe contar con la versión 2.3.1550.0 de SSM Agent instalada o una posterior
-
Instancia de Amazon EC2 que ejecuta SQL Server en Windows con la autenticación de usuarios de SQL Server habilitada.
-
Un usuario de SQL Server con los siguientes permisos:
GRANT VIEW ANY DEFINITION TO
GRANT VIEW SERVER STATE TO
-
Un secreto que contiene la cadena de conexión a la base de datos que utiliza AWS Secrets Manager. Para obtener más información acerca de la creación de secretos, consulte Crear un secreto en la Guía del usuario de AWS Secrets Manager. El secreto debe tener el siguiente formato:
{ "data_source_name":"sqlserver://
<username>
:<password>
@localhost:1433" }nota
Si la contraseña o el nombre de usuario contienen caracteres especiales, debe codificar los caracteres especiales en porcentaje para garantizar una conexión correcta a la base de datos.
Instale y configure el paquete AWSObservabilityExporter-SQLExporterInstallAndConfigure
El paquete AWSObservabilityExporter-SQLExporterInstallAndConfigure
es un paquete del distribuidor de SSM que puede usar para instalar y configurar el exportador de métricas de Prometheus de SQL NetWeaver. Cuando el exportador de Prometheus envía métricas, el agente de CloudWatch se puede configurar para recuperar las métricas del servicio CloudWatch.
-
En función de sus preferencias, prepare la configuración YAML de SQL Exporter. El siguiente ejemplo de configuración tiene configurada una única métrica. Utilice la configuración de ejemplo
para actualizar la configuración con métricas adicionales o crear su propia configuración. --- 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'
-
Copie el archivo de configuración YAML del SQL Exporter de Prometheus codificado como Base64 a un nuevo parámetro SSM en el Almacén de parámetros de SSM
. -
Diríjase a la consola SSM Distributor
y abra la pestaña Owned by Amazon (Perteneciente a Amazon). Seleccione AWSObservabilityExporter-SQLExporterInstallandConfigure y elija Instalar una vez. -
Sustituya los “Argumentos adicionales” por la siguiente información.
SSM_PARAMETER_NAME
es el nombre del parámetro que creó en el paso 2.{ "SSM_EXPORTER_CONFIGURATION": "{{ssm:
<SSM_PARAMETER_STORE_NAME>
}}", "SSM_PROMETHEUS_PORT": "9399
", "SSM_WORKLOAD_NAME": "SQL
" } -
Seleccione la instancia de Amazon EC2 con la base de datos de SQL Server y, a continuación, elija ejecutar.