Grafana Mimir 迁移指南：从 Thanos 迁移到 Mimir 并保留历史数据-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00973/article/details/148524853

Grafana Mimir 迁移指南：从 Thanos 迁移到 Mimir 并保留历史数据

mimir Grafana Mimir provides horizontally scalable, highly available, multi-tenant, long-term storage for Prometheus. 项目地址: https://gitcode.com/gh_mirrors/mimir/mimir

前言

在监控系统演进过程中，许多团队会面临从 Thanos 迁移到 Grafana Mimir 的需求。本文将详细介绍如何利用 Thanos Sidecar 实现平滑迁移，同时保留历史监控数据。这种方法特别适合需要保持业务连续性的生产环境。

迁移方案概述

迁移的核心思路是：让 Thanos 能够查询 Mimir 的数据。这样既可以通过现有的 Thanos 部署保留历史数据，又能将所有新的监控数据（来自 Prometheus 服务器或其他指标源）直接写入 Mimir。

技术架构要点：

在 Mimir 旁边部署 Thanos Sidecar
配置 Thanos Query 将 Sidecar 视为普通 Sidecar 节点
通过 NGINX 解决 API 兼容性问题

重要提示：此方案属于实验性质，尚未经过大规模生产验证。建议在测试环境充分验证后再应用于生产环境，并确保有完善的备份恢复机制。

技术实现细节

兼容性挑战与解决方案

Thanos Sidecar 设计用于与 Prometheus API 交互，而 Mimir 几乎完全实现了这些 API。但有两个关键端点需要特殊处理：

/api/v1/status/buildinfo - 用于获取 Prometheus 版本信息
/api/v1/status/config - 用于获取 Prometheus 配置

我们通过 NGINX 伪造这些端点的响应来解决兼容性问题。此外，Mimir 要求所有请求必须包含 X-Scope-Org-Id 头部来标识租户，这同样通过 NGINX 中间件实现。

部署方案详解

1. Thanos Sidecar 部署配置

以下 Kubernetes Deployment 配置展示了如何部署 Thanos Sidecar 和配套的 NGINX：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: thanos-sidecar
  namespace: mimir
spec:
  replicas: 1
  template:
    spec:
      containers:
      - name: nginx
        image: nginxinc/nginx-unprivileged:1.19-alpine
        ports:
        - containerPort: 8080
        volumeMounts:
        - mountPath: /etc/nginx
          name: config
          
      - name: thanos-sidecar
        image: quay.io/thanos/thanos:v0.26.0
        args:
        - sidecar
        - "--prometheus.url=http://localhost:8080/prometheus"
        - "--grpc-address=:10901"
        - "--http-address=:10902"
        ports:
        - containerPort: 10901  # gRPC 端口
        - containerPort: 10902  # HTTP 端口
      volumes:
      - name: config
        configMap:
          name: sidecar-nginx

配套的 Service 配置：

apiVersion: v1
kind: Service
metadata:
  name: thanos-sidecar
spec:
  ports:
  - port: 10901
    targetPort: 10901
  selector:
    app: thanos-sidecar

2. Sidecar 的 NGINX 配置

Sidecar 中的 NGINX 负责向 Mimir 请求注入租户 ID。关键配置如下：

http {
  server {
    listen 8080;
    
    # 所有请求转发到 Mimir 并注入租户头
    location / {
      proxy_set_header X-Scope-OrgID 1;  # 租户ID
      proxy_pass http://mimir-distributed-nginx.mimir.svc.cluster.local:80$request_uri;
    }
  }
}

3. Mimir 的 NGINX 配置

Mimir 的 NGINX 需要伪造 Prometheus 的两个关键 API 端点：

location /prometheus/api/v1/status/config {
    add_header Content-Type application/json;
    return 200 "{\"status\":\"success\",\"data\":{\"yaml\": \"global:\\n  external_labels:\\n    source: mimir\"}}";
}

location /prometheus/api/v1/status/buildinfo {
    add_header Content-Type application/json;
    return 200 "{\"status\":\"success\",\"data\":{\"version\":\"2.35.0\"}}";
}

外部标签配置说明：