Vérifications et politiques par défaut de Apache Kafka

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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 et WindowsLinux.

    Tableau 1. Événements de rubriques Apache Kafka
    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é)
    Exemple d'utilisation : commonchecks check-kafka-replicas -H localhost -p 2181 -i "test*" -e "accTopic,*offsets" -d

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

    <topic> a des partitions avec des réplications 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)

    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é)

    Exemples :

    commonchecks check-kafka-leader -H localhost -p 2181 -d -e "*offsets"

    <topic> contains, partitions with unpreferred replica as leader.(partitions with unpreferred replicas are [0]). (<rubrique> 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]).)

    <topic> contains, partitions with unpreferred replica as leader.(partitions with unpreferred replicas are [0]). (<rubrique> 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é)

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

    <topic> has 1 partitions, expected at least 3. (<rubrique> possède 1 partition, attendues au moins 3.)

    <topic> has 1 partitions, expected at least 3. (<rubrique> possède 1 partition, attendues au moins 3.)

    <topic> has 1 partitions, expected at least 3. (<rubrique> possède 1 partition, attendues au moins 3.)
    Exemple d'utilisation 2 : commonchecks check-kafka-partitions -H localhost -p 2181 -P 3 -i "accMetrics,*Topic" -e "testTopic"

    <topic> has 1 partitions, expected at least 3. (<rubrique> possède 1 partition, attendues au moins 3.)

    <topic> has 1 partitions, expected at least 3. (<rubrique> possède 1 partition, attendues au moins 3.)
    Remarque :
    les valeurs des paramètres include_list et exclude_list doivent être placées entre guillemets doubles. P. ex. : "test1,*topic".
    Tableau 2. Événements de broker Apache Kafka
    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 3. Mesures de broker Apache Kafka
    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 »)

    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 4. Mesures Zookeeper Apache Kafka
    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