Apache Kafka Vérifications et politiques par défaut

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • Agent Client Collector fournit les politiques suivantes pour Apache Kafka la surveillance de l’intégrité. Les politiques sont fournies avec les vérifications spécifiées dans la table indiquée. Des politiques et des vérifications sont disponibles pour les deux Windows et Linux.

    Tableau 1. Apache Kafka Événements de rubriques
    Vérifier Description Utilisation Sortie
    kafka.check-zookeeper-status Déclenche un événement critique si le Kafka Zookeeper hébergé est en panne. commonchecks check-kafka-zk-status [indicateurs]

    Où se trouvent les drapeaux :

    -p, --port = Port Zookeeper (par défaut : « 2181 »).

    Exemple d’utilisation : commonchecks check-kafka-zk-status -p 2181

    		 État de Kafka Zookeeper OK : Kafka Zookeeper est en place !
    kafka.check-topic-replicas Déclenche un événement critique si une rubrique possède des partitions avec des réplicas inconnus. commonchecks check-kafka-replicas [indicateurs]

    Où se trouvent les drapeaux :

    • -p, --port = Port Zookeeper (par défaut : « 2181 »).
    • -d, --detailed = Répertorie les répliques inconnues dans chaque partition d’une rubrique.
    • -i, --include_list = Liste séparée par des virgules pour inclure des rubriques (autorise le caractère générique *)
    • -e, --exclude_list = Liste séparée par des virgules pour exclure les rubriques (autorise le caractère générique *)
    Exemple d’utilisation : commonchecks check-kafka-replicas -H localhost -p 2181 -i « test* » -e « accTopic,*offsets » -d

    <rubrique> a des partitions avec des répliques inconnues. Les répliques inconnues sont : {"0 » :["0"],"1 » :["0"],"2 » :["0"]}.

    <rubrique> 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 [indicateurs]

    Où se trouvent les drapeaux :

    • -p, --port = Port Zookeeper (par défaut : « 2181 »).
    • -d, --detailed = Répertorie les répliques inconnues dans chaque partition d’une rubrique.
    • -i, --include_list = Liste séparée par des virgules pour inclure des rubriques (autorise le caractère générique *)
    • -e, --exclude_list = Liste séparée par des virgules pour exclure les rubriques (autorise le caractère générique *)
    • -r, --replication factor = facteur de réplication attendu pour une rubrique (1 par défaut)

    Exemples : commonchecks check-kafka-partitions -H localhost -p 2181 -r 2 -i « accMetrics,*Topic » -e « testTopic »

    TestTopic a un facteur de réplication 1, qui est inférieur à celui attendu : 2.

    accMetrics a un facteur de réplication 1, qui est inférieur à celui attendu : 2.
    kafka.check-topic-leader Déclenche un événement critique si une rubrique possède des partitions avec des amorces inconnues ou une réplique non préférée comme amorce. commonchecks check-kafka-leader [indicateurs]

    Où se trouvent les drapeaux

    • -p, --port = Port Zookeeper (par défaut : « 2181 »).
    • -d, --detailed = Une liste de partitions dans chaque rubrique avec des repères inconnus ou des répliques non préférées.
    • -i, --include_list = Liste séparée par des virgules pour inclure des rubriques (autorise le caractère générique *)
    • -e, --exclude_list =Liste séparée par des virgules pour exclure les rubriques (autorise le caractère wild *)

    Exemples :

    commonchecks check-kafka-leader -H localhost -p 2181 -d -e « *décalages »

    <rubrique> contient les partitions avec un réplica non préféré en tant que leader. (les partitions avec des répliques non préférées sont [0]).

    <rubrique> contient les partitions avec un réplica non préféré en tant que leader. (les partitions avec des répliques 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 [indicateurs]

    Où se trouvent les drapeaux :

    • -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 (autorise le caractère générique *)
    • -e, --exclude_list =Liste séparée par des virgules pour exclure les rubriques (autorise le caractère wild *)

    Exemple d’utilisation 1 : commonchecks check-kafka-partitions -H localhost -p 2181 -P 3

    <rubrique> a 1 partition, attendu au moins 3.

    <rubrique> a 1 partition, attendu au moins 3.

    <rubrique> a 1 partition, attendu au moins 3.
    Exemple d’utilisation 2 : commonchecks check-kafka-partitions -H localhost -p 2181 -P 3 -i « accMetrics,*Topic » -e « testTopic »

    <rubrique> a 1 partition, attendu au moins 3.

    <rubrique> a 1 partition, attendu au moins 3.
    Remarque :
    Les valeurs des paramètres include_list et exclude_list doivent être placées entre guillemets doubles. Par exemple : « test1,*topic ».
    Tableau 2. Apache Kafka Événements des courtiers
    Vérifier Description Utilisation Sortie
    kafka.check-broker-status Déclenche un événement critique si le courtier Kafka sur l’hôte est en panne. commonchecks check-kafka-broker-status [marqueurs]

    Où se trouvent les drapeaux :

    -p, --port = port Kafka Broker (par défaut : « 9092 »).

    Exemple d’utilisation : commonchecks check-kafka-broker-status -p 9092

    		 État du courtier Kafka OK : le courtier Kafka ubuntu20:9092 est en place !
    Tableau 3. Apache Kafka Mesures du courtier
    Vérifier Description Utilisation Sortie
    kafka.metrics.broker Collecte les mesures du courtier Kafka à partir de l’hôte. CommonChecks metric-kafka-broker [indicateurs]
    Où se trouvent les drapeaux :
    • -J, --javapath = chemin de l’exécutable Java (par défaut « java »).
    • -j, --jmxport = Port JMX (par défaut « 9999 »)

    Exemple d’utilisation : commonchecks metric-kafka-broker -J « /usr/bin/java » -j 9999

    nom d’hôte. Kafka.Courtier.ReplicaManager.IsrExpandsPerSec.OneMinuteRate 0,000

    nom d’hôte. Kafka.Courtier.OpérationRetardéePurgatoire.TaillePurgatoire.Fetch.Valeur 627.000

    nom d’hôte. Kafka.Broker.ControllerStats.UncleanLeaderElectionsPerSec.OneMinuteRate 0.000

    nom d’hôte. Kafka.Courtier.MesuresDemandes.DemandesPerSec.Produire.OneMinuteRate 0,000
    Tableau 4. Apache Kafka Mesures Zookeeper
    Vérifier Description Utilisation Sortie
    kafka.metrics.zookeeper Collecte les mesures Zookeeper de l’hôte. CommonChecks metric-kafka-zookeeper [indicateurs]

    Où le marqueur est : -p, --adminserverport = Port du serveur administrateur (par défaut « 8085 »)

    Exemple d’utilisation : commonchecks metric-kafka-zookeeper -p 8085

    nom d’hôte. Kafka.Zookeeper.outstanding_requests 2.000 1648183249

    nom d’hôte. Kafka.Zookeeper.avg_latency 1,05 1648183249

    nom d’hôte. Kafka.Zookeeper.num_alive_connections 1.000 1648183249

    nom d’hôte. Kafka.Zookeeper.open_file_descriptor_count 124.000 1648183249