21.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 属性及其引用的 ConfigMap 到 Kafka 资源。

   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

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

   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

   ProductShortName OPTION: 容器镜像配置，仅在特殊情况下推荐使用。

   2

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

   3

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

   4

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

   5

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

   6

   要保留的 CPU 和内存资源。

   7

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

   8

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

   9

   自定义部署模板和 pod。

   10

   健康检查就绪度探测。

   11

   健康检查存活度探测。