Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/redpanda-data/kminion
KMinion is a feature-rich Prometheus exporter for Apache Kafka written in Go. It is lightweight and highly configurable so that it will meet your requirements.
https://github.com/redpanda-data/kminion
consumer consumer-group exporter group kafka lag prometheus prometheus-exporter
Last synced: 3 months ago
JSON representation
KMinion is a feature-rich Prometheus exporter for Apache Kafka written in Go. It is lightweight and highly configurable so that it will meet your requirements.
- Host: GitHub
- URL: https://github.com/redpanda-data/kminion
- Owner: redpanda-data
- License: mit
- Created: 2019-02-11T12:28:56.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-11-03T16:15:32.000Z (3 months ago)
- Last Synced: 2024-11-03T16:28:01.626Z (3 months ago)
- Topics: consumer, consumer-group, exporter, group, kafka, lag, prometheus, prometheus-exporter
- Language: Go
- Homepage:
- Size: 8.15 MB
- Stars: 620
- Watchers: 56
- Forks: 122
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ccamel - redpanda-data/kminion - KMinion is a feature-rich Prometheus exporter for Apache Kafka written in Go. It is lightweight and highly configurable so that it will meet your requirements. (Go)
README
# Prometheus Exporter for Apache Kafka - KMinion
KMinion (previously known as Kafka Minion) is a feature-rich and flexible Prometheus Exporter to monitor your Apache
Kafka cluster. All valuable information that are accessible via the Kafka protocol are supposed to be accessible using
KMinion.
## 🚀 Features
- **Kafka versions:** Supports all Kafka versions v0.11+
- **Supported SASL mechanisms:** plain, scram-sha-256/512, gssapi/kerberos
- **TLS support:** TLS is supported, regardless whether you need mTLS, a custom CA, encrypted keys or just the trusted
root certs
- **Consumer Group Lags:** Number of messages a consumer group is lagging behind the latest offset
- **Log dir sizes:** Metric for log dir sizes either grouped by broker or by topic
- **Broker info:** Metric for each broker with its address, broker id, controller and rack id
- **Configurable granularity:** Export metrics (e.g. consumer group lags) either per partition or per topic. Helps to reduce the number of exported metric series.
- **End to End Monitoring:** Sends messages to its own topic and consumes them, measuring a messages real-world "roundtrip" latency. Also provides ack-latency and offset-commit-latency. [More Info](/docs/end-to-end.md)
- **Configurable targets:** You can configure what topics or groups you'd like to export using regex expressions
- **Multiple config parsers:** It's possible to configure KMinion using YAML, Environment variables or a mix of both
You can find a list of all exported metrics here: [/docs/metrics.md](/docs/metrics.md)
## Getting started
### 🐳 Docker image
All images will be built on each push to master or for every new release. You can find an overview of all available tags
in our [DockerHub repository](https://hub.docker.com/r/redpandadata/kminion/tags).
```shell
docker pull redpandadata/kminion:latest
```
### ☸ Helm chart
A Helm chart will be maintained as part of this repository under [/charts](/charts).
### 🔧 Configuration
All options in KMinion can be configured via YAML or environment variables. Configuring some options via YAML and some
via environment variables is also possible. Environment variables take precedence in this case. You can find the
reference config with additional documentation in [/docs/reference-config.yaml](/docs/reference-config.yaml).
If you want to use a YAML config file, specify the path to the config file by setting the env variable
`CONFIG_FILEPATH`.
### 📊 Grafana Dashboards
I uploaded three separate Grafana dashboards that can be used as inspiration in order to create your own dashboards. Please take note that these dashboards might not immediately work for you due to different labeling in your Prometheus config.
Cluster Dashboard: https://grafana.com/grafana/dashboards/14012
Consumer Group Dashboard: https://grafana.com/grafana/dashboards/14014
Topic Dashboard: https://grafana.com/grafana/dashboards/14013
### ⚡ Testing locally
This repo contains a docker-compose file that you can run on your machine. It will spin up a Kafka & ZooKeeper cluster
and starts KMinion on port 8080 which is exposed to your host machine:
```shell
# 1. Clone this repo
# 2. Browse to the repo's root directory and run:
docker-compose up
```
## Chat with us
We use Slack to communicate. If you are looking for more interactive discussions or support, you are invited to join
our Slack server: https://redpanda.com/slack
## License
KMinion is distributed under the [MIT License](https://github.com/cloudhut/kminion/blob/master/LICENSE).