CentOS 上监控 MinIO 的推荐做法
在 CentOS 上，推荐以 Prometheus + Grafana 为核心，直接对接 MinIO 自带的 Prometheus 指标端点，实现对集群、节点、桶、资源等多维度的可观测性；如需快速上线，也可临时开启匿名抓取。以下给出从开启指标到告警落地的完整步骤。
一 准备与暴露 MinIO 指标
- 安装并配置 mc（MinIO 客户端）
- 下载 mc 并加入 PATH（如：/usr/local/bin）。
- 添加别名：mc alias set myminio http://<MINIO_SERVER_IP>:9000 <ACCESS_KEY> <SECRET_KEY>。
- 生成抓取配置（推荐，含认证）
- 生成集群/节点/桶/资源四类抓取配置：
- mc admin prometheus generate myminio
- mc admin prometheus generate myminio bucket
- mc admin prometheus generate myminio node
- mc admin prometheus generate myminio resource
- 输出为 Prometheus 的 scrape_configs（含 bearer_token、metrics_path、scheme、targets 等），直接并入 Prometheus 配置即可。
- 快速方式（仅测试环境）
- 启动 MinIO 时设置环境变量：export MINIO_PROMETHEUS_AUTH_TYPE=“public”，随后可通过 http://:9000/minio/prometheus/metrics 直接抓取（生产不建议）。
二 部署 Prometheus 抓取 MinIO 指标
- 安装 Prometheus（二进制或容器均可），编辑 prometheus.yml，将上一步 mc 生成的 scrape_configs 合并到 scrape_configs 下；示例片段：
- job_name: minio-job
bearer_token: <从 mc 生成获取>
metrics_path: /minio/v2/metrics/cluster
scheme: http
static_configs:
- targets: [‘<MINIO_SERVER_IP>:9000’]
- 可按需增加桶/节点/资源作业。
- 启动后在 Prometheus Web（默认 :9090）检查 Targets 页面，确保状态为 UP。
三 部署 Grafana 可视化
- 安装并启动 Grafana（默认 :3000），添加数据源选择 Prometheus，URL 指向 Prometheus 地址（如 http://<PROMETHEUS_IP>:9090）。
- 导入 MinIO 官方或社区仪表盘：
- 在 Grafana 导入页面输入面板 ID（如社区流行的 MinIO 仪表盘），选择 Prometheus 数据源即可展示集群、节点、桶、请求时延、流量、HTTP 状态码等关键指标。
四 主机与服务可用性监控
- 主机层面
- 部署 node_exporter 采集 CPU、内存、磁盘 IO、网络 等系统指标，Prometheus 增加对应 job 抓取；Grafana 使用 Node Exporter 官方面板进行可视化。
- MinIO 进程层面
- 使用 systemd 托管 MinIO，设置 Restart=always，确保异常退出自动拉起；配合 Prometheus 的 up 指标或进程存活探针做可用性告警。
五 告警与扩展
- 告警规则示例（Prometheus）
- 集群离线：up{job=“minio-job”} == 0
- 5xx 错误率升高：sum(rate(minio_http_requests_total{status=~“5…”}[5m])) / sum(rate(minio_http_requests_total[5m])) > 0.01
- 磁盘使用率过高：1 - (node_filesystem_avail_bytes / node_filesystem_size_bytes) > 0.8
- 扩展方案
- 多集群/长期存储：引入 Thanos 将 Prometheus 数据写入 MinIO（S3 兼容）实现高可用与查询聚合；配置 sidecar、store、query 组件并指向 MinIO 的 bucket_config.yaml。
