17.4. Kafka Exporter の実行
Kafka Exporter を実行して、Grafana ダッシュボードでのプレゼンテーション用に Prometheus メトリクスを公開します。
Kafka Exporter を Streams for Apache Kafka と共に使用するには、Kafka Exporter パッケージをダウンロードしてインストールします。パッケージをダウンロードしてインストールするには、Streams for Apache Kafka サブスクリプションが必要です。
前提条件
- Streams for Apache Kafka が 各ホストにインストールされており、設定ファイルが使用可能である。
- Streams for 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 サーバーのホスト/ポストアドレス。
kafka:9092
kafka.version
Kafka ブローカーのバージョン。
1.0.0
group.filter
メトリクスに含まれるコンシューマーグループを指定する正規表現。
.*
(すべて)topic.filter
メトリクスに含まれるトピックを指定する正規表現。
.*
(すべて)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
を使用できます。Kafka Exporter メトリックを監視するように Prometheus を設定します。
Prometheus の設定に関する詳細は、Prometheus のドキュメント を参照してください。
Grafana を有効にして、Prometheus によって公開される Kafka Exporter メトリックデータを表示します。
詳細は、Grafana での Kafka Exporter メトリクスの表示 を参照してください。
Kafka Exporter の更新
Streams for Apache Kafka インストールで最新バージョンの Kafka Exporter を使用します。
更新を確認するには、次を使用します。
dnf check-update
Kafka Exporter を更新するには、以下を使用します。
dnf update kafka_exporter