45 分钟搭好 MinIO 监控从指标抓取到 Grafana 完整指南【免费下载链接】minioMinIO is a high-performance, S3 compatible object store, open sourced under GNU AGPLv3 license.项目地址: https://gitcode.com/GitHub_Trending/mi/minio周五下午磁盘告警响了你打开 Grafana面板是空的——因为 Prometheus 根本没抓到数据。MinIO 监控这件事没有想象中复杂服务端默认就内置了完整的指标体系V2 按 cluster、bucket、node、resource 四类端点暴露数据V3 又把这些指标拆成十几条按模块划分的采集路径比如/cluster/health、/api/requests。这篇文章按实操顺序走一遍 MinIO 监控的完整链路验证端点、配置 Prometheus 抓取任务、导入官方仪表盘最后给集群仲裁丢失配上告警。做完这篇你能做到用一条 curl 确认 MinIO 指标端点是否可用配好 Prometheus 抓取任务并看到时序数据入库在 Grafana 里看到集群健康、容量和桶级流量并在仲裁丢失时收到告警它到底能帮你看见什么MinIO 把 Prometheus 兼容数据作为默认能力内置在服务端不需要额外插件。最实用的一点是集群级指标可以从任意单个节点读到也就是说哪怕你只在负载均衡器后面配了一个抓取目标也能拿到整个集群的数据。V3 指标体系在 cmd/metrics-v3.go 里把指标按模块组织成一条条采集路径统一挂在/minio/metrics/v3前缀下请求时带上?list参数还能列出该路径下所有指标的名称、类型和标签不用猜指标名。按你实际会盯的东西分大致是这么几块能看见什么V3 采集路径典型用途节点与纠删集健康/cluster/health、/cluster/erasure-set存活状态、是否失去仲裁容量与对象规模/cluster/usage/objects、/cluster/usage/buckets存储增长、桶对象数量S3 API 性能/api/requests请求量、错误数、TTFB 分布宿主机资源/system/cpu、/system/driveCPU、磁盘水位桶级数据在 V3 里单独成路径形如/bucket/api/桶名后面配抓取任务时会用到。动手前的准备一个跑起来的 MinIO 实例单节点或分布式都行默认服务端口 9000。一套 Prometheus能改配置并能访问 MinIO 的 9000 端口。一套 Grafana任意近两年的版本即可。一个有mc admin prometheus generate权限的账号通常是根账号用于生成抓取 token。缺了哪一步会怎样MinIO 没起来所有抓取直接 404拿不到生成 token 的权限而指标端点默认是 jwt 鉴权Prometheus 侧就会一直看到 401。这两个是后面步骤里最常见的卡点。从零跑通全流程验证指标端点连通性先确认 Prometheus 将来要抓的路径是通的curl -s http://minio-node:9000/minio/metrics/v3/cluster/health?list返回一张指标表格说明路径存在返回 401 也属正常说明鉴权拦住了你后面用 token 解决。这里的关键是?list参数它只输出指标清单而不采集数值适合快速验证路径拼写。确认路径没拼错之后给 Prometheus 生成一份现成的抓取配置。配置 Prometheus 抓取任务MinIO 的官方文档 docs/metrics/prometheus/README.md 给出了完整流程核心是先用 mc 生成带 token 的配置片段mc admin prometheus generate your-alias把输出合并进prometheus.ymlscrape_configs: - job_name: minio-job bearer_token: your-secret metrics_path: /minio/v2/metrics/cluster scheme: http static_configs: - targets: [minio-node-1:9000] # 其余配置省略bearer_token直接来自刚才 mc 命令的输出metrics_path指向集群端点所以 targets 只写一个节点就够。重启 Prometheus 后在 Targets 页面应该能看到 minio-job 状态为 UP。导入官方 Grafana 集群仪表盘docker run -d -p 3000:3000 grafana/grafana进 Grafana 后新建一个 Prometheus 数据源指向你的 Prometheus 地址然后走 Import 流程粘贴仓库里的仪表盘 JSON——官方集群大盘是 minio-dashboard.json桶级、节点级、复制相关也有各自的 JSON都在docs/metrics/prometheus/grafana/目录下。导入后集群大盘长这样大盘只是起点真正防止半夜被叫醒的是告警规则。配置仲裁丢失告警规则Prometheus 侧接入 AlertManageralerting段配置 AlertManager 地址即可再写一条规则。MinIO 官方给的示例规则是监控纠删集健康指标groups: - name: minio-alerts rules: - alert: MinIOClusterTolerance expr: minio_cluster_health_erasure_set_status 1 for: 5m labels: severity: criticalminio_cluster_health_erasure_set_status来自 cluster/health 模块某个纠删集低于仲裁阈值持续 5 分钟就触发规则写法细节在 docs/metrics/prometheus/alerts.md 里有完整示例和验证步骤。容易踩的几个坑 ⚠️抓取 401/403。现象是 Prometheus Targets 里 job 状态 RED、HTTP 401。原因是指标端点默认走 jwt 鉴权默认值写在 cmd/metrics-router.go 里。解法用mc admin prometheus generate生成的bearer_token抓取只有测试环境才建议设MINIO_PROMETHEUS_AUTH_TYPEpublic放行。单机能抓挂到负载均衡后面就 404。原因是 Prometheus 请求时会把 Host 头设为domain:port而不少负载均衡器不认识这条 metrics 路径直接把请求丢了。解法是在 nginx、HAProxy 这类反向代理上显式把/minio/前缀的请求路由到 MinIO 集群。桶级指标怎么都是空的。原因V3 的桶指标默认不返回任何桶的数据必须在路径里带桶名如/minio/metrics/v3/bucket/api/your-bucket或传buckets参数否则该组 gatherer 直接跳过。需要桶级视图时用仓库里对应的桶仪表盘跑通之后建议把抓取间隔、保留策略按自己的规模调一调再根据业务加面板。想查指标定义去 docs/metrics/prometheus/list.md 翻清单想做桶级或复制视图就从 docs/metrics/prometheus/grafana/ 目录里挑对应的 JSON 导入。【免费下载链接】minioMinIO is a high-performance, S3 compatible object store, open sourced under GNU AGPLv3 license.项目地址: https://gitcode.com/GitHub_Trending/mi/minio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
HyperDX 页面布局指南：深入解析 PageHeader 与 PageLayout 共享页头体系 可观测性云原生运维 【免费下载链接】hyperdx Resolve production issues, fast. An open source observability platform unifying session replays, logs, metrics, traces and errors powered by ClickHouse and OpenTelemetry. 项目地址： https://gitcode.com/g… · 2026/9/24 16:58:24
RAG 食谱知识库实战：蒲烧茄子做法详解与蒲烧汁配方全解析 教程人工智能大模型RAG 【免费下载链接】all-in-rag 🔍大模型应用开发实战一：RAG 技术全栈指南，在线阅读地址：https://datawhalechina.github.io/all-in-rag/ 项目地址： https://gitcode.com/datawhalechina/all-in-ra… · 2026/9/24 16:58:18
【股票交易】专栏介绍 为什么同一家公司的经营状况没有明显变化，股价却可能上涨或下跌 30%？
因为股价不仅反映公司当下的经营结果，还包含市场对未来增长、资金成本和风险的判断。同样的利润，在不同的经济环境、行业阶段和市场情绪下，可能对… · 2026/9/24 17:26:48
液冷服务器渗透率2027年破50%？产业链谁在受益 中商产业研究院预计中国液冷服务器渗透率2027年有望突破50%，从2021年不足3%到2027年过半，六年翻十几倍。产业链受益顺序是：最先受益的是液冷板/换热器等核心部件，其次是冷却液、管路、CDU等配套，最后是运维和改造服务。… · 2026/9/24 17:26:48
springboot太原青年背包客深度游小程序20606-计算机课程设计、毕业设计 前言
✨ 博主介绍：一线全栈工程师，毕设实战引路人。技术栈覆盖Java、Python、C#、PHP、Node.js及UniApp跨端开发，擅长多语言项目落地与架构设计。持续分享毕设源码、开题报告、技术选型心得与职场踩坑经验。用工程化思维写代码，帮… · 2026/9/24 17:26:48
springboot生活商城系统21035-计算机课程设计、毕业设计 前言
✨ 博主介绍：一线全栈工程师，毕设实战引路人。技术栈覆盖Java、Python、C#、PHP、Node.js及UniApp跨端开发，擅长多语言项目落地与架构设计。持续分享毕设源码、开题报告、技术选型心得与职场踩坑经验。用工程化思维写代码，帮… · 2026/9/24 17:26:48
【股票交易】第 46 章 技术分析是什么 回到目录文章目录46.1 技术分析研究什么第一，价格向什么方向变化？第二，这种变化伴随着多大的交易量？第三，价格变化是在加速，还是在减弱？第四，价格波动有多大？第五&#x… · 2026/9/24 17:26:48
RocketMQ知识点 ^^ 《榴芒客服系统》是我们工作室开发的在线客服系统，欢迎下载试用： 《榴芒客服系统》https://blog.csdn.net/look4liming/article/details/164755808
RocketMQ是队列式的消息中间件。由Producer、Consumer、Broker、NameServer组成。Productor创建消息… · 2026/9/24 17:26:42
基于YOLOv8的渔船作业监控系统：从环境搭建到边缘部署全流程 简介：这是一套面向计算机、人工智能、自动化等专业学生与教师的毕业设计级项目资源，围绕YOLOv8实现渔船作业监控系统，可用于毕设、课程设计、大作业或项目立项演示。压缩包共97个文件，约24.21MB，以70个Python源码文件为… · 2026/9/24 0:00:13
1D-CNN时间序列建模实战：从Conv1d原理到工业落地 简介：面向时间序列数据建模的一维卷积神经网络完整实现，适合深度学习入门者及需要快速验证时序模型的研究者，能够从音频、文本、传感器或股价等序列中挖掘局部特征与时间依赖。压缩包体积很小，只有3KB，内含3个Python脚… · 2026/9/24 0:00:26
柔软的L：汉语语流中被忽视的舌肌张力控制 1. 这个“L”不是字母表里的L，而是舌尖上的L最近在几个方言群和语音教学社群里，反复看到有人发一句：“也说字母L：柔软的长舌”。初看以为是英语发音课笔记，点开才发现全是方言爱好者、播音系学生、语言康复师甚至戏曲演… · 2026/9/24 0:00:44
