

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Come funziona Amazon CloudWatch Application Insights
<a name="appinsights-how-works"></a>

CloudWatch Application Insights fornisce il monitoraggio delle risorse delle applicazioni. Le seguenti informazioni descrivono come funziona Application Insights.

**Topics**
+ [Monitoraggio delle applicazioni di Application Insights](#appinsights-how-works-sub)
+ [Conservazione dei dati](#appinsights-retention)
+ [Quote](#appinsights-limits)
+ [AWS Pacchetti Systems Manager (SSM) utilizzati da CloudWatch Application Insights](appinsights-ssm-packages.md)
+ [AWS Documenti Systems Manager (SSM) utilizzati da CloudWatch Application Insights](appinsights-ssm-documents.md)

## Monitoraggio delle applicazioni di Application Insights
<a name="appinsights-how-works-sub"></a>

Le seguenti informazioni descrivono come Application Insights monitora le applicazioni.

**Individuazione e configurazione dell'applicazione**  
La prima volta che un'applicazione viene aggiunta ad CloudWatch Application Insights, analizza i componenti dell'applicazione per consigliare metriche chiave, log e altre fonti di dati da monitorare per l'applicazione. Puoi quindi configurare l'applicazione in base a questi suggerimenti. 

**Pre-elaborazione dei dati**  
CloudWatch Application Insights analizza continuamente le fonti di dati monitorate tra le risorse dell'applicazione per scoprire anomalie metriche ed errori di registro (osservazioni). 

**Rilevamento intelligente del problema**  
Il motore di CloudWatch Application Insights rileva i problemi nell'applicazione correlando le osservazioni utilizzando algoritmi di classificazione e regole integrate. Per facilitare la risoluzione dei problemi, crea CloudWatch dashboard automatici, che includono informazioni contestuali sui problemi. 

**Avviso e operazione**  
Quando CloudWatch Application Insights rileva un problema con l'applicazione, genera CloudWatch eventi per avvisare l'utente del problema. Per ulteriori informazioni su come configurare tali eventi, consulta [CloudWatch Eventi di Application Insights per i problemi rilevati](appinsights-cloudwatch-events.md). Inoltre, puoi [configurare le notifiche di Amazon SNS](appinsights-problem-notifications.md) per ricevere avvisi per i problemi rilevati.

**Scenario di esempio**

Hai a disposizione un'applicazione ASP .NET che è supportata da un database SQL Server. Improvvisamente, il database inizia a presentare anomalie di funzionamento a causa di elevata pressione di memoria. Questo porta a un degrado delle prestazioni dell'applicazione e possibili errori HTTP 500 nei server Web e nel load balancer.

Con CloudWatch Application Insights e la sua analisi intelligente, puoi identificare il livello applicativo che causa il problema controllando la dashboard creata dinamicamente che mostra le metriche correlate e i frammenti di file di registro. In questo caso, il problema potrebbe essere a livello di database SQL.

## Conservazione dei dati
<a name="appinsights-retention"></a>

CloudWatch Application Insights conserva i problemi per 55 giorni e le osservazioni per 60 giorni.

## Quote
<a name="appinsights-limits"></a>

Per le quote predefinite per CloudWatch Application Insights, consulta gli [endpoint e le quote di Amazon CloudWatch Application Insights](https://docs.aws.amazon.com/general/latest/gr/applicationinsights.html). Salvo diversa indicazione, ogni quota è per regione. AWS Contatta [AWS Support](https://console.aws.amazon.com/support/home#/case/create?issueType=technical) per richiedere un incremento della quota di servizio. Molti servizi contengono quote che non possono essere modificate. Per ulteriori informazioni sulle quote per un servizio specifico, consulta la documentazione relativa a tale servizio. 

# AWS Pacchetti Systems Manager (SSM) utilizzati da CloudWatch Application Insights
<a name="appinsights-ssm-packages"></a>

I pacchetti elencati in questa sezione vengono utilizzati da Application Insights e possono essere gestiti e distribuiti in modo indipendente con AWS Systems Manager Distributor. Per ulteriori informazioni su SSM Distributor, consulta [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) nella *Guida per l'utente di 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`
<a name="configure-java"></a>

È possibile recuperare i parametri Java specifici del carico di lavoro da [Prometheus JMX exporter](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) per Application Insights per configurare e monitorare gli allarmi. Nella console di Application Insights, nella scheda **Gestisci monitoraggio**, seleziona **Applicazione JAVA** dal menu a discesa **Livello applicazione**. Quindi in **Configurazione di JAVA Prometheus Exporter**, seleziona il **Metodo di raccolta** e il **Numero porta JMX**. 

Per utilizzare [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) per impacchettare, installare e configurare il pacchetto di esportazione AWS Prometheus JMX fornito indipendentemente da Application Insights, completare i seguenti passaggi.

**Prerequisiti per l'utilizzo del pacchetto SSM Prometheus JMX Exporter**
+ Versione SSM Agent 2.3.1550.0 o successiva installata
+ La variabile di ambiente JAVA\$1HOME è impostata

**Installazione e configurazione del paccetto `AWSObservabilityExporter-JMXExporterInstallAndConfigure`**  
l pacchetto `AWSObservabilityExporter-JMXExporterInstallAndConfigure` è un pacchetto Distributor SSM che è possibile utilizzare per installare e configurare [Prometheus JMX Exporter](https://github.com/prometheus/jmx_exporter). Quando le metriche Java vengono inviate dall'esportatore Prometheus JMX, l'agente può essere configurato per recuperare le metriche per CloudWatch il servizio. CloudWatch 

1. In base alle preferenze, prepara il file di configurazione [YAML dell'esportatore Prometheus JMX](https://github.com/prometheus/jmx_exporter#configuration) che si trova nell'archivio Prometheus. GitHub Utilizzare le descrizioni di configurazione e opzioni di esempio come guida.

1. Copia il file di configurazione YAML di Prometheus JMX Exporter codificato come Base64 in un nuovo parametro SSM nell'[Archivio parametri SSM](https://console.aws.amazon.com/systems-manager/parameters).

1. Passare alla console [SSM Distributor](https://console.aws.amazon.com/systems-manager/distributor) e aprire la scheda **Proprietà di Amazon**. **Seleziona e** scegli Installa una sola volta. **AWSObservabilityExporter-JMXExporterInstallAndConfigure**

1. Aggiorna il parametro SSM creato nel primo passaggio sostituendo "Argomenti aggiuntivi" con quanto segue:

   ```
   {
     "SSM_EXPORTER_CONFIGURATION": "{{ssm:<SSM_PARAMETER_STORE_NAME>}}",
     "SSM_EXPOSITION_PORT": "9404"
   }
   ```
**Nota**  
La porta 9404 è la porta predefinita utilizzata per inviare i parametri Prometheus JMX. È possibile aggiornare questa porta.

**Esempio: configura CloudWatch l'agente per recuperare le metriche Java**

1. Installare il JMX exporter di Prometheus, come descritto nella procedura precedente. Verificare quindi che sia installato correttamente sull'istanza controllando lo stato della porta.

   Esempio di installazione riuscita sull'istanza di Windows

   ```
   PS C:\> curl http://localhost:9404 (http://localhost:9404/)
   StatusCode : 200
   StatusDescription : OK
   Content : # HELP jvm_info JVM version info
   ```

   Esempio di installazione riuscita sull'istanza di 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. Crea il file YAML di individuazione del servizio Prometheus. Il file di individuazione del servizio di esempio esegue queste operazioni:
   + Specifica la porta host di Prometheus JMX Exporter come `localhost: 9404`.
   + Allega etichette (`Application``ComponentName`, e`InstanceId`) alle metriche, che possono essere impostate come dimensioni metriche. 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
   ```

1. Crea il file YAML di configurazione di Prometheus JMX Exporter. Il file di configurazione di esempio specifica quanto segue:
   + L'intervallo del processo di recupero dei parametri e periodo di timeout.
   + I processi di recupero dei parametri (noto anche come “scraping”) (`jmx` e `sap`), che includono il nome del processo, la serie temporale massima restituita alla volta e il percorso del file di individuazione del servizio. 

   ```
   $ 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. Verifica che l' CloudWatch agente sia installato sulla tua istanza Amazon EC2 e che la versione sia 1.247346.1b249759 o successiva. [Per installare l'agente sulla tua istanza EC2, consulta Installazione CloudWatch dell'agente. CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html) Per verificare la versione, consulta [Ricerca di informazioni sulle versioni degli CloudWatch agenti](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/troubleshooting-CloudWatch-Agent.html#CloudWatch-Agent-troubleshooting-agent-version).

1. Configura l' CloudWatch agente. Per ulteriori informazioni su come configurare il file di configurazione dell' CloudWatch agente, vedere [Creare o modificare manualmente il file di configurazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html). Il seguente file di configurazione CloudWatch dell'agente di esempio esegue le seguenti operazioni:
   + Specifica il percorso del file di configurazione di Prometheus JMX Exporter.
   + Specifica il gruppo di log di destinazione in cui pubblicare i log dei parametri EMF.
   + Specifica due set di dimensioni per ogni nome del parametro.
   + Invia 8 metriche (4 nomi di metriche \$1 2 set di dimensioni per nome metrico) CloudWatch .

   ```
   {
      "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`
<a name="appinsights-ssm-sap-prometheus"></a>

È possibile recuperare i parametri Java specifici del carico di lavoro da [Prometheus HANA database exporter](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) per Application Insights per configurare e monitorare gli allarmi. Per ulteriori informazioni sul tagging, consulta [Configurare il database SAP HANA per il monitoraggio](appinsights-tutorial-sap-hana.md#appinsights-tutorial-sap-hana-set-up)in questa guida.

Per utilizzare [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) per impacchettare, installare e configurare il pacchetto di esportazione del database AWS Prometheus HANA fornito indipendentemente da Application Insights, completare i seguenti passaggi.

**Prerequisiti per l'utilizzo del pacchetto database exporter di Prometheus HANA**
+ Versione SSM Agent 2.3.1550.0 o successiva installata
+ Database SAP HANA
+ Sistema operativo Linux (SUSE Linux, Linux) RedHat 
+ Un segreto con le credenziali di monitoraggio del database SAP HANA, utilizzando Gestione dei segreti AWS. Crea un segreto utilizzando il formato delle key/value coppie, specifica il nome utente della chiave e inserisci l'utente del database per il valore. Aggiungere unA seconda password chiave , e quindi per Valore inserire la password. Per ulteriori informazioni sulla creazione dei segreti, consulta [Creazione di un segreto](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) nella *Guida per l'utente di Gestione dei segreti AWS *. Il segreto deve essere formattato come segue:

  ```
  {
    "username": "<database_user>",
    "password": "<database_password>"
  }
  ```

**Installazione e configurazione del paccetto `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure`**  
l pacchetto `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure` è un pacchetto Distributor SSM che è possibile utilizzare per installare e configurare [database Exporter di Prometheus HANA](https://github.com/prometheus/jmx_exporter). Quando le metriche del database HANA vengono inviate dall'esportatore del database Prometheus HANA, l' CloudWatch agente può essere configurato per recuperare le metriche per il servizio. CloudWatch 

1. Crea un parametro SSM in [Archivio parametri SSM](https://console.aws.amazon.com/systems-manager/parameters) per memorizzare le configurazioni Exporter. Di seguito è riportato un esempio del valore del parametro.

   ```
   {\"exposition_port\":9668,\"multi_tenant\":true,\"timeout\":600,\"hana\":{\"host\":\"localhost\",\"port\":30013,\"aws_secret_name\":\"HANA_DB_CREDS\",\"scale_out_mode\":true}}
   ```
**Nota**  
In questo esempio, l'esportazione viene eseguita solo sull'istanza Amazon EC2 con il database `SYSTEM` attivo e rimarrà inattivo sulle altre istanze EC2 al fine di evitare parametri duplicati. L'esportatore può recuperare tutte le informazioni relative al tenant del database dal database `SYSTEM`.

1. Crea un parametro SSM in [Archivio parametri SSM](https://console.aws.amazon.com/systems-manager/parameters) per memorizzare le query sui parametri di Exporter. Il pacchetto può accettare più di un parametro di metrica. Ciascun parametro deve avere un formato oggetto JSON valido. Il seguente è un esempio di valore del parametro:

   ```
   {\"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\"}]}}
   ```

   Per ulteriori informazioni sulle interrogazioni relative alle metriche, consulta il repository su. [https://github.com/SUSE/hanadb_exporter/blob/master/metrics.json](https://github.com/SUSE/hanadb_exporter/blob/master/metrics.json) GitHub

1. Passare alla console [SSM Distributor](https://console.aws.amazon.com/systems-manager/distributor) e aprire la scheda **Proprietà di Amazon**. Seleziona **AWSObservabilityExporter-SAP- HANADBExporter InstallAndConfigure \$1** e scegli **Installa** una sola volta.

1. Aggiorna il parametro SSM creato nel primo passaggio sostituendo "Argomenti aggiuntivi" con quanto segue:

   ```
   {
     "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>}}"
   }
   ```

1. Seleziona le istanze Amazon EC2 con il database SAP HANA e scegli **Esegui**.

## `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure`
<a name="appinsights-ssm-sap-prometheus-ha"></a>

È possibile recuperare i parametri del cluster High Availability (HA) specifiche del carico di lavoro da [Esportatore di cluster Prometheus HANA](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) per Application Insights per configurare e monitorare gli allarmi per una configurazione High Availability del database SAP HANA. Per ulteriori informazioni sul tagging, consulta [Configurare il database SAP HANA per il monitoraggio](appinsights-tutorial-sap-hana.md#appinsights-tutorial-sap-hana-set-up)in questa guida.

Per utilizzare [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) per impacchettare, installare e configurare il pacchetto AWS di esportazione cluster Prometheus HA fornito indipendentemente da Application Insights, completare i seguenti passaggi.

**Prerequisiti per l'utilizzo del cluster SSM Prometheus HA exporter**
+ Versione SSM Agent 2.3.1550.0 o successiva installata
+ Cluster HA per Pacemaker, Corosync, SBD e DRBD
+ Sistema operativo Linux (SUSE Linux, Linux) RedHat 

**Installazione e configurazione del paccetto `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure`**  
l pacchetto `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure` è un pacchetto di distribuzione SSM che è possibile utilizzare per installare e configurare Prometheus HA cluster Exporter. Quando le metriche del cluster vengono inviate dall'esportatore del database Prometheus HANA, l'agente può essere configurato per recuperare le metriche per CloudWatch il servizio. CloudWatch 

1. Crea un parametro SSM in [Archivio parametri SSM](https://console.aws.amazon.com/systems-manager/parameters) per archiviare le configurazioni Exporter in formato JSON. Di seguito è riportato un esempio del valore del parametro.

   ```
   {\"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}
   ```

   Per ulteriori informazioni sulle configurazioni degli esportatori, consulta il repository su. [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) GitHub

1. Passare alla console [SSM Distributor](https://console.aws.amazon.com/systems-manager/distributor) e aprire la scheda **Proprietà di Amazon**. **AWSObservabilityExporter-HAClusterExporterInstallAndConfigureSeleziona\$1** e scegli **Installa una sola volta**.

1. Aggiorna il parametro SSM creato nel primo passaggio sostituendo "Argomenti aggiuntivi" con quanto segue:

   ```
   {
     "SSM_EXPORTER_CONFIG": "{{ssm:<*SSM_CONFIGURATIONS_PARAMETER_STORE_NAME>*}}"
   }
   ```

1. Seleziona le istanze Amazon EC2 con il database SAP HANA e scegli **Esegui**.

## `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure`
<a name="appinsights-ssm-sap-host-exporter"></a>

Puoi recuperare metriche SAP specifiche del carico di lavoro NetWeaver da Prometheus SAP [host exporter for Application Insights per configurare e monitorare gli allarmi per le implementazioni SAP Distributed](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) e High Availability. NetWeaver 

Per utilizzare [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) per comprimere, installare e configurare il pacchetto dell'esportatore host di SAP indipendentemente da Approfondimenti sulle applicazioni, procedi come segue.

**Prerequisiti per l'utilizzo del pacchetto SSM per l'esportatore host di Prometheus SAP**
+ Versione SSM Agent 2.3.1550.0 o successiva installata
+ Server di applicazioni SAP NetWeaver 
+ Sistema operativo Linux (SUSE Linux, RedHat Linux)

**Installazione e configurazione del paccetto `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure`**  
Il `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure` pacchetto è un pacchetto SSM Distributor che puoi utilizzare per installare e configurare l'esportatore di metriche SAP NetWeaver Prometheus. Quando le NetWeaver metriche SAP vengono inviate dall'esportatore Prometheus, l' CloudWatch agente può essere configurato per recuperare le metriche per il servizio. CloudWatch 

1. Crea un parametro SSM in [Archivio parametri SSM](https://console.aws.amazon.com/systems-manager/parameters) per archiviare le configurazioni Exporter in formato JSON. Di seguito è riportato un esempio del valore del parametro.

   ```
   {\"address\":\"0.0.0.0\",\"port\":\"9680\",\"log-level\":\"info\",\"is-HA\":false}
   ```
   + **address**

     L'indirizzo di destinazione a cui inviare i parametri di Prometheus. Il valore predefinito è `localhost`.
   + **port**

     La porta di destinazione a cui inviare i parametri di Prometheus. Il valore predefinito è `9680`.
   + **is-HA**

     `true` NetWeaver per implementazioni SAP High Availability. Per tutte le altre implementazioni il valore è `false`.

1. Passare alla console [SSM Distributor](https://console.aws.amazon.com/systems-manager/distributor) e aprire la scheda **Proprietà di Amazon**. **Seleziona AWSObservabilityExporter-SAP SAPHost ExporterInstallAndConfigure e scegli **Installa** una sola volta.**

1. Aggiorna il parametro SSM creato nel primo passaggio sostituendo "Argomenti aggiuntivi" con quanto segue:

   ```
   {
     "SSM_EXPORTER_CONFIG": "{{ssm:<SSM_CONFIGURATIONS_PARAMETER_STORE_NAME>}}",
     "SSM_SID": "<SAP_DATABASE_SID>",
     "SSM_INSTANCES_NUM": "<instances_number seperated by comma>"
   }
   ```

   **Esempio**

   ```
   {
     "SSM_EXPORTER_CONFIG": "{{ssm:exporter_config_paramter}}",
     "SSM_INSTANCES_NUM": "11,12,10",
     "SSM_SID": "PR1"
   }
   ```

1. **Seleziona le istanze Amazon EC2 con NetWeaver applicazioni SAP e scegli Esegui.**

**Nota**  
L'esportatore Prometheus elabora le metriche SAP su un endpoint locale. NetWeaver L'endpoint locale è accessibile solo agli utenti del sistema operativo sull'istanza Amazon EC2. Pertanto, le metriche sono disponibili per tutti gli utenti del sistema operativo dopo l'installazione del pacchetto dell'esportatore. L'endpoint locale predefinito è `localhost:9680/metrics`.

## `AWSObservabilityExporter-SQLExporterInstallAndConfigure`
<a name="appinsights-ssm-sql-prometheus"></a>

È possibile recuperare i parametri SQL Server specifici del carico di lavoro da [Prometheus JMX exporter](https://prometheus.io/docs/instrumenting/exporters/#third-party-exporters) per Application Insights per monitorare gli allarmi principali. 

Per utilizzare [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) per comprimere, installare e configurare il pacchetto dell'esportatore SAP indipendentemente da Approfondimenti sulle applicazioni, procedi come segue.

**Prerequisiti per l'utilizzo del pacchetto SSM dell'esportatore SQL Prometheus**
+ Versione SSM Agent 2.3.1550.0 o successiva installata
+ Istanza Amazon EC2 che esegue SQL Server su Windows con autenticazione utente SQL Server abilitata.
+ Un utente SQL Server con le seguenti autorizzazioni:

  ```
  GRANT VIEW ANY DEFINITION TO
  ```

  ```
  GRANT VIEW SERVER STATE TO
  ```
+ Un segreto contenente la stringa di connessione al database che utilizza Gestione dei segreti AWS. Per ulteriori informazioni sulla creazione dei segreti, consulta [Creazione di un segreto](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) nella *Guida per l'utente di Gestione dei segreti AWS *. Il segreto deve essere formattato come segue:

  ```
  {
    "data_source_name":"sqlserver://<username>:<password>@localhost:1433"
  }
  ```
**Nota**  
Se la password o il nome utente contengono caratteri speciali, è necessario codificare in percentuale i caratteri speciali per garantire una connessione corretta al database.

**Installazione e configurazione del paccetto `AWSObservabilityExporter-SQLExporterInstallAndConfigure`**  
l pacchetto `AWSObservabilityExporter-SQLExporterInstallAndConfigure` è un pacchetto SSM Distributor che puoi utilizzare per installare e configurare l'esportatore di parametri SQL Prometheus. Quando le metriche vengono inviate dall'esportatore Prometheus, l'agente può essere configurato per recuperare CloudWatch le metriche per il servizio. CloudWatch 

1. In base alle preferenze, prepara la configurazione YAML di SQL Exporter. La seguente configurazione di esempio ha un solo parametro configurato. Utilizza la [configurazione di esempio](https://github.com/burningalchemist/sql_exporter/blob/master/examples/sql_exporter.yml) per aggiornare la configurazione con parametri aggiuntivi o creare una configurazione personalizzata.

   ```
   ---
   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'
   ```

1. Copia il file di configurazione YAML dell'esportatore SQL Prometheus codificato come Base64 in un nuovo parametro SSM nell'[Archivio parametri SSM](https://console.aws.amazon.com/systems-manager/parameters).

1. Passare alla console [SSM Distributor](https://console.aws.amazon.com/systems-manager/distributor) e aprire la scheda **Proprietà di Amazon**. **Seleziona e scegli Installa una sola volta. **AWSObservabilityExporter-SQLExporterInstallAndConfigure****

1. Sostituisci gli "Argomenti aggiuntivi" con le seguenti informazioni. `SSM_PARAMETER_NAME` è il nome del parametro creato nel passaggio 2.

   ```
   {
     "SSM_EXPORTER_CONFIGURATION": 
       "{{ssm:<SSM_PARAMETER_STORE_NAME>}}",
       "SSM_PROMETHEUS_PORT": "9399",
       "SSM_WORKLOAD_NAME": "SQL"                         
   }
   ```

1. Seleziona l'istanza Amazon EC2 con il database SQL Server, quindi scegli esegui.

# AWS Documenti Systems Manager (SSM) utilizzati da CloudWatch Application Insights
<a name="appinsights-ssm-documents"></a>

Application Insights utilizza i documenti SSM elencati in questa sezione per definire le azioni che AWS Systems Manager esegue sulle istanze gestite. Questi documenti utilizzano la capacità `Run Command` di Systems Manager per automatizzare le attività necessarie per eseguire le funzionalità di monitoraggio di Application Insights. Le pianificazioni di esecuzione di questi documenti sono gestite da Application Insights e non possono essere modificate.

Per ulteriori informazioni sui documenti SSM, consulta [Documenti AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/documents.html) nella *Guida per l'utente di AWS Systems Manager *.

## Documenti gestiti da Application Insights CloudWatch
<a name="ssm-documents-appinsights-managed"></a>

La tabella seguente elenca i documenti SSM gestiti da Application Insights.


| Nome del documento | Description | Pianificazione delle esecuzioni | 
| --- | --- | --- | 
|  `AWSEC2-DetectWorkload`  |  Rileva automaticamente le applicazioni in esecuzione nell'ambiente applicativo che possono essere configurate per il monitoraggio da parte di Application Insights.  |  Questo documento viene eseguito ogni ora nell'ambiente dell'applicazione per ottenere i dettagli up-to-date dell'applicazione.  | 
|  `AWSEC2-CheckPerformanceCounterSets`  |  Verifica se gli spazi dei nomi dei contatori di prestazioni sono abilitati sulle istanze Windows di Amazon EC2.  |  Questo documento viene eseguito ogni ora nell'ambiente applicativo e monitora i parametri di dei contatori di prestazioni solo se gli spazi dei nomi corrispondenti sono abilitati.  | 
|  `AWSEC2-ApplicationInsightsCloudwatchAgentInstallAndConfigure`  |  Installa e configura CloudWatch l'agente in base alla configurazione di monitoraggio dei componenti dell'applicazione.  |  Questo documento viene eseguito ogni 30 minuti per garantire che la configurazione dell' CloudWatch agente sia sempre accurata e. up-to-date Il documento viene inoltre eseguito immediatamente dopo aver apportato una modifica alla configurazione di monitoraggio dell'applicazione, ad esempio l'aggiunta o la rimozione di parametri o l'aggiornamento delle configurazioni dei log.   | 

## Documenti gestiti da AWS Systems Manager
<a name="ssm-documents-aws-managed"></a>

I seguenti documenti vengono utilizzati da CloudWatch Application Insights e gestiti da Systems Manager.

**`AWS-ConfigureAWSPackage`**  
Application Insights utilizza questo documento per installare e disinstallare i pacchetti Prometheus Exporter Distributor, per raccogliere parametri specifici del carico di lavoro e per consentire il monitoraggio completo dei carichi di lavoro sulle istanze Amazon EC2 dei clienti. CloudWatch Application Insights installa i pacchetti Prometheus exporter distributor solo se il carico di lavoro di destinazione correlato è in esecuzione sull'istanza. 

La tabella seguente elenca i pacchetti Prometheus exporter distributor e i carichi di lavoro di destinazione correlati.


| Nome del pacchetto Prometheus exporter distributor | Carico di lavoro di destinazione | 
| --- | --- | 
|  `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure`  |  SAP HANA HA  | 
|  `AWSObservabilityExporter-JMXExporterInstallAndConfigure`  |  Java/JMX  | 
|  `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure`  |  SAP HANA  | 
|  `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure`  |  NetWeaver  | 
|  `AWSObservabilityExporter-SQLExporterInstallAndConfigure`  |  SQL Server (Windows) e SAP ASE (Linux)  | 

**`AmazonCloudWatch-ManageAgent`**  
Application Insights utilizza questo documento per gestire lo stato e la configurazione di CloudWatch Agent sulle istanze e per raccogliere parametri e log interni a livello di sistema dalle istanze Amazon EC2 su tutti i sistemi operativi.