如何在默认Camunda 7 Docker容器中启用指定调试日志？

针对你需要开启的三个日志器（org.camunda.bpm.engine.impl.persistence.entity.JobEntity、org.camunda.bpm.engine.jobexecutor、org.camunda.bpm.engine.cmd），在默认Camunda 7 Docker容器中有两种常用方式开启DEBUG级别日志：

方法一：通过环境变量快速开启（临时调试首选） #

Camunda官方Docker镜像支持通过环境变量直接配置日志级别，规则是将日志包路径中的.替换为_并转为大写，后缀加上_LEVEL。

启动容器时添加以下环境变量即可：

• LOGGING_ORG_CAMUNDA_BPM_ENGINE_IMPL_PERSISTENCE_ENTITY_JOBENTITY_LEVEL=DEBUG
• LOGGING_ORG_CAMUNDA_BPM_ENGINE_JOBEXECUTOR_LEVEL=DEBUG
• LOGGING_ORG_CAMUNDA_BPM_ENGINE_CMD_LEVEL=DEBUG

示例Docker启动命令：

docker run -d \
  -p 8080:8080 \
  -e LOGGING_ORG_CAMUNDA_BPM_ENGINE_IMPL_PERSISTENCE_ENTITY_JOBENTITY_LEVEL=DEBUG \
  -e LOGGING_ORG_CAMUNDA_BPM_ENGINE_JOBEXECUTOR_LEVEL=DEBUG \
  -e LOGGING_ORG_CAMUNDA_BPM_ENGINE_CMD_LEVEL=DEBUG \
  camunda/camunda-bpm-platform:latest

如果使用Docker Compose，可在docker-compose.yml中添加环境配置：

services:
  camunda:
    image: camunda/camunda-bpm-platform:latest
    ports:
      - "8080:8080"
    environment:
      - LOGGING_ORG_CAMUNDA_BPM_ENGINE_IMPL_PERSISTENCE_ENTITY_JOBENTITY_LEVEL=DEBUG
      - LOGGING_ORG_CAMUNDA_BPM_ENGINE_JOBEXECUTOR_LEVEL=DEBUG
      - LOGGING_ORG_CAMUNDA_BPM_ENGINE_CMD_LEVEL=DEBUG

方法二：挂载自定义Logback配置文件（持久化配置） #

默认容器使用Logback作为日志框架，配置文件路径为/camunda/conf/logback.xml。你可以本地创建修改后的配置文件，添加目标日志器的DEBUG级别设置：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <!-- 保留原有默认配置内容 -->
  
  <!-- 添加需要开启的DEBUG日志器 -->
  <logger name="org.camunda.bpm.engine.impl.persistence.entity.JobEntity" level="DEBUG" />
  <logger name="org.camunda.bpm.engine.jobexecutor" level="DEBUG" />
  <logger name="org.camunda.bpm.engine.cmd" level="DEBUG" />
  
  <!-- 原有默认配置的其他部分 -->
</configuration>

然后通过挂载方式将本地配置文件替换容器内的默认文件：

docker run -d \
  -p 8080:8080 \
  -v /本地路径/logback.xml:/camunda/conf/logback.xml \
  camunda/camunda-bpm-platform:latest

这种方式适合需要长期保留日志配置的场景，重启容器后配置不会丢失。

内容的提问来源于stack exchange，提问作者Mormund