使用 InfluxDB 进行监控与告警

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

本页介绍以下内容：

• 配置 InfluxDB 服务，抓取并展示 MinIO 部署的指标
• 基于 MinIO 指标配置告警

对于 Kubernetes 上的 MinIO 部署，本文默认已具备 Ingress、负载均衡器等必要的网络控制组件，以便 MinIO 租户与 InfluxDB 服务之间能够互相访问。

配置 InfluxDB 收集 MinIO 指标并触发告警

1. 配置对 MinIO 指标的公开访问

   在 MinIO 部署的所有节点上，将 MINIO_PROMETHEUS_AUTH_TYPE 环境变量设置为 "public"。 随后可重启部署，以允许公开访问 MinIO 指标。

   可通过对指标端点执行 curl 来验证变更是否生效：

   curl https://HOSTNAME/minio/v2/metrics/cluster
   

   将 HOSTNAME 替换为访问 MinIO 部署所使用的负载均衡器或反向代理 URL。 也可以将任意单个节点写成 HOSTNAME:PORT，即在节点主机名之外再指定 MinIO server API 端口。

   响应正文中应包含已采集的 MinIO 指标列表。

2. 登录 InfluxDB UI 并创建 Bucket

   选择用于存储 MinIO 指标的 Organization。

   创建一个 New Bucket，用于存储该 MinIO 部署的指标。

3. 创建新的抓取源

   创建一个 新的 InfluxDB Scraper。

   指定 MinIO 部署的完整 URL，其中包含指标端点：

   https://HOSTNAME/minio/v2/metrics/cluster
   

   将 HOSTNAME 替换为访问 MinIO 部署所使用的负载均衡器或反向代理 URL。 也可以将任意单个节点写成 HOSTNAME:PORT，即在节点主机名之外再指定 MinIO server API 端口。

4. 验证数据

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

   例如，可针对 minio_cluster_capacity_usable_total_bytes 和 minio_cluster_capacity_usable_free_bytes 设置过滤条件，以比较 MinIO 部署中的总可用空间和剩余可用空间。

5. 配置 Check

   基于某个 MinIO 指标创建一个 新的 Check。

   以下示例 Check 规则为 MinIO 部署提供了一组基础告警。 可按需修改这些示例，或将其作为构建自定义 Check 的参考。

   • 创建一个名为 MINIO_NODE_DOWN 的 Threshold Check。

     将过滤条件设置为 minio_cluster_nodes_offline_total 键。

     在值大于 1 时，将 Thresholds 设置为 WARN。

   • 创建一个名为 MINIO_QUORUM_WARNING 的 Threshold Check。

     将过滤条件设置为 minio_cluster_drive_offline_total 键。

     当该值比已配置的 纠删码校验值 少 1 时，将 Thresholds 设置为 CRITICAL。

     例如，使用 EC:4 的部署应将该值设置为 3。

   配置 Notification endpoints 和 Notification rules，使各类 Check 都能触发适当响应。