Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Surveillez un cluster provisionné MSK avec Prometheus
Vous pouvez surveiller votre cluster MSK Provisioned avec Prometheus, un système de surveillance open source pour les données métriques de séries chronologiques. Vous pouvez publier ces données sur Amazon Managed Service for Prometheus à l'aide de la fonctionnalité d'écriture à distance de Prometheus. [https://docs.newrelic.com/docs/integrations/amazon-integrations/aws-integrations-list/aws-managed-kafka-msk-integration](https://docs.newrelic.com/docs/integrations/amazon-integrations/aws-integrations-list/aws-managed-kafka-msk-integration) La surveillance ouverte est disponible gratuitement, mais des frais s'appliquent pour le transfert de données entre les zones de disponibilité.
Pour plus d'informations sur Prometheus, consultez la [documentation Prometheus](https://prometheus.io/docs).
Pour plus d'informations sur l'utilisation de Prometheus, [consultez Améliorer les informations opérationnelles pour Amazon MSK à l'aide d'Amazon Managed Service for Prometheus et d'Amazon Managed](https://aws.amazon.com/blogs//big-data/enhance-operational-insights-for-amazon-msk-using-amazon-managed-service-for-prometheus-and-amazon-managed-grafana/) Grafana.
**Note**
KRaft le mode métadonnées et les courtiers MSK Express ne peuvent pas activer à la fois la surveillance ouverte et l'accès public.
# Activez la surveillance ouverte sur les nouveaux clusters provisionnés par MSK
Cette procédure décrit comment activer la surveillance ouverte sur un nouveau cluster MSK à l'aide de l' AWS Management Console API Amazon MSK ou de l'API Amazon MSK. AWS CLI
**À l'aide du AWS Management Console**
1. Connectez-vous à la AWS Management Console console Amazon MSK et ouvrez-la [https://console.aws.amazon.com/msk/chez vous ? region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/).
1. Dans la section **Monitoring (Surveillance)**, cochez la case en regard de **Enable open monitoring with Prometheus (Activer la surveillance ouverte avec Prometheus)**.
1. Fournissez les informations requises dans toutes les sections de la page et examinez toutes les options disponibles.
1. Choisissez **Créer un cluster**.
**À l'aide du AWS CLI**
+ Invoquez la commande [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/kafka/create-cluster.html) et spécifiez son option `open-monitoring`. Activez le `JmxExporter`, le `NodeExporter`, ou les deux. Si vous spécifiez `open-monitoring`, les deux exportateurs ne peuvent pas être désactivés en même temps.
**Utilisation de l’API**
+ Invoquez l'[CreateCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters.html#CreateCluster)opération et spécifiez`OpenMonitoring`. Activez le `jmxExporter`, le `nodeExporter`, ou les deux. Si vous spécifiez `OpenMonitoring`, les deux exportateurs ne peuvent pas être désactivés en même temps.
# Activer la surveillance ouverte sur le cluster MSK Provisioned existant
Pour activer la surveillance ouverte, assurez-vous que le cluster MSK Provisioned est dans cet état. `ACTIVE`
**À l'aide du AWS Management Console**
1. Connectez-vous à la AWS Management Console console Amazon MSK et ouvrez-la [https://console.aws.amazon.com/msk/chez vous ? region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/).
1. Choisissez le nom du cluster que vous voulez mettre à jour. Vous accédez alors à une page contenant les détails du cluster.
1. Dans l'onglet **Propriétés**, faites défiler vers le bas pour accéder à la section **Surveillance**.
1. Choisissez **Modifier**.
1. Cochez la case en regard de **Enable open monitoring with Prometheus (Activer la surveillance ouverte avec Prometheus)**.
1. Sélectionnez **Enregistrer les modifications**.
**À l'aide du AWS CLI**
+ Invoquez la commande [update-monitoring](https://docs.aws.amazon.com/cli/latest/reference/kafka/update-monitoring.html) et spécifiez son option `open-monitoring`. Activez le `JmxExporter`, le `NodeExporter`, ou les deux. Si vous spécifiez `open-monitoring`, les deux exportateurs ne peuvent pas être désactivés en même temps.
**Utilisation de l’API**
+ Invoquez l'[UpdateMonitoring](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-monitoring.html#UpdateMonitoring)opération et spécifiez`OpenMonitoring`. Activez le `jmxExporter`, le `nodeExporter`, ou les deux. Si vous spécifiez `OpenMonitoring`, les deux exportateurs ne peuvent pas être désactivés en même temps.
# Configurer un hôte Prometheus sur une instance Amazon EC2
Cette procédure décrit comment configurer un hôte Prometheus à l'aide d'un fichier prometheus.yml.
1. Téléchargez le serveur Prometheus à partir de [https://prometheus.io/download/#prometheus](https://prometheus.io/download/#prometheus) vers votre instance Amazon EC2.
1. Extrayez le fichier téléchargé dans un répertoire et allez dans ce dernier.
1. Créez un fichier avec le contenu suivant et appelez-le `prometheus.yml`.
```
# 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=` 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. Utilisez l'[ListNodes](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-nodes.html#ListNodes)opération pour obtenir la liste des courtiers de votre cluster.
1. Créez un fichier appelé `targets.json` avec le JSON suivant. Remplacez *broker\$1dns\$11**broker\$1dns\$12*, et le reste des noms DNS des courtiers par les noms DNS que vous avez obtenus pour vos courtiers à l'étape précédente. Incluez tous les agents que vous avez obtenus à l'étape précédente. Amazon MSK utilise le port 11001 pour JMX Exporter et le port 11002 pour 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"
]
}
]
```
------
**Note**
Pour extraire les métriques JMX des KRaft contrôleurs, ajoutez les noms DNS des contrôleurs en tant que cibles dans le fichier JSON. Par exemple : `controller_dns_1:11001` en `controller_dns_1` remplaçant par le nom DNS réel du contrôleur.
1. Pour démarrer le serveur Prometheus sur votre instance Amazon EC2, exécutez la commande suivante dans le répertoire où vous avez extrait les fichiers Prometheus et enregistré `prometheus.yml` et `targets.json`.
```
./prometheus
```
1. Recherchez l'adresse IP publique IPv4 de l'instance Amazon EC2 sur laquelle vous avez exécuté Prometheus à l'étape précédente. Vous aurez besoin de cette adresse IP publique lors de l’étape suivante.
1. Pour accéder à l'interface utilisateur Web de Prometheus, ouvrez un navigateur qui peut accéder à votre instance Amazon EC2, puis rendez-vous sur, *Prometheus-Instance-Public-IP* où se trouve l'adresse IP publique que vous avez obtenue `Prometheus-Instance-Public-IP:9090` à l'étape précédente.
# Utiliser les métriques Prometheus
Toutes les métriques émises par Apache Kafka vers JMX sont accessibles en utilisant une surveillance ouverte avec Prometheus. Pour plus d'informations sur les métriques d’Apache Kafka, consultez [Surveillance](https://kafka.apache.org/documentation/#monitoring) dans la documentation Apache Kafka. Outre les métriques Apache Kafka, les métriques relatives au retard de consommation sont également disponibles sur le port 11001 sous le nom JMX. MBean `kafka.consumer.group:type=ConsumerLagMetrics` Vous pouvez également utiliser Prometheus Node Exporter pour obtenir des métriques de l'UC et du disque pour vos agents sur le port 11002.
# Stockez les statistiques de Prometheus dans Amazon Managed Service for Prometheus
Amazon Managed Service for Prometheus est un service de surveillance et d'alerte compatible avec Prometheus que vous pouvez utiliser pour surveiller les clusters Amazon MSK. Il s'agit d'un service entièrement géré qui met automatiquement à l'échelle l'ingestion, le stockage, l'interrogation et l'alerte de vos métriques. Il s'intègre également aux services AWS de sécurité pour vous donner un accès rapide et sécurisé à vos données. Vous pouvez utiliser le langage de requête open source PromQL pour interroger vos métriques et émettre des alertes à leur sujet.
Pour plus d'informations, consultez [Démarrage avec Amazon Managed Service for Prometheus](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-getting-started.html).