125장. KafkaBridgeSpec schema reference

Kafka 브릿지에는 구성 가능한 자체 로거가 있습니다.

로거에서 < operation-id >를 교체할 수 있습니다. <operation-id > 로거는 특정 작업에 대한 로그 수준을 설정합니다.

각 작업은 OpenAPI 사양에 따라 정의되며 브리지가 HTTP 클라이언트에서 요청을 수신하는 해당 API 끝점이 있습니다. 각 끝점에서 로그 수준을 변경하여 들어오고 나가는 HTTP 요청에 대한 세분화된 로깅 정보를 생성할 수 있습니다.

각 로거는 이름을 http.openapi.operation로 할당합니다. <operation-id>. 예를 들어, 전송 작업 로거에 대한 로깅 수준을 구성하려면 다음을 정의하는 것을 의미합니다.

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

Kafka 브리지는 Apache log4j2 로거 구현을 사용합니다. 로거는 log4j2.properties 파일에 정의되어 있으며 정상 및 준비된 끝점에 대해 다음과 같은 기본 구성이 있습니다.

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 속성은 필수입니다. 이름 또는 키가 설정되지 않은 경우 기본 로깅이 사용됩니다. 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: external
    valueFrom:
      configMapKeyRef:
        name: customConfigMap
        key: bridge-logj42.properties
  # ...

구성되지 않은 사용 가능한 로거는 수준이 OFF 로 설정되어 있습니다.

Kafka 브리지가 Cluster Operator를 사용하여 배포된 경우 Kafka Bridge 로깅 수준에 대한 변경 사항이 동적으로 적용됩니다.

외부 로깅을 사용하는 경우 로깅 appender가 변경될 때 롤링 업데이트가 트리거됩니다.