8.4. Prometheus メトリクス設定のデプロイ

手順

1. Prometheus 設定でカスタムリソースのサンプルをデプロイします。

   たとえば、Kafka リソースごとに kafka-metrics.yaml ファイルを適用します。

   サンプル設定のデプロイ

   oc apply -f kafka-metrics.yaml

   または、kafka-metrics.yaml の設定例を独自の Kafka リソースにコピーすることもできます。

   サンプル設定のコピー

   oc edit kafka <kafka-configuration-file>

   metricsConfig プロパティーと、Kafka リソースを参照する ConfigMap をコピーします。

   Kafka のメトリクス設定例

   apiVersion: kafka.strimzi.io/v1beta2
   kind: Kafka
   metadata:
     name: my-cluster
   spec:
     kafka:
       # ...
       metricsConfig: 1
         type: jmxPrometheusExporter
         valueFrom:
           configMapKeyRef:
             name: my-config-map
             key: my-key
   ---
   kind: ConfigMap 2
   apiVersion: v1
   metadata:
     name: kafka-metrics
     labels:
       app: strimzi
   data:
     kafka-metrics-config.yml: |
     # metrics configuration...

   1

   メトリクス設定が含まれる ConfigMap を参照する metricsConfig プロパティーをコピーします。

   2

   メトリクス設定を指定する ConfigMap 全体をコピーします。

   注記

   Kafka Bridge の場合、enableMetrics プロパティーを指定し、これを true に設定します。

   apiVersion: kafka.strimzi.io/v1beta2
   kind: KafkaBridge
   metadata:
     name: my-bridge
   spec:
     # ...
     bootstrapServers: my-cluster-kafka:9092
     http:
       # ...
     enableMetrics: true
     # ...

2. Kafka Exporter をデプロイするには、kafkaExporter 設定を追加します。

   KafkaExporter 設定は、Kafka リソースでのみ指定されます。

   Kafka Exporter のデプロイの設定例

   apiVersion: kafka.strimzi.io/v1beta2
   kind: Kafka
   metadata:
     name: my-cluster
   spec:
     # ...
     kafkaExporter:
       image: my-registry.io/my-org/my-exporter-cluster:latest 1
       groupRegex: ".*" 2
       topicRegex: ".*" 3
       resources: 4
         requests:
           cpu: 200m
           memory: 64Mi
         limits:
           cpu: 500m
           memory: 128Mi
       logging: debug 5
       enableSaramaLogging: true 6
       template: 7
         pod:
           metadata:
             labels:
               label1: value1
           imagePullSecrets:
             - name: my-docker-credentials
           securityContext:
             runAsUser: 1000001
             fsGroup: 0
           terminationGracePeriodSeconds: 120
       readinessProbe: 8
         initialDelaySeconds: 15
         timeoutSeconds: 5
       livenessProbe: 9
         initialDelaySeconds: 15
         timeoutSeconds: 5
   # ...

   1

   高度なオプションコンテナイメージの設定。これは 特別な状況でのみ推奨されます。

   2

   メトリクスに含まれるコンシューマーグループを指定する正規表現。

   3

   メトリクスに含まれるトピックを指定する正規表現。

   4

   予約する CPU およびメモリーリソース。

   5

   指定の重大度 (debug、info、warn、error、fatal) 以上でメッセージをログに記録するためのログ設定。

   6

   Sarama ロギングを有効にするブール値 (Kafka Exporter によって使用される Go クライアントライブラリー)。

   7

   デプロイメントテンプレートおよび Pod のカスタマイズ。

   8

   ヘルスチェックの readiness プローブ。

   9

   ヘルスチェックの liveness プローブ。