第 129 章 KafkaBridgeSpec 模式参考

Kafka Bridge 具有自己的可配置的日志记录器：

您可以替换 logger.<operation-id> logger 中的 <operation-id> 来为特定操作设置日志级别：

每个操作都由 OpenAPI 规格定义，并具有来自 HTTP 客户端的请求的对应 API 端点。您可以更改每个端点的日志级别，以创建有关传入和传出 HTTP 请求的细粒度日志记录信息。

每个日志记录器都必须配置为为它分配一个 name 作为 http.openapi.operation.<operation-id>。例如，为 发送 操作日志记录器配置日志级别意味着定义以下内容：

logger.send.name = http.openapi.operation.send
logger.send.level = DEBUG

logger.send.name = http.openapi.operation.send
logger.send.level = DEBUG

Kafka Bridge 使用 Apache log4j2 日志记录器实现。日志记录器在 log4j2.properties 文件中定义，该文件对 healthy 和 ready 端点有以下默认配置：

logger.healthy.name = http.openapi.operation.healthy
logger.healthy.level = WARN
logger.ready.name = http.openapi.operation.ready
logger.ready.level = WARN

logger.healthy.name = http.openapi.operation.healthy
logger.healthy.level = WARN
logger.ready.name = http.openapi.operation.ready
logger.ready.level = WARN

所有其他操作的日志级别默认设置为 INFO。

使用 logging 属性配置日志记录器和日志记录器级别。

您可以通过直接指定日志记录器和级别（在线）或使用自定义（外部） ConfigMap 来设置日志级别。如果使用 ConfigMap，您可以将 logging.valueFrom.configMapKeyRef.name 属性设置为包含外部日志记录配置的 ConfigMap 的名称。logging.valueFrom.configMapKeyRef.name 和 logging.valueFrom.configMapKeyRef.key 属性是必需的。如果没有设置 name 或 key，则会使用默认日志记录。在 ConfigMap 中，日志记录配置使用 log4j.properties 描述。有关日志级别的更多信息，请参阅 Apache 日志记录服务。

在这里，我们看到 内联 和 外部日志记录 的示例。

apiVersion: kafka.strimzi.io/v1beta2
kind: KafkaBridge
spec:
  # ...
  logging:
    type: inline
    loggers:
      rootLogger.level: INFO
      # enabling DEBUG just for send operation
      logger.send.name: "http.openapi.operation.send"
      logger.send.level: DEBUG
  # ...

apiVersion: kafka.strimzi.io/v1beta2
kind: KafkaBridge
spec:
  # ...
  logging:
    type: inline
    loggers:
      rootLogger.level: INFO
      # enabling DEBUG just for send operation
      logger.send.name: "http.openapi.operation.send"
      logger.send.level: DEBUG
  # ...

apiVersion: kafka.strimzi.io/v1beta2
kind: KafkaBridge
spec:
  # ...
  logging:
    type: external
    valueFrom:
      configMapKeyRef:
        name: customConfigMap
        key: bridge-logj42.properties
  # ...

apiVersion: kafka.strimzi.io/v1beta2
kind: KafkaBridge
spec:
  # ...
  logging:
    type: external
    valueFrom:
      configMapKeyRef:
        name: customConfigMap
        key: bridge-logj42.properties
  # ...

任何未配置的可用日志记录器将其级别设置为 OFF。

如果使用 Cluster Operator 部署 Kafka Bridge，则动态应用对 Kafka Bridge 日志记录级别的更改。

如果使用外部日志记录，则会在日志附加程序更改时触发滚动更新。