sumologic/thanos

Thanos镜像文档

镜像概述

本镜像为Thanos的Docker分发版本，源自quay.io/thanos/thanos，是针对Prometheus的开源高可用、长期存储解决方案。该镜像旨在解决Prometheus原生存储的局限性，提供跨集群指标聚合、长期数据保留和高可用部署能力，可广泛应用于Kubernetes等容器化环境的监控系统。

核心功能与特性

• 长期存储扩展：支持将Prometheus指标数据持久化至对象存储（如S3、GCS、Azure Blob等），突破本地存储容量限制
• 跨集群指标聚合：通过Thanos Query组件实现多Prometheus实例或跨集群指标的统一查询与聚合
• 高可用架构：支持无状态部署，通过冗余组件避免单点故障，确保监控服务持续可用
• Prometheus原生兼容：无需修改Prometheus核心配置即可无缝集成，保留PromQL查询能力
• 历史数据查询：提供高效的历史指标检索能力，支持按时间范围查询长期存储的监控数据

使用场景与适用范围

• 大规模Prometheus部署：适用于管理数十个以上Prometheus实例的企业级监控场景
• 长期数据保留需求：满足合规性要求（如***、***行业）或需历史趋势分析的业务场景
• 多集群统一监控：跨Kubernetes集群、混合云或多云环境的全局监控视图构建
• 高可用监控系统：关键业务系统的监控数据需确保不丢失、不中断的场景

使用方法与配置说明

基础使用示例

1. 运行Thanos Query组件（指标查询聚合）

bash
docker run -d --name thanos-query \
  -p 10902:10902 \  # HTTP查询端口
  -p 19090:19090 \  # gRPC通信端口
  quay.io/thanos/thanos query \
  --http-address 0.0.0.0:10902 \
  --grpc-address 0.0.0.0:19090 \
  --store prometheus-instance-1:10901 \  # 连接Prometheus或Thanos Store端点
  --store prometheus-instance-2:10901

2. 启动Thanos Store组件（对象存储代理）

bash
docker run -d --name thanos-store \
  -v /path/to/objstore-config:/etc/thanos \
  -p 10902:10902 \
  -p 10901:10901 \
  quay.io/thanos/thanos store \
  --http-address 0.0.0.0:10902 \
  --grpc-address 0.0.0.0:10901 \
  --objstore.config-file /etc/thanos/objstore.yaml  # 对象存储配置文件路径

对象存储配置文件示例（objstore.yaml）：

yaml
type: S3
config:
  bucket: "thanos-metrics-storage"
  endpoint: "s3.amazonaws.com"
  region: "us-west-2"
  access_key: "AKIAEXAMPLEKEY"
  secret_key: "secret-key-example"
  insecure: false

核心配置参数

Kubernetes集成

该镜像可通过Kubernetes资源清单部署，建议配合Prometheus Operator使用。具体集成示例可参考https://github.com/SumoLogic/sumologic-kubernetes-collection%E9%A1%B9%E7%9B%AE%EF%BC%8C%E8%AF%A5%E9%A1%B9%E7%9B%AE%E6%8F%90%E4%BE%9B%E4%BA%86%E5%9C%A8Kubernetes%E7%8E%AF%E5%A2%83%E4%B8%AD%E9%9B%86%E6%88%90Thanos%E7%9A%84%E5%AE%8C%E6%95%B4%E9%85%8D%E7%BD%AE%E6%A8%A1%E6%9D%BF%EF%BC%8C%E5%8C%85%E6%8B%ACDeployment%E3%80%81Service%E3%80%81ConfigMap%E7%AD%89%E8%B5%84%E6%BA%90%E5%AE%9A%E4%B9%89%E3%80%82

注意事项

• 版本兼容性：需与Prometheus版本匹配，建议使用Thanos官方推荐的兼容版本（参考Thanos文档）
• 资源配置：根据监控规模调整CPU/内存资源（推荐生产环境单实例至少2CPU/4GB内存）
• 数据安全：对象存储需配置访问权限控制，避免未授权访问
• 备份策略：建议定期备份对象存储中的指标数据，防止数据丢失
• 监控自身：部署Thanos自身的监控（如健康检查、性能指标），确保组件可用性