cortexproject/thanosconvert

镜像概述

该Docker镜像提供了一个轻量级工具，专门用于将Thanos和Prometheus数据块转换为Cortex兼容的数据块格式，便于监控系统间的数据迁移与整合。

核心功能与特性

• 多源支持：兼容Thanos和Prometheus两种源数据块格式
• 目标兼容：输出符合Cortex数据块规范的文件，确保与Cortex集群无缝集成
• 块完整性：转换过程中保持时序数据的完整性与准确性
• 元数据处理：自动处理数据块元数据转换，确保监控标签等信息正确映射

使用场景

• 监控系统迁移：从Prometheus/Thanos架构迁移至Cortex时，转换历史数据块
• 混合架构整合：在同时运行Prometheus/Thanos和Cortex的环境中，统一数据存储格式
• 数据备份恢复：将Prometheus/Thanos备份数据转换为Cortex可用格式进行恢复

使用方法

基本使用（Docker Run）

通过挂载本地目录指定源数据块路径和目标输出路径：

bash
docker run --rm \
  -v /local/prometheus-blocks:/source \  # 源数据块目录（Thanos/Prometheus）
  -v /local/cortex-blocks:/dest \      # 目标输出目录（Cortex）
  [镜像名称]:[标签] \
  convert \
  --source /source \
  --dest /dest

高级配置参数

示例：转换Thanos数据块至Cortex

bash
docker run --rm \
  -v /data/thanos-data:/source \
  -v /data/cortex-data:/dest \
  [镜像名称]:latest \
  convert \
  --source /source \
  --dest /dest \
  --log-level debug \
  --workers 4

注意事项

1. 确保源数据块目录包含完整的Prometheus/Thanos数据块结构（通常包含chunks、meta.json等文件）
2. 目标目录需具备写入权限，转换前建议备份目标目录中已有数据
3. 对于对象存储中的数据块（如S3-backed Thanos块），需通过环境变量配置存储访问凭证（如AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY等）