camunda history-level 默认值是多少？

Question

Camunda 的 `history-level` 默认值是多少？在 Camunda BPM 引擎中，`history-level` 用于控制流程实例、任务和变量等历史数据的记录级别。常见的配置包括 `none`、`activity`、`audit` 和 `full`。许多用户在部署新环境时不清楚该参数的默认行为。若未显式配置 `history-level`，Camunda 会根据运行模式（如社区版或企业版）及配置方式（Spring Boot 自动配置或 standalone 部署）自动选择默认值。例如，在 Spring Boot 项目中，若未设置 `camunda.bpm.history-level`，引擎可能默认使用 `audit` 级别。理解默认值对性能、存储和审计功能有重要影响。因此，建议在生产环境中显式设置 `history-level`，以避免意外的历史数据记录开销。

Answer 1

1. Camunda 的 history-level 概述

在 Camunda BPM 引擎中，history-level 是一个核心配置参数，用于控制流程实例、任务、变量、作业等运行时数据的历史记录粒度。该设置直接影响数据库的存储开销、查询能力以及系统性能。

常见的 history-level 配置值包括：

• none：不保留任何历史数据，适用于对审计无要求且追求极致性能的场景。
• activity：记录流程活动（如用户任务开始/结束），但不记录变量变更。
• audit：记录流程活动和变量更新，支持基本的审计需求，是大多数生产环境的推荐级别。
• full：记录所有历史信息，包括详细变量变更、作业日志等，适合需要完整追溯的合规性系统。

2. 默认值的确定机制

Camunda 并未在所有部署模式下统一设定单一默认值，其行为依赖于部署方式与版本类型。以下是不同场景下的默认行为分析：

部署方式	版本类型	默认 history-level
Spring Boot 自动配置	社区版 / 企业版	audit
Standalone BPM Platform (非 Spring)	社区版	none
Camunda Run	社区版	audit
Docker 镜像启动（无显式配置）	社区版	audit
自定义 camunda.cfg.xml 未声明	任意	由实现决定

3. 深入源码与自动配置逻辑

以 Spring Boot 集成为例，Camunda 提供了 CamundaBpmAutoConfiguration 类，其中包含对 ProcessEngineConfiguration 的初始化逻辑。当未显式配置 history-level 时，Spring Boot Starter 会通过以下判断链：

if (config.getHistoryLevel() == null) {
  config.setHistoryLevel(ProcessEngineConfiguration.HISTORYLEVEL_AUDIT);
}

这表明，在基于 Spring Boot 的项目中，若未设置 camunda.bpm.history-level 属性，引擎将自动采用 audit 级别。这一设计旨在平衡功能完整性与性能，默认支持基本审计能力。

4. 不同部署模式的影响分析

对于非 Spring 环境（如传统 WAR 部署或嵌入式引擎），Camunda 社区版通常采用更保守策略，默认为 none，以避免不必要的数据库写入。而企业版在某些发行包中可能预设为 activity 或更高。

这种差异源于使用场景假设：

1. 开发者本地测试倾向于关闭历史以提升速度；
2. 生产级部署则期望具备可追溯性；
3. Spring Boot 用户更关注“开箱即用”的体验。

5. 性能与存储影响评估

选择不同的 history-level 将显著影响系统表现。以下是在高并发流程执行下的估算对比：

级别	每千次流程实例产生的记录数	平均响应延迟增加	磁盘占用增长率
none	~5	+5%	低
activity	~15	+15%	中
audit	~40	+30%	较高
full	~80+	+60%+	高

6. 推荐实践与最佳配置策略

针对生产环境，建议遵循以下原则：

• 始终显式配置 camunda.bpm.history-level，避免依赖隐式默认行为；
• 根据合规要求选择级别：audit 适用于大多数业务系统；
• 结合历史清理策略（historyCleanupStrategy）定期归档旧数据；
• 在压力测试环境中验证不同级别对吞吐量的影响；
• 使用监控工具跟踪 ACT_HI_* 表的增长趋势。

7. 配置示例与验证方法

在 application.yml 中显式设置：

camunda:
  bpm:
    history-level: audit
    database-schema-update: true

可通过以下 SQL 查询当前生效的历史级别：

SELECT NAME_, VALUE_ FROM ACT_GE_PROPERTY WHERE NAME_ = 'historyLevel';

8. 基于流程图的决策路径

以下是选择合适 history-level 的决策流程：

graph TD A[是否需要审计追踪?] -->|否| B[使用 none] A -->|是| C{是否需变量历史?} C -->|否| D[使用 activity] C -->|是| E{是否需完整作业日志?} E -->|否| F[使用 audit] E -->|是| G[使用 full]