

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à.

# Configurazione CloudWatch dell'agente per Amazon EMR 7.0.0
<a name="AmazonCloudWatchAgent-config-700"></a>

Puoi configurare l' CloudWatch agente Amazon per utilizzare parametri di sistema aggiuntivi oltre a quelli forniti [dalla configurazione predefinita CloudWatch dell'agente](AmazonCloudWatchAgent-metrics.md). La configurazione per 7.0.0 richiede l'utilizzo di operazioni di bootstrap, di cui abbiamo fornito esempi nelle sezioni seguenti. In una delle prossime versioni, Amazon EMR fornirà opzioni di configurazione aggiuntive tramite l'API Amazon EMR.

**Topics**
+ [Configura parametri di sistema aggiuntivi con Amazon EMR 7.0.0](#AmazonCloudWatchAgent-config-700-add-metrics)
+ [Configura i parametri delle applicazioni con Amazon EMR 7.0.0](#AmazonCloudWatchAgent-config-700-app-metrics)
+ [Configura il servizio gestito da Amazon per Prometheus come spazio di archiviazione cloud per i parametri con Amazon EMR 7.0.0](#AmazonCloudWatchAgent-config-700-prometheus)

## Configura parametri di sistema aggiuntivi con Amazon EMR 7.0.0
<a name="AmazonCloudWatchAgent-config-700-add-metrics"></a>

Utilizza i seguenti passaggi per configurare l'agente in modo che utilizzi un set diverso di parametri di sistema in Amazon EMR 7.0.0:

1. Crea o scegli un bucket nel tuo account Amazon S3 in cui archiviare i file di configurazione che specificano i parametri CloudWatch dell'agente.

1. Crea il file di configurazione `emr-amazon-cloudwatch-agent.json` specificando i parametri preferiti. A tale scopo, utilizza uno dei metodi spiegati in [Creare il file di configurazione dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file.html). Per ulteriori informazioni sulla struttura del file di configurazione dell' CloudWatch agente, consulta [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) nella *Amazon CloudWatch User Guide*.

1. Successivamente, accedi al **aws-emr-utilities** repository GitHub e scarica i seguenti script di metriche di sistema:
   + **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/system-metrics/install_system_metrics_launcher.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/system-metrics/install_system_metrics_launcher.sh)**: uno script da scaricare e che poi esegue `install_system_metrics.sh` in background in modo che il nodo possa completare il bootstrap.
   + **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/system-metrics/install_system_metrics.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/system-metrics/install_system_metrics.sh)**: uno script che attende che l'istanza su cui viene eseguito completi il bootstrap e che poi scarica e applica la configurazione nel file JSON.

1. Apri ogni file SH e sostituisci `amzn-s3-demo-bucket` con il nome del bucket del passaggio 1.

1. Carica il file JSON e due file SH nel bucket S3.

1. Ora puoi accedere alla console Amazon EMR e creare un nuovo cluster con l' CloudWatch agente. Scegli **EMR su EC2** nel riquadro a sinistra, quindi seleziona **Cluster** e **Crea cluster**.

1. Nella sezione **Nome e applicazioni**, scegli la versione di Amazon EMR 7.0.0 o una versione successiva.

1. In **Pacchetto di applicazioni**, seleziona il pacchetto o le app che desideri installare nel cluster e includi **Amazon CloudWatch Agent** tra le tue selezioni.

1. Nella sezione **Operazioni di bootstrap**, seleziona **Aggiungi**.
   + In **Nome**, inserisci **install\$1system\$1metrics\$1launcher.sh**.
   + In **Posizione dello script**, inserisci **s3://*amzn-s3-demo-bucket*/install\$1system\$1metrics\$1launcher.sh**. Sostituisci `amzn-s3-demo-bucket` con il percorso del bucket S3.
   + Lascia vuoto il blocco **Argomenti**.

1. Seleziona **Add bootstrap action** (Aggiungi operazione di bootstrap).

1. Continua a creare il cluster per soddisfare le tue esigenze di carico di lavoro.

All'avvio del cluster, l' CloudWatch agente pubblica le metriche di sistema specificate nel file di configurazione. CloudWatch

## Configura i parametri delle applicazioni con Amazon EMR 7.0.0
<a name="AmazonCloudWatchAgent-config-700-app-metrics"></a>

Puoi configurare l' CloudWatch agente Amazon per pubblicare i parametri delle applicazioni per HDFS e YARN oltre ai parametri di sistema. Completa la procedura seguente per configurare l'agente e pubblicare i parametri delle applicazioni:

1. Crea o scegli un bucket nel tuo account Amazon S3 in cui archiviare i file di configurazione che specificano i parametri CloudWatch dell'agente.

1. Successivamente, accedi al **aws-emr-utilities** repository GitHub e scarica i seguenti script:
   + **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/install_app_metrics_launcher.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/install_app_metrics_launcher.sh)**: uno script da scaricare e che poi esegue `install_app_metrics.sh` in background in modo che il nodo possa completare il bootstrap.
   + **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/install_app_metrics.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/install_app_metrics.sh)**: uno script che attende che l'istanza su cui viene eseguito completi il bootstrap e che poi scarica e applica la configurazione nei file YAML che scaricherai in uno dei prossimi passaggi.

1. Apri ogni file e sostituisci `amzn-s3-demo-bucket` con il nome del bucket del passaggio 1.

1. Quindi, scarica i seguenti file di mappatura YAML. Per informazioni su come sono strutturati questi file YAML, consulta [https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/jmx-metrics/javaagent](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/jmx-metrics/javaagent)nel repository. *OpenTelemetry Instrumentation for Java* GitHub 
   + **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/datanode-metrics.yaml](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/datanode-metrics.yaml)**: la configurazione per i parametri Hadoop DataNode.
   + **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/namenode-metrics.yaml](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/namenode-metrics.yaml)**: la configurazione per i parametri Hadoop NameNode.
   + **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/nodemanager-metrics.yaml](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/nodemanager-metrics.yaml)**: la configurazione per i parametri Yarn NodeManager.
   + **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/resourcemanager-metrics.yaml](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/application-metrics/mappings/resourcemanager-metrics.yaml)**: la configurazione per i parametri Yarn ResourceManager.

1. Carica i due file SH e i quattro file YAML nel bucket S3.

1. Ora puoi accedere alla console Amazon EMR e creare un nuovo cluster con l' CloudWatch agente. Scegli **EMR su EC2** nel riquadro a sinistra, quindi seleziona **Cluster** e **Crea cluster**.

1. Nella sezione **Nome e applicazioni**, scegli la versione di Amazon EMR 7.0.0 o una versione successiva.

1. In **Application bundle**, seleziona il pacchetto o il gruppo personalizzato di app che desideri installare nel cluster e includi l'**CloudWatch agente** tra le tue selezioni.

1. Nella sezione **Operazioni di bootstrap**, seleziona **Aggiungi**.
   + In **Nome**, inserisci **install\$1app\$1metrics\$1launcher.sh**.
   + In **Posizione dello script**, inserisci **s3://*amzn-s3-demo-bucket*/install\$1app\$1metrics\$1launcher.sh**. Sostituisci `amzn-s3-demo-bucket` con il percorso del bucket S3.
   + Lascia vuoto il blocco **Argomenti**.

1. Seleziona **Add bootstrap action** (Aggiungi operazione di bootstrap).

1. Continua a creare il cluster per soddisfare le tue esigenze di carico di lavoro.

All'avvio del cluster, l' CloudWatch agente pubblica le metriche dell'applicazione che hai specificato insieme alle metriche di sistema. CloudWatch

## Configura il servizio gestito da Amazon per Prometheus come spazio di archiviazione cloud per i parametri con Amazon EMR 7.0.0
<a name="AmazonCloudWatchAgent-config-700-prometheus"></a>

Puoi configurare l' CloudWatch agente Amazon per pubblicare i parametri su Amazon Managed Service for Prometheus anziché. CloudWatch

**Nota**  
Puoi pubblicare i parametri dell' CloudWatch agente Amazon su Amazon Managed Service for Prometheus o su CloudWatch Amazon, ma non puoi pubblicare i parametri su entrambi i servizi per lo stesso cluster.

Per configurare l'agente per pubblicare i parametri su Amazon Managed Service for Prometheus, devi aggiungere l'autorizzazione (IAM) al profilo `aps:RemoteWrite` AWS Identity and Access Management dell'istanza Amazon EC2 per Amazon EMR. La seguente policy di esempio contiene le autorizzazioni necessarie:

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aps:RemoteWrite"
      ],
      "Resource": [
        "*"
      ],
      "Sid": "AllowAPSRemotewrite"
    }
  ]
}
```

------

**Usa l' CloudWatch agente su un cluster EMR per pubblicare i parametri su Amazon Managed Service for Prometheus**

Una volta che la policy del servizio ha le autorizzazioni corrette, segui i passaggi seguenti per avviare un cluster che utilizza l' CloudWatch agente per pubblicare i parametri su Amazon Managed Service for Prometheus.

1. Usa Console di gestione AWS o AWS CLI per creare un'area di lavoro Amazon Managed Service for Prometheus. Per ulteriori informazioni, consulta [Crea un workspace](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-onboard-create-workspace.html) nella *Guida per l'utente del servizio gestito da Amazon per Prometheus*.

1. Crea o scegli un bucket nel tuo account Amazon S3 in cui archiviare i file di avvio che specificano il servizio gestito da Amazon per Prometheus come spazio di archiviazione cloud.

1. Successivamente, accedi al **aws-emr-utilities** repository GitHub e scarica i seguenti script:
   + **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/prometheus/add_prometheus_endpoint_launcher.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/prometheus/add_prometheus_endpoint_launcher.sh)**: uno script da scaricare e che poi esegue `add_prometheus_endpoint.sh` in background in modo che il nodo possa completare il bootstrap.
   + **[https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/prometheus/add_prometheus_endpoint.sh](https://github.com/aws-samples/aws-emr-utilities/blob/main/applications/cloudwatch-agent/configuration/7.0/prometheus/add_prometheus_endpoint.sh)**— Uno script che attende che l'istanza su cui viene eseguita completi il bootstrap, quindi configura l' CloudWatch agente per la pubblicazione sull'endpoint Amazon Managed Service for Prometheus fornito come argomento all'avvio del cluster.

1. Apri ogni file e sostituisci `amzn-s3-demo-bucket` con il nome del bucket del passaggio 2.

1. Utilizzare il AWS CLI per creare un cluster EMR con l'azione `add_prometheus_endpoint_launcher.sh` bootstrap. Nel comando seguente, sostituisci `amzn-s3-demo-bucket` con il bucket che contiene l'operazione di bootstrap e sostituisci `managedpro-remote-write-workspace-url` con l'endpoint di scrittura remoto per il workspace del servizio gestito da Amazon per Prometheus. Assicurati di specificare un'etichetta di rilascio Amazon EMR uguale o superiore a `emr-7.0.0`.

   ```
   aws emr create-cluster --name managedpro-cluster \
       --release-label emr-7.0.0 \
       --applications Name=Hadoop Name=AmazonCloudWatchAgent \
       --ec2-attributes KeyName=myKey --instance-type m7g.2xlarge \
       --instance-count 3 --use-default-roles
      --bootstrap-actions Name='Add Prometheus Endpoint',Path=s3://amzn-s3-demo-bucket/add_prometheus_endpoint_launcher.sh,Args='managedpro-remote-write-workspace-url'
   ```

All'avvio del cluster, l' CloudWatch agente pubblica le metriche raccolte su Amazon Managed Service for Prometheus.

**Utilizza il servizio gestito da Amazon per Prometheus come origine dati per Grafana gestito da Amazon**

Una volta che Amazon EMR ha pubblicato i parametri del cluster sul servizio gestito da Amazon per Prometheus, puoi utilizzare i seguenti passaggi per visualizzare i parametri con Grafana gestito da Amazon: 

1. Usa il Console di gestione AWS per creare uno spazio di lavoro e un utente Amazon Managed Grafana con le autorizzazioni appropriate. Per ulteriori informazioni, consulta [Crea un workspace](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-create-workspace.html) nella *Guida per l'utente di Grafana gestito da Amazon*.

1. Aggiungi il workspace del servizio gestito da Amazon per Prometheus come origine dati per Grafana gestito da Amazon. Per ulteriori informazioni, consulta [Utilizza la configurazione dell'origine dati AWS per aggiungere il servizio gestito da Amazon per Prometheus come origine dati](https://docs.aws.amazon.com/grafana/latest/userguide/AMP-adding-AWS-config.html) nella *Guida per l'utente di Grafana gestito da Amazon*.

**Nota**  
L' CloudWatch agente dispone di un esportatore Prometheus che rinomina determinati attributi. Per le etichette delle metriche predefinite, Amazon Managed Service for Prometheus utilizza caratteri di sottolineatura al posto dei periodi utilizzati da Amazon. CloudWatch Quindi, se usi Grafana gestito da Amazon per visualizzare i parametri predefiniti nel servizio gestito da Amazon per Prometheus, le etichette appaiono come `jobflow_id`, `instance_id` e `service_name`.  
Inoltre, tutte le metriche **dell'applicazione** pubblicate dall' CloudWatch agente su Amazon Managed Service for Prometheus utilizzano l'etichetta anziché. `job` `service_name` Tuttavia, i parametri del **sistema** continuano a utilizzare l'etichetta `service_name`.