

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

# Monitora un cluster MSK Provisioned con Prometheus
<a name="open-monitoring"></a>

È possibile monitorare il cluster MSK Provisioned con Prometheus, un sistema di monitoraggio open source per dati metrici di serie temporali. Puoi pubblicare questi dati su Servizio gestito da Amazon per Prometheus utilizzando la funzione di scrittura remota di Prometheus. [https://docs.lenses.io/latest/deployment/configuration/agent/automation/kafka/aws-msk](https://docs.lenses.io/latest/deployment/configuration/agent/automation/kafka/aws-msk) Il monitoraggio aperto è disponibile gratuitamente, ma per il trasferimento dei dati tra le zone di disponibilità vengono addebitati dei costi.

Per informazioni su Prometheus, consulta la [documentazione di Prometheus](https://prometheus.io/docs).

Per informazioni sull'uso di Prometheus, consulta [Migliora le informazioni operative per Amazon MSK usando Amazon Managed Service for Prometheus e Amazon Managed Grafana](https://aws.amazon.com/blogs//big-data/enhance-operational-insights-for-amazon-msk-using-amazon-managed-service-for-prometheus-and-amazon-managed-grafana/).

**Nota**  
KRaft la modalità metadati e i broker MSK Express non possono avere entrambi abilitati il monitoraggio aperto e l'accesso pubblico.

# Abilita il monitoraggio aperto sui nuovi cluster MSK Provisioned
<a name="enable-open-monitoring-at-creation"></a>

Questa procedura descrive come abilitare il monitoraggio aperto su un nuovo cluster MSK utilizzando AWS CLI l' Console di gestione AWS API Amazon MSK.

**Usando il Console di gestione AWS**

1. Accedere a e aprire la console Amazon MSK da [https://console.aws.amazon.com/msk/casa? Console di gestione AWS region=us-east-1\$1/home/.](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/)

1. Nella sezione **Monitoring (Monitoraggio)**, selezionare la casella di controllo accanto a **Enable open monitoring with Prometheus (Abilita monitoraggio aperto con Prometheus)**.

1. Fornire le informazioni richieste in tutte le sezioni della pagina e rivedere tutte le opzioni disponibili.

1. Scegli **Crea cluster**.

**Usando il AWS CLI**
+ Richiamare il comando [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/kafka/create-cluster.html) e specificarne l'opzione `open-monitoring`. Abilitare `JmxExporter`, `NodeExporter` o entrambi. Se si specifica `open-monitoring`, non è possibile disabilitare i due esportatori contemporaneamente.

**Utilizzo dell’API**
+ Richiama l'[CreateCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters.html#CreateCluster)operazione e specifica`OpenMonitoring`. Abilitare `jmxExporter`, `nodeExporter` o entrambi. Se si specifica `OpenMonitoring`, non è possibile disabilitare i due esportatori contemporaneamente.

# Abilita il monitoraggio aperto sul cluster MSK Provisioned esistente
<a name="enable-open-monitoring-after-creation"></a>

Per abilitare il monitoraggio aperto, assicuratevi che il cluster MSK Provisioned sia nello stato. `ACTIVE`

**Usando il Console di gestione AWS**

1. Accedere a e aprire la console Amazon MSK da [https://console.aws.amazon.com/msk/casa? Console di gestione AWS region=us-east-1\$1/home/.](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/)

1. Scegliere il nome del cluster da aggiornare. In questo modo si accede alla pagina dei dettagli del cluster.

1. Nella scheda **Proprietà**, scorri verso il basso per trovare la sezione **Monitoraggio**.

1. Scegli **Modifica**.

1. Selezionare la casella di controllo accanto a **Enable open monitoring with Prometheus (Abilita monitoraggio aperto con Prometheus)**.

1. Scegli **Save changes** (Salva modifiche).

**Usando il AWS CLI**
+ Richiama il comando [update-monitoring](https://docs.aws.amazon.com/cli/latest/reference/kafka/update-monitoring.html) e specifica l'opzione `open-monitoring`. Abilitare `JmxExporter`, `NodeExporter` o entrambi. Se si specifica `open-monitoring`, non è possibile disabilitare i due esportatori contemporaneamente.

**Utilizzo dell’API**
+ Richiama l'[UpdateMonitoring](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-monitoring.html#UpdateMonitoring)operazione e specifica`OpenMonitoring`. Abilitare `jmxExporter`, `nodeExporter` o entrambi. Se si specifica `OpenMonitoring`, non è possibile disabilitare i due esportatori contemporaneamente.

# Configura un host Prometheus su un'istanza Amazon EC2
<a name="set-up-prometheus-host"></a>

Questa procedura descrive come configurare un host Prometheus utilizzando un file prometheus.yml.

1. Scaricare il server Prometheus da [https://prometheus.io/download/#prometheus](https://prometheus.io/download/#prometheus) nell'istanza Amazon EC2.

1. Estrarre il file scaricato in una directory e passare a tale directory.

1. Creare un file denominato `prometheus.yml` con i seguenti contenuti:

   ```
   # file: prometheus.yml
   # my global config
   global:
     scrape_interval:     60s
   
   # A scrape configuration containing exactly one endpoint to scrape:
   # Here it's Prometheus itself.
   scrape_configs:
     # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config.
     - job_name: 'prometheus'
       static_configs:
       # 9090 is the prometheus server port
       - targets: ['localhost:9090']
     - job_name: 'broker'
       file_sd_configs:
       - files:
         - 'targets.json'
   ```

1. Usa l'[ListNodes](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-nodes.html#ListNodes)operazione per ottenere un elenco dei broker del tuo cluster.

1. Creare un file denominato `targets.json` con il seguente JSON. Sostituisci *broker\$1dns\$11**broker\$1dns\$12*, e il resto dei nomi DNS dei broker con i nomi DNS che hai ottenuto per i tuoi broker nel passaggio precedente. Includi tutti i broker ottenuti nel passaggio precedente. Amazon MSK utilizza la porta 11001 per JMX Exporter e la porta 11002 per Node Exporter.

------
#### [ ZooKeeper mode targets.json ]

   ```
   [
     {
       "labels": {
         "job": "jmx"
       },
       "targets": [
         "broker_dns_1:11001",
         "broker_dns_2:11001",
         .
         .
         .
         "broker_dns_N:11001"
       ]
     },
     {
       "labels": {
         "job": "node"
       },
       "targets": [
         "broker_dns_1:11002",
         "broker_dns_2:11002",
         .
         .
         .
         "broker_dns_N:11002"
       ]
     }
   ]
   ```

------
#### [ KRaft mode targets.json ]

   ```
   [
     {
       "labels": {
         "job": "jmx"
       },
       "targets": [
         "broker_dns_1:11001",
         "broker_dns_2:11001",
         .
         .
         .
         "broker_dns_N:11001",
         "controller_dns_1:11001",
         "controller_dns_2:11001",
         "controller_dns_3:11001"
       ]
     },
     {
       "labels": {
         "job": "node"
       },
       "targets": [
         "broker_dns_1:11002",
         "broker_dns_2:11002",
         .
         .
         .
         "broker_dns_N:11002"
       ]
     }
   ]
   ```

------
**Nota**  
Per estrarre le metriche JMX dai KRaft controller, aggiungi i nomi DNS dei controller come destinazioni nel file JSON. Ad esempio: sostituendo `controller_dns_1` con il nome `controller_dns_1:11001` DNS effettivo del controller.

1. Per avviare il server Prometheus sull'istanza Amazon EC2, esegui il seguente comando nella directory in cui sono stati estratti i file Prometheus e salvati `prometheus.yml` e `targets.json`.

   ```
   ./prometheus
   ```

1. Individua l'indirizzo IP pubblico IPv4 dell'istanza Amazon EC2 in cui è stato eseguito Prometheus nel passaggio precedente. Questo indirizzo IP pubblico è necessario nella fase seguente.

1. Per accedere all'interfaccia utente web di Prometheus, apri un browser in grado di accedere alla tua istanza Amazon EC2 e vai `Prometheus-Instance-Public-IP:9090` a, *Prometheus-Instance-Public-IP* dov'è l'indirizzo IP pubblico che hai ottenuto nel passaggio precedente.

# Usa le metriche di Prometheus
<a name="prometheus-metrics"></a>

Tutti i parametri inviati da Apache Kafka a JMX sono accessibili tramite il monitoraggio aperto con Prometheus. Per informazioni sui parametri Apache Kafka, consulta la sezione relativa al [monitoraggio](https://kafka.apache.org/documentation/#monitoring) nella documentazione di Apache Kafka. Oltre alle metriche di Apache Kafka, le metriche del consumer-lag sono disponibili anche sulla porta 11001 con il nome JMX. MBean `kafka.consumer.group:type=ConsumerLagMetrics` Puoi anche utilizzare Prometheus Node Exporter per ottenere i parametri della CPU e del disco per i tuoi broker sulla porta 11002.

# Archivia i parametri di Prometheus in Amazon Managed Service for Prometheus
<a name="managed-service-prometheus"></a>

Servizio gestito da Amazon per Prometheus è un servizio di monitoraggio e avviso compatibile con Prometheus che puoi utilizzare per monitorare i cluster Amazon MSK. È un servizio completamente gestito che dimensiona automaticamente l'importazione, l'archiviazione, le query e gli avvisi dei parametri. Si integra inoltre con i servizi AWS di sicurezza per offrirti un accesso rapido e sicuro ai tuoi dati. È possibile utilizzare il linguaggio di query open source ProMQL per fare una query e creare avvisi relativi ai parametri.

Per ulteriori informazioni, consultare [Guida introduttiva ad Amazon Managed Service for Prometheus](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-getting-started.html).