Grafana Mimir 镜像文档

镜像概述和主要用途

Grafana Mimir 是一款为 Prometheus 设计的开源监控数据存储系统，提供水平可扩展、高可用、多租户的长期存储解决方案。其核心用途是解决 Prometheus 在大规模监控场景下的存储瓶颈，支持监控数据的长期留存、高效查询和跨集群聚合。

核心功能和特性

水平可扩展

• 支持通过增加节点线性扩展存储容量和查询性能，满足从单节点到大规模集群的监控需求。

高可用架构

• 采用分布式架构设计，支持多副本数据存储和自动故障转移，确保监控数据不丢失且服务持续可用。

多租户支持

• 原生支持多租户隔离，通过租户ID区分不同团队或项目的监控数据，确保数据安全性和资源隔离。

长期存储优化

• 提供数据压缩、降采样（downsampling）和分层存储能力，有效降低长期存储成本，支持TB级监控数据留存。

Prometheus 兼容

• 完全兼容 Prometheus 的 remote_write 和 remote_read API，可无缝集成现有 Prometheus 部署，无需修改客户端配置。

使用场景和适用范围

大规模 Prometheus 监控环境

• 适用于 Prometheus 实例数量多、监控指标量大（如百万级以上指标）的场景，解决单机存储和查询能力不足问题。

多团队共享监控基础设施

• 支持企业内部多个团队或项目共享同一套 Mimir 集群，通过多租户隔离实现资源按需分配和数据安全。

长期监控数据留存需求

• 需保留监控数据数月甚至数年（如满足合规审计、趋势分析需求）的场景，通过分层存储和降采样优化存储效率。

高可用性要求的关键业务监控

• 对监控服务可用性要求高的核心业务场景，如金融、电商等，通过多副本和故障转移确保监控数据不中断。

使用方法和配置说明

Docker 快速启动

前提条件

• 已安装 Docker 19.03+
• 准备 Mimir 配置文件（参考 官方配置示例）

单节点快速启动

通过 docker run 命令启动 Mimir 单节点实例（适用于测试环境）：

docker run -d \
  --name mimir \
  -p 8080:8080 \  # HTTP API 端口
  -p 9095:9095 \  # gRPC 端口（内部组件通信）
  -v /path/to/mimir-config.yml:/etc/mimir/config.yml \  # 挂载本地配置文件
  grafana/mimir:latest \
  -config.file=/etc/mimir/config.yml

说明：

• /path/to/mimir-config.yml 需替换为本地配置文件路径，配置文件需包含存储后端、租户设置等关键参数。
• 单节点模式仅用于测试，生产环境需部署分布式集群。

Docker Compose 集群部署（简化示例）

以下为多节点集群部署的 docker-compose.yml 示例（包含 distributor、ingester、querier 等核心组件）：

version: '3.8'

services:
  distributor:
    image: grafana/mimir:latest
    command: -config.file=/etc/mimir/config.yml
    ports:
      - "8080:8080"  # 接收 Prometheus remote_write 请求
    volumes:
      - ./mimir-config.yml:/etc/mimir/config.yml
    environment:
      - MIMIR_ROLE=distributor
    depends_on:
      - ingester
      - querier

  ingester:
    image: grafana/mimir:latest
    command: -config.file=/etc/mimir/config.yml
    volumes:
      - ./mimir-config.yml:/etc/mimir/config.yml
    environment:
      - MIMIR_ROLE=ingester
    volumes:
      - ingester-data:/var/mimir/ingester

  querier:
    image: grafana/mimir:latest
    command: -config.file=/etc/mimir/config.yml
    volumes:
      - ./mimir-config.yml:/etc/mimir/config.yml
    environment:
      - MIMIR_ROLE=querier
    depends_on:
      - store-gateway

  store-gateway:
    image: grafana/mimir:latest
    command: -config.file=/etc/mimir/config.yml
    volumes:
      - ./mimir-config.yml:/etc/mimir/config.yml
    environment:
      - MIMIR_ROLE=store-gateway
    volumes:
      - store-gateway-data:/var/mimir/store-gateway

volumes:
  ingester-data:
  store-gateway-data:

说明：

• 生产环境需根据实际需求调整组件数量（如增加 querier 节点提升查询性能）。
• 存储后端（如 S3、GCS、对象存储）需在 mimir-config.yml 中配置，避免使用本地存储（易丢失数据）。

核心配置参数说明

Mimir 配置通过配置文件（YAML 格式）或环境变量定义，关键参数如下：

配置文件核心字段（示例片段）

# 全局配置
multitenancy_enabled: true  # 启用多租户（默认开启）

# 存储配置（以 S3 为例）
storage:
  backend: s3
  s3:
    endpoint: "s3.amazonaws.com"
    bucket_name: "mimir-storage"
    access_key_id: "${AWS_ACCESS_KEY_ID}"
    secret_access_key: "${AWS_SECRET_ACCESS_KEY}"

# 服务器配置
server:
  http_listen_port: 8080  # HTTP API 监听端口
  grpc_listen_port: 9095  # gRPC 监听端口

常用环境变量

参考链接

• 问题反馈：GitHub Issues
• 源代码：GitHub 仓库
• 官方文档：Grafana Mimir 文档