17.4. 运行 Kafka Exporter
运行 Kafka Exporter,在 Grafana 仪表板中公开 Prometheus 指标。
下载并安装 Kafka Exporter 软件包,以使用带有 Apache Kafka 的 Streams 的 Kafka Exporter。您需要一个 Streams for Apache Kafka 订阅才能下载并安装软件包。
先决条件
- 每个主机上安装了 Apache Kafka 的流,且配置文件可用。
- 您有一个 Apache Kafka 订阅。
此流程假设您已经访问 Grafana 用户界面,并添加了 Prometheus 作为数据源。
流程
安装 Kafka Exporter 软件包:
dnf install kafka_exporter
验证软件包是否已安装:
dnf info kafka_exporter
使用适当的配置参数值运行 Kafka Exporter:
kafka_exporter --kafka.server=<kafka_bootstrap_address>:9092 --kafka.version=3.7.0 --<my_other_parameters>
参数需要双假设惯例,如
--kafka.server
。表 17.4. Kafka Exporter 配置参数 选项 描述 默认 kafka.server
Kafka 服务器的 host/post 地址。
kafka:9092
kafka.version
Kafka 代理版本。
1.0.0
group.filter
指定指标中包含的消费者组的正则表达式。
adtrust
(all)topic.filter
指定指标中包含的主题的正则表达式。
adtrust
(all)sasl.<parameter>
使用 SASL/PLAIN 身份验证启用和连接到 Kafka 集群的参数,使用用户名和密码。
false
tls.<parameter>
启用使用 TLS 身份验证连接到 Kafka 集群的参数,以及可选的证书和密钥。
false
web.listen-address
公开指标的端口地址。
:9308
web.telemetry-path
公开指标的路径。
/metrics
log.level
日志记录配置,以记录给定严重性(debug、info、warn、error、fatal)或更高严重性的消息。
info
log.enable-sarama
启用 Sarama 日志记录的布尔值,这是 Kafka Exporter 使用的 Go 客户端库。
false
legacy.partitions
布尔值,以启用从非活动主题分区以及活跃的分区中获取指标。如果您希望 Kafka Exporter 返回不活跃分区的指标,设置为
true
。false
您可以使用
kafka_exporter --help
来获取有关属性的信息。配置 Prometheus 以监控 Kafka 导出器指标。
有关配置 Prometheus 的更多信息,请参阅 Prometheus 文档。
启用 Grafana 以显示 Prometheus 公开的 Kafka 导出器指标数据。
如需更多信息,请参阅在 Grafana 中呈现 Kafka Exporter 指标。
更新 Kafka Exporter
使用带有 Apache Kafka 安装的 Streams 的 Kafka Exporter 的最新版本。
要检查更新,请使用:
dnf check-update
要更新 Kafka Exporter,请使用:
dnf update kafka_exporter