Jaeger v2.1配置Badger后端时归档存储未初始化问题排查

• 检查归档存储的独立配置项
  确认config-badger.yml中是否单独配置了归档用的Badger实例——热存储与归档存储是两个独立的配置块，不能共用同一套配置。示例正确配置：

  storage:
    type: badger
    badger:
      # 热存储配置
      directory: /badger-data
      # 归档存储必须单独声明子配置块
      archive:
        directory: /badger-archive
        # 可选：配置归档数据的TTL时长
        ttl: 720h
  

  若仅配置热存储的directory、未添加archive子块，Jaeger会判定归档存储未初始化，直接抛出错误。

• 验证容器内归档目录的权限
  自行构建的镜像可能未创建/badger-archive目录，或目录权限不为Jaeger默认用户（UID 10001）可读写：

  • 可在Dockerfile中添加目录创建与权限设置：

    RUN mkdir -p /badger-archive && chown -R 10001:10001 /badger-archive
    

  • 或在docker-compose-v2.yml的Jaeger服务中，通过启动命令先初始化目录：

    command: ["sh", "-c", "mkdir -p /badger-archive && chown 10001:10001 /badger-archive && /go/bin/jaeger-all-in-one --config-file=/etc/jaeger/config-badger.yml"]
    

• 确认Docker Compose的挂载配置
  若使用卷或tmpfs挂载，需确保归档目录的挂载是独立的，不能与热存储共用：

  • 卷挂载示例：

    volumes:
      - badger-data:/badger-data
      - badger-archive:/badger-archive  # 独立卷，不可与热存储卷重复
    

  • tmpfs挂载示例：

    tmpfs:
      - /badger-data
      - /badger-archive  # 必须单独声明归档目录的tmpfs
    

• 检查Jaeger启动命令的参数冲突
  确保启动命令未用参数覆盖归档存储配置，例如不要传入空值或错误路径的--storage.badger.archive-directory参数——命令行参数优先级高于配置文件，会直接覆盖配置项。

• 查看Jaeger调试日志
  启动时添加--log-level=debug参数，查看详细初始化日志，排查是否存在目录创建失败、权限拒绝等具体报错，这些细节会直接指向归档存储初始化失败的原因。

内容的提问来源于stack exchange，提问作者Paweł Poręba