--- sourceDocument: Gestion des opérations IT Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/it-operations-management Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Gestion des opérations IT Xanadu ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # Vérifications et politiques par défaut de Apache Kafka # Vérifications et politiques par défaut de Apache Kafka {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture Agent Client Collector fournit les politiques suivantes pour la surveillance d'intégrité d'Apache Kafka. Ces politiques sont associées aux vérifications spécifiées dans la table indiquée. Les politiques et les vérifications sont disponibles pour les deux et Windows .Linux {#kafka-checks-policies__table_y3r_2qd_2tb__entry__4} | Vérification | Description | Utilisation | Sortie | |-|-|-|-| | kafka.check-zookeeper-status | Déclenche un événement critique si le Zookeeper Kafka hébergé est en panne. | `commonchecks check-kafka-zk-status` \[marqueurs\] Où les marqueurs sont les suivants : `-p, --port =` Port Zookeeper (par défaut \<\< 2181 \>\>). Exemple d'utilisation : `check-kafka-zk-status -p 2181` | Kafka Zookeeper Status OK: Kafka Zookeeper is Up! (État Zookeeper Kafka OK : Zookeeper Kafka est opérationnel !) | | kafka.check-topic-replicas | Déclenche un événement critique si une rubrique comporte des partitions avec des réplications inconnues. | `commonchecks check-kafka-replicas ` \[marqueurs\] Où les marqueurs sont les suivants : * `-p, --port =` Port Zookeeper (par défaut \<\< 2181 \>\>). * `-d, --detailed` = répertorie les réplications inconnues dans chaque partition d'une rubrique. * `-i, --include_list` = liste séparée par des virgules pour inclure des rubriques (caractère générique \* autorisé) * `-e, --exclude_list` = liste séparée par des virgules pour exclure les rubriques (caractère générique \* autorisé) {#kafka-checks-policies__ul_wtk_yhl_25b}Exemple d'utilisation : commonchecks check-kafka-replicas -H localhost -p 2181 -i "test\*" -e "accTopic,\*offsets" -d | \ a des partitions avec des répliques inconnues. Les répliques inconnues sont : {"0 \>\> :\["0"\],"1 \>\> :\["0"\],"2 \>\> :\["0"\]}. \ a des partitions avec des répliques inconnues. Les répliques inconnues sont : {"0 \>\> :\["0"\]}. | | kafka.check-topic-replication-factor | Déclenche un événement critique si le facteur de réplication d'au moins une rubrique est supérieur ou inférieur au paramètre de facteur de réplication fourni. | `commonchecks check-kafka-rf` \[marqueurs\] Où les marqueurs sont les suivants : * `-p, --port =` Port Zookeeper (par défaut \<\< 2181 \>\>). * `-d, --detailed` = répertorie les réplications inconnues dans chaque partition d'une rubrique. * `-i, --include_list` = liste séparée par des virgules pour inclure des rubriques (caractère générique \* autorisé) * `-e, --exclude_list` = liste séparée par des virgules pour exclure les rubriques (caractère générique \* autorisé) * `-r, --replication factor` = facteur de réplication attendu pour une rubrique (par défaut 1) {#kafka-checks-policies__ul_gcn_mcm_f5b} Exemples : `commonchecks check-kafka-partitions -H localhost -p 2181 -r 2 -i "accMetrics,*Topic" -e "testTopic"` | TestTopic has replication factor 1, which is less than expected: 2. (TestTopic possède le facteur de réplication 1, qui est inférieur à celui prévu : 2.) accMetrics has replication factor 1, which is less than expected: 2. (accMetrics possède un facteur de réplication 1, qui est inférieur à celui prévu : 2.) | | kafka.check-topic-leader | Déclenche un événement critique si une rubrique comporte des partitions avec des responsables inconnus ou une réplication non préférée en tant que responsable. | `commonchecks check-kafka-leader` \[marqueurs\] Emplacement des marqueurs * `-p, --port` = port Zookeeper (par défaut \<\< 2181 \>\>). * `-d, --detailed` = liste de partitions dans chaque rubrique avec des responsables inconnus ou des réplications non préférées. * `-i, --include_list` = liste séparée par des virgules pour inclure des rubriques (caractère générique \* autorisé) * `-e, --exclude_list` = liste séparée par des virgules pour exclure les rubriques (caractère générique \* autorisé) {#kafka-checks-policies__ul_bqh_gdm_f5b} Exemples : `commonchecks check-kafka-leader -H localhost -p 2181 -d -e "*offsets"` | \ contains, partitions with unpreferred replica as leader.(partitions with unpreferred replicas are \[0\]). (\ contient des partitions avec une réplication non préférée en tant que responsable (les partitions avec des réplications non préférées sont \[0\]).) \ contains, partitions with unpreferred replica as leader.(partitions with unpreferred replicas are \[0\]). (\ contient des partitions avec une réplication non préférée en tant que responsable (les partitions avec des réplications non préférées sont \[0\]).) | | kafka.check-topic-partitions | Déclenche des événements critiques si le nombre de partitions d'une rubrique est inférieur au paramètre min_partitions. | `commonchecks check-kafka-partitions [marqueurs]` Où les marqueurs sont les suivants : * `-p, --port` = port Zookeeper (par défaut \<\< 2181 \>\>). * `-P, --min_partitions` = partitions minimales pour une rubrique (1 par défaut). * `-i, --include_list` = liste séparée par des virgules pour inclure des rubriques (caractère générique \* autorisé) * `-e, --exclude_list` = liste séparée par des virgules pour exclure les rubriques (caractère générique \* autorisé) {#kafka-checks-policies__ul_q5g_xxd_2tb} | | | kafka.check-topic-partitions | Déclenche des événements critiques si le nombre de partitions d'une rubrique est inférieur au paramètre min_partitions. | Exemple d'utilisation 1 : `commonchecks check-kafka-partitions -H localhost -p 2181 -P 3` | \ has 1 partitions, expected at least 3. (\ possède 1 partition, attendues au moins 3.) \ has 1 partitions, expected at least 3. (\ possède 1 partition, attendues au moins 3.) \ has 1 partitions, expected at least 3. (\ possède 1 partition, attendues au moins 3.) | | kafka.check-topic-partitions | Déclenche des événements critiques si le nombre de partitions d'une rubrique est inférieur au paramètre min_partitions. | Exemple d'utilisation 2 : commonchecks check-kafka-partitions -H localhost -p 2181 -P 3 -i "accMetrics,\*Topic" -e "testTopic" | \ has 1 partitions, expected at least 3. (\ possède 1 partition, attendues au moins 3.) \ has 1 partitions, expected at least 3. (\ possède 1 partition, attendues au moins 3.) | [Tableau 1. Événements de rubriques Apache Kafka] {#kafka-checks-policies__table_y3r_2qd_2tb} Remarque : les valeurs des paramètres include_list et exclude_list doivent être placées entre guillemets doubles. P. ex. : "test1,\*topic". {#kafka-checks-policies__table_hxk_5dm_f5b__entry__4} | Vérification | Description | Utilisation | Sortie | |-|-|-|-| | kafka.check-broker-status | Déclenche un événement critique si le broker Kafka sur l'hôte est en panne. | `commonchecks check-kafka-broker-status` \[marqueurs\] Où les marqueurs sont les suivants : `-p, --port` = Port Kafka Broker (par défaut \<\< 9092 \>\>). Exemple d'utilisation : `commonchecks check-kafka-broker-status -p 9092` | Kafka Broker Status OK: Kafka Broker ubuntu20:9092 is Up! (État du broker Kafka OK : le broker Kafka ubuntu20:9092 est opérationnel !) | [Tableau 2. Événements de broker Apache Kafka] {#kafka-checks-policies__table_hxk_5dm_f5b} {#kafka-checks-policies__table_emg_g2m_f5b__entry__4} | Vérification | Description | Utilisation | Sortie | |-|-|-|-| | kafka.metrics.broker | Collecte les mesures du broker Kafka à partir de l'hôte. | ` commonchecks metric-kafka-broker` \[marqueurs\] Où les marqueurs sont les suivants : * `-J, --javapath ` = chemin d'accès de l'exécutable Java (par défaut \<\< Java \>\>). * `-j, --jmxport` = port JMX (par défaut \<\< 9999 \>\>) {#kafka-checks-policies__ul_xjm_z2m_f5b} Exemple d'utilisation : `commonchecks metric-kafka-broker -J "/usr/bin/java" -j 9999` | hostname.Kafka.Broker.ReplicaManager.IsrExpandsPerSec.OneMinuteRate 0.000 hostname.Kafka.Broker.DelayedOperationPurgatory.PurgatorySize.Fetch.Value 627.000 hostname.Kafka.Broker.ControllerStats.UncleanLeaderElectionsPerSec.OneMinuteRate 0.000 hostname.Kafka.Broker.RequestMetrics.RequestsPerSec.Produce.OneMinuteRate 0.000 | [Tableau 3. Mesures de broker Apache Kafka] {#kafka-checks-policies__table_emg_g2m_f5b} {#kafka-checks-policies__table_ds2_3fm_f5b__entry__4} | Vérification | Description | Utilisation | Sortie | |-|-|-|-| | kafka.metrics.zookeeper | Collecte les mesures Zookeeper à partir de l'hôte. | ` commonchecks metric-kafka-zookeeper` \[marqueurs\] Où le marqueur est le suivant : `-p, --adminserverport `= Port du serveur d'administration (par défaut \<\< 8085 \>\>) Exemple d'utilisation : `commonchecks metric-kafka-zookeeper -p 8085` | hostname.Kafka.Zookeeper.outstanding_requests 2.000 1648183249 hostname.Kafka.Zookeeper.avg_latency 1.05 1648183249 hostname.Kafka.Zookeeper.num_alive_connections 1.000 1648183249 hostname.Kafka.Zookeeper.open_file_descriptor_count 124.000 1648183249 | [Tableau 4. Mesures Zookeeper Apache Kafka] {#kafka-checks-policies__table_ds2_3fm_f5b}