跳转到主要内容

指标与告警

MinIO 使用 Prometheus 数据模型 发布指标。 你可以使用任意抓取工具从 MinIO 拉取指标数据,以执行进一步分析和配置告警。

从 MinIO 服务端 RELEASE.2024-07-15T19-02-30Z 与 MinIO 客户端 RELEASE.2024-07-11T18-01-28Z 开始,metrics version 3 提供了更多端点。 对于新部署,MinIO 建议使用 version 3。

说明

Metrics version 2

现有部署可以继续使用 version 2 指标Grafana 仪表板

Version 3 端点

对于 metrics version 3,所有指标都位于基础端点 /minio/metrics/v3 之下。 你可以抓取该基础端点以一次性收集全部指标,也可以追加可选路径,仅返回特定类别的指标。

警告

重要

本页中的 V3 指标说明可能存在缺漏、不准确或错误信息。 如需最准确的指标定义,请参考 minio/minio 仓库并审阅源代码。

例如,以下端点会返回 audit 指标:

http://HOSTNAME:PORT/minio/metrics/v3/audit

HOSTNAME:PORT 替换为 MinIO 部署的 FQDN 与端口。 对于使用负载均衡器管理 MinIO 节点间连接的部署,请指定负载均衡器地址。

默认情况下,MinIO 要求在抓取指标端点时进行身份验证。 如需生成所需的 bearer token,请使用 mc admin prometheus generate。 你也可以将 MINIO_PROMETHEUS_AUTH_TYPE 设置为 public,以禁用指标端点认证。

相对于基础 URL,MinIO 提供以下抓取端点:

类别

路径

API

/api/requests

/bucket/api

审计

/audit

集群

/cluster/config

/cluster/erasure-set

/cluster/health

/cluster/iam

/cluster/usage/buckets

/cluster/usage/objects

调试

/debug/go

ILM

/ilm

日志 Webhook

/logger/webhook

通知

/notification

复制

/replication

/bucket/replication

扫描器

/scanner

系统

/system/drive

/system/memory

/system/cpu

/system/network/internode

/system/process

各端点对应的完整指标列表,请参见 Available version 3 metrics

如需在 MinIO Console 中启用历史数据可视化,请在 MinIO 部署的每个节点上设置以下环境变量:

可用的 version 3 指标

MinIO 为集群、API 请求、存储桶以及 MinIO 服务的其他方面发布多类指标:

许多指标都包含标签,用于标识生成该指标的资源及其他相关信息。