Pacotes do AWS Systems Manager (SSM) usados pelo CloudWatch Application Insights
Os pacotes listados nesta seção são usados pelo Application Insights e podem ser gerenciados e implantados de forma independente com o AWS Systems Manager Distributor. Para obter mais informações sobre o SSM Distributor, consulteAWS Systems Manager Distributor no Manual do usuário do AWS Systems Manager.
Pacotes:
AWSObservabilityExporter-JMXExporterInstallAndConfigure
É possível recuperar métricas Java específicas de workloads a partir do Prometheus JMX Exporter
Para usar o AWS Systems Manager Distributor para empacotar, instalar e configurar o pacote do Prometheus JMX Exporter fornecido pela AWS de modo independente do Application Insights, realize as etapas a seguir.
Pré-requisitos para usar o pacote SSM do Prometheus JMX Exporter
-
SSM Agent versão 2.3.1550.0 ou posterior instalado
-
A variável de ambiente JAVA_HOME está definida
Instalar e configurar o pacote AWSObservabilityExporter-JMXExporterInstallAndConfigure
O pacote AWSObservabilityExporter-JMXExporterInstallAndConfigure
é um pacote do SSM Distributor que você pode usar para instalar e configurar o Prometheus JMX Exporter
-
Com base em suas preferências, prepare o arquivo de configuração YAML do Prometheus JMX Exporter
localizado no repositório do Prometheus no GitHub. O exemplo de configuração e as descrições de opções podem ser usados para orientar você. -
Copie o arquivo de configuração YAML do Prometheus JMX Exporter codificado como Base64 para um novo parâmetro SSM em SSM Parameter Store
(Armazenamento de parâmetros do SSM). -
Navegue até o console do SSM Distributor
e abra a guia Owned by Amazon (Propriedade da Amazon). Selecione AWSObservabilityExporter-JMXExporterInstallAndConfigure e escolha Install one time (Instalar uma vez). -
Atualize o parâmetro do SSM criado na primeira etapa substituindo “Additional Arguments” (Argumentos adicionais) por:
{ "SSM_EXPORTER_CONFIGURATION": "{{ssm:
<SSM_PARAMETER_STORE_NAME>
}}", "SSM_EXPOSITION_PORT": "9404" }nota
A porta 9404 é a porta padrão usada para enviar métricas do Prometheus JMX. É possível atualizá-la.
Exemplo: configurar o atendente do CloudWatch para recuperar métricas do Java
-
Instale o JMX Exporter do Prometheus, conforme descrito no procedimento anterior. Em seguida, confira o status da porta para verificar que ele está instalado corretamente em sua instância.
Exemplo de instalação bem-sucedida na instância do Windows
PS C:\> curl http://localhost:9404 (http://localhost:9404/) StatusCode : 200 StatusDescription : OK Content : # HELP jvm_info JVM version info
Exemplo de instalação bem-sucedida na instância do 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
-
Crie o arquivo YAML de detecção de serviço do Prometheus. O exemplo de arquivo de detecção de serviço abaixo executa o seguinte:
-
Especifica a porta de host do Prometheus JMX Exporter como
localhost: 9404
. -
Anexa rótulos (
Application
,ComponentName
eInstanceId
) para as métricas, que podem ser definidas como dimensões métricas do 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
-
-
Crie o arquivo YAML de configuração do Prometheus JMX Exporter. O exemplo de arquivo de configuração a seguir especifica:
-
O intervalo de trabalho de recuperação de métricas e o período de tempo limite.
-
Os trabalhos de recuperação de métricas (
jmx
esap
), também conhecido como “scraping”, que incluem o nome do trabalho, o máximo de séries temporais retornadas por vez e o caminho do arquivo de detecção de serviço.
$ 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 se o atendente do CloudWatch está instalado em sua instância do Amazon EC2 e se a versão é 1.247346.1b249759 ou posterior. Para instalar o atendente do CloudWatch em sua instância do EC2, consulte Instalar o atendente do CloudWatch. Para verificar a versão, consulte Encontrar informações sobre versões do atendente do CloudWatch.
-
Configure o atendente do CloudWatch. Para obter mais informações sobre como configurar o arquivo de configuração do atendente do CloudWatch, consulte Criar ou editar manualmente o arquivo de configuração do atendente do CloudWatch. O exemplo do arquivo de configuração do atendente do CloudWatch abaixo executa o seguinte:
-
Especifica o caminho do arquivo de configuração do Prometheus JMX Exporter.
-
Especifica o grupo de logs de destino em que os logs de métrica do EMF serão publicados.
-
Especifica dois conjuntos de dimensões para cada nome da métrica.
-
Envia 8 métricas do CloudWatch (4 nomes da métricas * 2 conjuntos de dimensões por nome da 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
É possível recuperar métricas SAP HANA específicas de workloads a partir do exportador de banco de dados Prometheus HANA
Para usar o AWS Systems Manager Distributor para empacotar, instalar e configurar o pacote do exortador de banco de dados Prometheus HANA fornecido pela AWS de maneira independente do Application Insights, realize as etapas a seguir.
Pré-requisitos para usar o pacote SSM do exportador de banco de dados Prometheus HANA
-
SSM Agent versão 2.3.1550.0 ou posterior instalado
-
Banco de dados SAP HANA
-
Sistema operacional Linux (SUSE Linux, RedHat Linux)
-
Um segredo com credenciais de monitoramento de banco de dados SAP HANA usando AWS Secrets Manager. Crie um segredo no formato de pares chave-valor, especifique o nome de usuário da chave e insira o usuário do banco de dados para o valor. Adicione uma segunda senha da chave e, em seguida, digite a senha para o valor. Para obter mais informações sobre criação de segredos, consulte Criar um segredo no Guia do usuário do AWS Secrets Manager. O segredo deve ser formatado da seguinte forma:
{ "username": "
<database_user>
", "password": "<database_password>
" }
Instalar e configurar o pacote AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure
O pacote AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure
é um pacote do SSM Distributor que você pode usar para instalar e configurar o exportador de banco de dados HANA do Prometheus
-
Criar um parâmetro do SSM no Parameter Store do SSM
para armazenar as configurações do Exportador. Veja a seguir um exemplo do valor de parâmetro. {\"exposition_port\":9668,\"multi_tenant\":true,\"timeout\":600,\"hana\":{\"host\":\"localhost\",\"port\":30013,\"aws_secret_name\":\"HANA_DB_CREDS\",\"scale_out_mode\":true}}
nota
Neste exemplo, a exportação é executada somente na instância do Amazon EC2 com o banco de dados
SYSTEM
ativo. Ele permanecerá ocioso nas outras instâncias do EC2 para evitar métricas duplicadas. O exportador pode recuperar todas as informações do inquilino do banco de dados a partir do banco de dadosSYSTEM
. -
Criar um parâmetro do SSM no Parameter Store do SSM
para armazenar as consultas de métricas do exportador. O pacote pode aceitar mais de um parâmetro de métricas. Cada parâmetro deve ter um formato de objeto JSON válido. Veja a seguir um exemplo do valor de parâmetro. {\"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 obter mais informações sobre consultas de métricas, consulte o repositório
SUSE / hanadb_exporter
no GitHub. -
Navegue até o console do SSM Distributor
e abra a guia Owned by Amazon (Propriedade da Amazon). Selecione AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure* e escolha Install one time (Instalar uma vez). -
Atualize o parâmetro do SSM criado na primeira etapa substituindo “Additional Arguments” (Argumentos adicionais) por:
{ "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>}}" }
-
Selecione as instâncias do Amazon EC2 com banco de dados SAP HANA e escolha Run (Executar).
AWSObservabilityExporter-HAClusterExporterInstallAndConfigure
Você pode recuperar métricas de cluster de alta disponibilidade (HA) específicas de workloads do exportador de clusters HANA do Prometheus
Para usar o AWS Systems Manager Distributor para empacotar, instalar e configurar o pacote do exportador de cluster de HA do Prometheus fornecido pela AWS de modo independente do Application Insights, realize as etapas a seguir.
Pré-requisitos para usar o pacote SSM do Prometheus HA cluster exporter
-
SSM Agent versão 2.3.1550.0 ou posterior instalado
-
Cluster HA para Pacemaker, Corosync, SBD e DRBD
-
Sistema operacional Linux (SUSE Linux, RedHat Linux)
Instalar e configurar o pacote AWSObservabilityExporter-HAClusterExporterInstallAndConfigure
O pacote AWSObservabilityExporter-HAClusterExporterInstallAndConfigure
é um pacote do SSM Distributor que você pode usar para instalar e configurar o Prometheus HA Cluster Exporter. Quando as métricas de cluster são enviadas pelo exportador do banco de dados HANA do Prometheus, é possível configurar o atendente do CloudWatch para recuperar as métricas do serviço CloudWatch.
-
Criar um parâmetro do SSM no Parameter Store do SSM
para armazenar as configurações do exportador no formato JSON. Veja a seguir um exemplo do valor de parâmetro. {\"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 obter mais informações sobre a configuração do exportador, consulte o repositório
ClusterLabs / ha_cluster_exporter
no GitHub. -
Navegue até o console do SSM Distributor
e abra a guia Owned by Amazon (Propriedade da Amazon). Selecione AWSOBservabilityExporter-HaclusterExporterInstallAndConfigure* e escolha Install one time (Instalar uma vez). -
Atualize o parâmetro do SSM criado na primeira etapa substituindo “Additional Arguments” (Argumentos adicionais) por:
{ "SSM_EXPORTER_CONFIG": "{{ssm:<*SSM_CONFIGURATIONS_PARAMETER_STORE_NAME>*}}" }
-
Selecione as instâncias do Amazon EC2 com banco de dados SAP HANA e escolha Run (Executar).
AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure
Você pode recuperar, do exportador do Prometheus para host do SAP
Para usar o AWS Systems Manager Distributor para empacotar, instalar e configurar o pacote do exportador do host SAP independentemente do Application Insights, conclua as etapas a seguir.
Pré-requisitos para usar o pacote do SSM de exportador do host SAP Prometheus
-
SSM Agent versão 2.3.1550.0 ou posterior instalado
-
Servidores de aplicações do SAP NetWeaver
-
Sistema operacional Linux (SUSE Linux, RedHat Linux)
Instalar e configurar o pacote AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure
O pacote AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure
é um pacote do SSM Distributor que você pode usar para instalar e configurar o exportador de métricas Prometheus do SAP NetWeaver. Quando as métricas do SAP NetWeaver são enviadas pelo exportador do Prometheus, o agente do CloudWatch pode ser configurado para recuperar as métricas para o serviço CloudWatch.
-
Criar um parâmetro do SSM no Parameter Store do SSM
para armazenar as configurações do exportador no formato JSON. Veja a seguir um exemplo do valor de parâmetro. {\"address\":\"0.0.0.0\",\"port\":\"9680\",\"log-level\":\"info\",\"is-HA\":false}
endereço
O endereço de destino para o qual o Prometheus envia métricas. O valor padrão é
localhost
.port
A porta de destino para a qual enviar métricas do Prometheus. O valor padrão é
9680
.is-HA
true
para implantações de alta disponibilidade do SAP NetWeaver. Para todas as outras implantações, o valor éfalse
.
-
Navegue até o console do SSM Distributor
e abra a guia Owned by Amazon (Propriedade da Amazon). Selecione AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure e escolha Install one time (Instalar uma vez). -
Atualize o parâmetro do SSM criado na primeira etapa substituindo “Additional Arguments” (Argumentos adicionais) por:
{ "SSM_EXPORTER_CONFIG": "{{ssm:
<SSM_CONFIGURATIONS_PARAMETER_STORE_NAME>
}}", "SSM_SID": "<SAP_DATABASE_SID>
", "SSM_INSTANCES_NUM": "<instances_number seperated by comma>
" }Exemplo
{ "SSM_EXPORTER_CONFIG": "{{ssm:exporter_config_paramter}}", "SSM_INSTANCES_NUM": "11,12,10", "SSM_SID": "PR1" }
-
Selecione as instâncias do Amazon EC2 com aplicações do SAP NetWeaver e escolha Run (Executar).
nota
O exportador do Prometheus processa as métricas do SAP NetWeaver em um endpoint local. O endpoint local só pode ser acessado pelos usuários do sistema operacional na instância do Amazon EC2. Assim, após a instalação do pacote do exportador, as métricas ficam disponíveis para todos os usuários do sistema operacional. O endpoint local padrão é o localhost:9680/metrics
.
AWSObservabilityExporter-SQLExporterInstallAndConfigure
É possível recuperar métricas de SQL Server específicas de workloads a partir do Exportador do Prometheus SQL
Para usar o Distribuidor do AWS Systems Manager para empacotar, instalar e configurar o pacote do exportador do SQL independentemente do Application Insights, conclua as etapas a seguir.
Pré-requisitos para usar o pacote SSM do exportador do Prometheus SQL
-
SSM Agent versão 2.3.1550.0 ou posterior instalado
-
Instância do Amazon EC2 executando o SQL Server no Windows com a autenticação de usuário do SQL Server ativada.
-
Um usuário do SQL Server com as permissões a seguir:
GRANT VIEW ANY DEFINITION TO
GRANT VIEW SERVER STATE TO
-
Um segredo contendo a string de conexão do banco de dados usando AWS Secrets Manager. Para obter mais informações sobre criação de segredos, consulte Criar um segredo no Guia do usuário do AWS Secrets Manager. O segredo deve ser formatado da seguinte forma:
{ "data_source_name":"sqlserver://
<username>
:<password>
@localhost:1433" }nota
Se a senha ou o nome de usuário contiverem caracteres especiais, você deverá codificar com porcento os caracteres especiais para garantir uma conexão com êxito ao banco de dados.
Instalar e configurar o pacote AWSObservabilityExporter-SQLExporterInstallAndConfigure
O pacote AWSObservabilityExporter-SQLExporterInstallAndConfigure
é um pacote do SSM Distributor que pode ser usado para instalar e configurar o exportador de métricas SQL Prometheus. Quando as métricas são enviadas pelo exportador do Prometheus, é possível configurar o agente do CloudWatch para recuperar as métricas do serviço CloudWatch.
-
Com base nas suas preferências, prepare a configuração YAML do SQL Exporter. O exemplo de configuração a seguir tem uma única métrica configurada. Use a configuração de exemplo
para atualizar a configuração com métricas adicionais ou criar sua própria configuração. --- 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 o arquivo de configuração YAML do exportador do Prometheus SQL codificado como Base64 para um novo parâmetro SSM em Armazenamento de parâmetros do SSM
. -
Navegue até o console do SSM Distributor
e abra a guia Owned by Amazon (Propriedade da Amazon). Selecione AWSObservabilityExporter-SQLExporterInstallAndConfigure e escolha Instalar uma vez. -
Substitua os "Argumentos adicionais" pelas informações a seguir. O
SSM_PARAMETER_NAME
é o nome do parâmetro que foi criado na Etapa 2.{ "SSM_EXPORTER_CONFIGURATION": "{{ssm:
<SSM_PARAMETER_STORE_NAME>
}}", "SSM_PROMETHEUS_PORT": "9399
", "SSM_WORKLOAD_NAME": "SQL
" } -
Selecione a instância do Amazon EC2 com o banco de dados SQL Server e escolha executar.