使用 InfluxDB 进行监控和告警

MinIO 使用 Prometheus 数据模型发布集群和节点指标。 InfluxDB 支持抓取 MinIO 指标数据以进行监控和告警。

此页面上的过程记录了以下内容

配置 InfluxDB 服务以抓取和显示来自 MinIO 部署的指标
配置 MinIO 指标上的告警

先决条件

此过程需要以下内容

已配置一个或多个通知端点的现有 InfluxDB 部署
具有对 InfluxDB 部署的网络访问权限的现有 MinIO 部署
您本地主机上已配置的 mc 安装，用于访问 MinIO 部署

配置 InfluxDB 以使用 MinIO 指标进行收集和告警

重要

此过程专门使用 InfluxDB UI 创建抓取端点。

InfluxDB UI 不提供与使用 Telegraf 和相应的 Prometheus 插件相同级别的配置。具体来说

您无法通过 InfluxDB UI 启用对 MinIO 指标端点的身份验证访问
您无法为收集的指标设置标签（例如 url_tag），以唯一标识给定 MinIO 部署的指标

配置 Telegraf 不在此过程范围内。您可以将此过程作为配置 Telegraf 以抓取 MinIO 指标的一般指南。

配置对 MinIO 指标的公共访问

将 MINIO_PROMETHEUS_AUTH_TYPE 环境变量设置为 "public"，适用于 MinIO 部署中的所有节点。然后，您可以重新启动部署以允许对 MinIO 指标进行公共访问。

您可以通过尝试 curl 指标端点来验证更改
```
curl https://HOSTNAME/minio/v2/metrics/cluster
```
将 HOSTNAME 替换为负载均衡器或反向代理的 URL，您通过该 URL 访问 MinIO 部署。您也可以将任何单个节点指定为 HOSTNAME:PORT，除了节点主机名外，还要指定 MinIO 服务器 API 端口。

响应主体应包含收集的 MinIO 指标列表。
登录 InfluxDB UI 并创建一个存储桶

选择您要存储 MinIO 指标的组织。

创建一个新的存储桶，用于存储 MinIO 部署的指标。
创建一个新的抓取源

创建一个新的 InfluxDB 抓取器。

指定 MinIO 部署的完整 URL，包括指标端点
```
https://HOSTNAME/minio/v2/metrics/cluster
```
将 HOSTNAME 替换为负载均衡器或反向代理的 URL，您通过该 URL 访问 MinIO 部署。您也可以将任何单个节点指定为 HOSTNAME:PORT，除了节点主机名外，还要指定 MinIO 服务器 API 端口。
验证数据

使用 DataExplorer 可视化收集的 MinIO 数据。

例如，您可以对 minio_cluster_capacity_usable_total_bytes 和 minio_cluster_capacity_usable_free_bytes 设置一个过滤器，以比较 MinIO 部署上的总可用空间与总可用空间。
配置一个检查

创建一个新的检查，用于检查 MinIO 指标。

以下示例检查规则提供了对 MinIO 部署的告警基线。您可以修改或以其他方式使用这些示例作为构建您自己的检查的指南。
- 创建一个名为 MINIO_NODE_DOWN 的阈值检查。
  
  为 minio_cluster_nodes_offline_total 键设置过滤器。
  
  将阈值设置为警告，当值大于1时。
- 创建一个名为MINIO_QUORUM_WARNING的阈值检查。
  
  将过滤器设置为minio_cluster_drive_offline_total键。
  
  将阈值设置为严重，当值比您配置的擦除编码奇偶校验设置少 1 时。
  
  例如，使用 EC:4 的部署应将此值设置为3。
配置您的通知端点和通知规则，以便每种类型的检查都能触发适当的响应。