Grafana Mimir 入门

您可以*指令式*或*声明式*地开始使用 Grafana Mimir

指令式：下面的书面说明包含帮助您启动单个 Mimir 进程的命令。您需要再次执行这些命令来启动另一个 Mimir 进程。
声明式：下面的视频教程使用 docker-compose 部署多个 Mimir 进程。因此，如果您以后想部署多个 Mimir 进程，大部分配置工作已经完成。
注意
视频发布后，教程目录路径已更改为 docs/sources/mimir/get-started/play-with-grafana-mimir。

开始之前

验证您是否已安装 Prometheus 服务器或 Grafana Alloy。
验证您是否已安装 Docker。

注意
接下来的说明将帮助您以单体模式部署 Grafana Mimir。
有关部署 Grafana Mimir 的不同方式的信息，请参阅Grafana Mimir 部署模式。

下载 Grafana Mimir

在终端中，运行以下命令之一

使用 Docker
bash
```
docker pull grafana/mimir:latest
```
使用本地二进制文件
下载适合您操作系统和架构的发布资产，并使其可执行。
适用于采用 AMD64 架构的 Linux
bash
```
curl -fLo mimir https://github.com/grafana/mimir/releases/latest/download/mimir-linux-amd64
chmod +x mimir
```

启动 Grafana Mimir

要将 Grafana Mimir 作为单体运行并使用本地文件系统存储，请将以下 YAML 配置写入名为 demo.yaml 的文件

# Do not use this configuration in production.
# It is for demonstration purposes only.
multitenancy_enabled: false

blocks_storage:
  backend: filesystem
  bucket_store:
    sync_dir: /tmp/mimir/tsdb-sync
  filesystem:
    dir: /tmp/mimir/data/tsdb
  tsdb:
    dir: /tmp/mimir/tsdb

compactor:
  data_dir: /tmp/mimir/compactor
  sharding_ring:
    kvstore:
      store: memberlist

distributor:
  ring:
    instance_addr: 127.0.0.1
    kvstore:
      store: memberlist

ingester:
  ring:
    instance_addr: 127.0.0.1
    kvstore:
      store: memberlist
    replication_factor: 1

ruler_storage:
  backend: filesystem
  filesystem:
    dir: /tmp/mimir/rules

server:
  http_listen_port: 9009
  log_level: error

store_gateway:
  sharding_ring:
    replication_factor: 1

注意
Grafana Mimir 包含一个系统，该系统可选地匿名报告关于正在运行的 Mimir 集群的非敏感、非个人身份信息给远程统计服务器，以帮助 Mimir 维护者了解开源社区如何运行 Mimir。
要选择退出，请参阅禁用匿名使用统计报告。

运行 Grafana Mimir

在终端中，运行以下命令之一

使用 Docker

docker network create grafanet

docker run \
  --rm \
  --name mimir \
  --network grafanet \
  --publish 9009:9009 \
  --volume "$(pwd)"/demo.yaml:/etc/mimir/demo.yaml grafana/mimir:latest \
  --config.file=/etc/mimir/demo.yaml

使用本地二进制文件
bash
```
./mimir --config.file=./demo.yaml
```

Grafana Mimir 监听端口 9009。

配置 Prometheus 写入 Grafana Mimir

将以下 YAML 代码片段添加到您的 Prometheus 配置文件并重启 Prometheus 服务器

remote_write:
  - url: https://:9009/api/v1/push

抓取自身并将这些指标写入 Grafana Mimir 的 Prometheus 服务器配置类似于此

remote_write:
  - url: https://:9009/api/v1/push

scrape_configs:
  - job_name: prometheus
    honor_labels: true
    static_configs:
      - targets: ["localhost:9090"]

配置 Grafana Alloy 写入 Grafana Mimir

在 Grafana Alloy 中使用 prometheus.remote_write 组件将指标发送到 Grafana Mimir。例如

prometheus.remote_write "LABEL" {
  endpoint {
    url = https://:9009/api/v1/push

    ...
  }

  ...
}

抓取自身并将这些指标写入 Grafana Mimir 的 Alloy 配置类似于此

prometheus.exporter.self "self_metrics" {
}

prometheus.scrape "self_scrape" {
  targets    = prometheus.exporter.self.self_metrics.targets
  forward_to = [prometheus.remote_write.mimir.receiver]
}

prometheus.remote_write "mimir" {
  endpoint {
    url = "https://:9009/api/v1/push"
  }
}

有关设置 Alloy 的更多信息，请参阅prometheus.remote_write。

使用 Grafana Cloud 集成监控 Grafana Mimir

与 Grafana Cloud 集成，监控 Mimir 系统的健康状况。Grafana Cloud 的自托管 Mimir 集成包括仪表盘、记录规则和告警规则，以帮助监控集群健康状况。此集成使用 Grafana Alloy 抓取指标并发送到 Mimir。

更多信息，请参阅Grafana Cloud 的自托管 Grafana Mimir 集成。

在 Grafana 中查询数据

在一个新的终端中，使用 Docker 运行一个本地 Grafana 服务器

docker run --rm --name=grafana --network=grafanet -p 3000:3000 grafana/grafana

将 Grafana Mimir 添加为 Prometheus 数据源

在浏览器中，访问 Grafana 服务器，地址为 https://:3000/datasources。
使用默认用户名 admin 和密码 admin 登录。
使用以下设置配置新的 Prometheus 数据源以查询本地 Grafana Mimir 服务器
字段值
名称 Mimir
URL 如果您使用 Docker，URL 为 http://mimir:9009/prometheus / 如果您使用本地二进制文件，URL 为 https://:9009/prometheus