Digma Persistence Service 镜像文档

概述

Digma Persistence Service 是 Digma 可观测性平台的关键基础设施组件，专注于平台全量数据的持久化存储与生命周期管理。该服务处理并存储来自 Digma 生态的监控指标、分布式追踪链路、应用日志及分析洞察数据，为平台提供稳定的数据持久化能力，支撑长期趋势分析、问题根因定位及合规审计需求。

核心功能与特性

• 多类型数据持久化：统一存储监控指标（Metrics）、分布式追踪（Traces）、日志（Logs）及分析结果（Analytics）
• 数据高可用保障：支持数据冗余存储与自动故障转移，确保服务中断时数据完整性
• 灵活存储后端适配：兼容本地文件系统、关系型数据库（PostgreSQL/MySQL）及对象存储（S3/MinIO）
• 智能数据生命周期管理：支持基于时间/大小的自动数据清理、归档策略，优化存储资源占用
• 数据备份与恢复机制：提供定时自动备份与手动触发备份功能，支持全量/增量数据恢复
• 高性能数据读写：针对时序数据特性优化存储结构，提升高并发场景下的数据读写效率

适用场景

• Digma 平台部署必备组件：作为 Digma 可观测性平台的核心依赖，需与 Digma Collector、UI 组件协同部署
• 微服务架构可观测性数据存储：支撑大规模微服务集群的全链路追踪数据与监控指标长期存储
• DevOps 持续优化：为研发团队提供应用性能历史数据，支持迭代优化效果量化分析
• 企业级合规审计：满足***、电商等行业对系统运行数据的长期留存与审计追溯要求

使用方法与配置说明

环境要求

• Docker Engine 20.10+ 或 Kubernetes 1.21+
• 存储后端（文件系统/数据库/对象存储）需提前部署并配置访问权限

快速启动（Docker Run）

bash
docker run -d \
  --name digma-persistence \
  -p 8085:8080 \
  -v /opt/digma/persistence:/data \
  -e STORAGE_BACKEND=postgresql \
  -e DB_HOST=postgres-service \
  -e DB_PORT=5432 \
  -e DB_USER=digma_persist \
  -e DB_PASSWORD=SecurePass123! \
  -e DB_NAME=digma_persistence \
  -e DATA_RETENTION_DAYS=90 \
  -e LOG_LEVEL=info \
  digma/persistence-service:latest

核心配置参数（环境变量）

Docker Compose 部署示例

yaml
version: '3.8'

services:
  digma-persistence:
    image: digma/persistence-service:latest
    container_name: digma-persistence
    restart: always
    ports:
      - "8085:8080"
    volumes:
      - digma-persistence-data:/data
      - digma-backup:/backup
    environment:
      - STORAGE_BACKEND=postgresql
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_USER=digma
      - DB_PASSWORD=DigmaDBPass!2024
      - DB_NAME=digma_persistence
      - DATA_RETENTION_DAYS=180
      - BACKUP_ENABLED=true
      - BACKUP_INTERVAL_HOURS=12
      - LOG_LEVEL=warn
    depends_on:
      - postgres

  postgres:
    image: postgres:14-alpine
    container_name: digma-postgres
    restart: always
    environment:
      - POSTGRES_USER=digma
      - POSTGRES_PASSWORD=DigmaDBPass!2024
      - POSTGRES_DB=digma_persistence
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  digma-persistence-data:
  digma-backup:
  postgres-data:

数据备份与恢复操作

手动触发备份

bash
# 进入容器执行备份命令
docker exec -it digma-persistence /app/bin/backup.sh --full --output /backup/manual_backup_$(date +%Y%m%d_%H%M%S).tar.gz

数据恢复

bash
# 从备份文件恢复数据
docker exec -it digma-persistence /app/bin/restore.sh --input /backup/manual_backup_20240520_***.tar.gz

注意事项

• 生产环境建议使用数据库或对象存储作为后端，避免本地文件系统单点故障风险
• 数据保留天数设置需结合业务需求与存储容量规划，建议定期监控存储空间使用情况
• 服务升级前建议执行手动全量备份，避免数据结构变更导致的兼容性问题
• 高并发场景下需根据数据量调整容器CPU/内存资源分配（建议至少2核4GB）