20.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: kafka-metrics
             key: kafka-metrics-config.yml
   ---
   kind: ConfigMap 

   2

   
   apiVersion: v1
   metadata:
     name: kafka-metrics
     labels:
       app: strimzi
   data:
     kafka-metrics-config.yml: |
     # metrics configuration...

   1

   复制 metricsConfig 属性，以引用包含指标配置的 ConfigMap。

   2

   复制指定指标配置的整个 ConfigMap。

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

   
       groupExcludeRegex: "^excluded-.*" 

   4

   
       topicExcludeRegex: "^excluded-.*" 

   5

   
       resources: 

   6

   
         requests:
           cpu: 200m
           memory: 64Mi
         limits:
           cpu: 500m
           memory: 128Mi
       logging: debug 

   7

   
       enableSaramaLogging: true 

   8

   
       template: 

   9

   
         pod:
           metadata:
             labels:
               label1: value1
           imagePullSecrets:
             - name: my-docker-credentials
           securityContext:
             runAsUser: 1000001
             fsGroup: 0
           terminationGracePeriodSeconds: 120
       readinessProbe: 

   10

   
         initialDelaySeconds: 15
         timeoutSeconds: 5
       livenessProbe: 

   11

   
         initialDelaySeconds: 15
         timeoutSeconds: 5
   # ...

   1

   ADVANCED OPTION：容器镜像配置，这只在特殊情况下建议使用。

   2

   指定指标中包含的消费者组的正则表达式。

   3

   指定指标中包含的主题的正则表达式。

   4

   指定指标中要排除的消费者组的正则表达式。

   5

   在指标中指定要排除的主题的正则表达式。

   6

   要保留的 CPU 和内存资源。

   7

   日志记录配置，以记录具有给定严重性(debug、info、warn、error、fatal)或以上的消息。

   8

   启用 Sarama 日志记录的布尔值，这是 Kafka Exporter 使用的 Go 客户端库。

   9

   自定义部署模板和 pod。

   10

   健康检查就绪度探测。

   11

   健康检查存活度探测。