kafkakit-prometheus-metricsfetcher

README

kafkakit-prometheus-metricsfetcher

Prometheus metricsfetcher for kafka-kit.

This fool fetches partition and storage metrics from Prometheus and stores them using original format in ZooKeeper.

Motivation

I was looking for a tool that fetches data from Prometheus and imports it to ZooKeeper for kafka-kit. There is an issue in kafka-kit project, from comments I found a project BatchLabs/kafkakit-prometheus, unfortunately it fetches data directly from Prometheus exporters instead of fetching data from Prometheus (it works fine if you have regular hosts for Kafka, with Kubernetes it can be a bit more complicated).

Following BatchLabs/kafkakit-prometheus example I wrote similar tool.

Requirements

• Go 1.13 (probably works also with 1.12)
• Prometheus endpoint

Installation

go get github.com/tikivn/kafkakit-prometheus-metricsfetcher

Usage

See the help of the command:

Usage of kafkakit-prometheus-metricsfetcher:
    --broker-id-label string              Prometheus label for broker ID (default "instance")
    --broker-storage-query string         Prometheus query to get broker storage free space
    --dry-run                             Fetch the metrics but don't write them to ZooKeeper, instead print them
    --partition-size-query string         Prometheus query to get partition size by topic
    --prometheus-query-timeout duration   Timeout for Prometheus queries (default 30s)
    --prometheus-node-url string          Prometheus URL
    --prometheus-kafka-url string         Prometheus URL
    --zk-addr string                      Zookeeper host (default "localhost:2181")

Example:

kafkakit-prometheus-metricsfetcher --prometheus-node-url http://dev.prometheus.tiki.services \
    --prometheus-kafka-url http://dev.prometheus.tiki.services \
    --broker-storage-query 'avg(label_replace(kubelet_volume_stats_available_bytes{namespace="kafka",persistentvolumeclaim=~"data-kafka-[1-9]+"},"broker_id","$1","persistentvolumeclaim","data-kafka-([0-9]+)")) by (broker_id)' \
    --partition-size-query 'max(kafka_log_log_size{namespace="kafka"}) by (topic,partition)'

partition-size-query must have topic and partition labels.

broker-storage-query expects instance label by default, but it can be changed using --broker-id-label flag.

Additional notes

This tool has no support using authentication when connecting to ZooKeeper, if you have authentication enabled in ZooKeeper, then it might be necessary to create /topicmappr node beforehand, otherwise kafkakit-prometheus-metricsfetcher may fail with following message:

unable to create node /topicmappr. err: zk: not authenticated

/topicmappr node can be created using zkCli.sh:

cat > jaas.conf << EOF
Client {
       org.apache.zookeeper.server.auth.DigestLoginModule required
       username="foo"
       password="bar";
};
EOF

export CLIENT_JVMFLAGS="$CLIENT_JVMFLAGS -Djava.security.auth.login.config=jaas.conf"

bin/zkCli.sh -server localhost:2181

[zk: localhost:2181(CONNECTED) 20] create /topicmappr
Created /topicmappr

Ensure /topicmappr node has correct permissions:

[zk: localhost:2181(CONNECTED) 29] getAcl /topicmappr
'world,'anyone
: cdrwa

Acknowledgments

• Thank you authors of BatchLabs/kafkakit-prometheus