Metrics version 2
MinIO publishes cluster and node metrics using the Prometheus Data Model. You can use any scraping tool to pull metrics data from MinIO for further analysis and alerting.
Version 2 Endpoints
Metrics version 2 provides metrics organized into three categories:
Each v2 endpoint returns all metrics for its category. For example, scraping the following endpoint returns all cluster metrics:
http://HOSTNAME:PORT/minio/v2/metrics/cluster
The base endpoint alone, /minio/v2/metrics/, returns cluster metrics.
- For more flexible scraping and a wider range of metrics, use metrics version 3.
Existing deployments can continue to use version 2 metrics and Grafana dashboards.
MinIO Grafana dashboard
MinIO publishes two Grafana Dashboards for visualizing v2 metrics. For more complete documentation on configuring a Prometheus-compatible data source for Grafana, see the Prometheus documentation on Grafana Support.
Available version 2 metrics
The following sections describe the version 2 endpoints and metrics.
You can scrape cluster-level metrics using the following URL endpoint:
http://HOSTNAME:PORT/minio/v2/metrics/cluster
Replace HOSTNAME:PORT with the FQDN and port of the MinIO deployment.
For deployments with a load balancer managing connections between MinIO nodes, specify the address of the load balancer.
Changed in version MinIO: RELEASE.2023-07-21T21-12-44Z
Bucket metrics have moved to use their own, separate endpoint.
Changed in version RELEASE.2023-08-31T15-31-16Z: You can scrape bucket-level metrics using the following URL endpoint:
Changed in version RELEASE.2025-03-12T17-29-24Z: v2 metrics have a limit of 100 buckets for performance reasons. For metrics across a higher number of buckets, use v3 metrics instead.
http://HOSTNAME:PORT/minio/v2/metrics/bucket
Replace HOSTNAME:PORT with the FQDN and port of the MinIO deployment.
For deployments with a load balancer managing connections between MinIO nodes, specify the address of the load balancer.
New in version RELEASE.2023-10-07T15-07-38Z.
You can scrape resource metrics using the following URL endpoint:
http://HOSTNAME:PORT/minio/v2/metrics/resource
Replace HOSTNAME:PORT with the FQDN and port of the MinIO deployment.
For deployments with a load balancer managing connections between MinIO nodes, specify the address of the load balancer.
Changed in version RELEASE.2025-03-12T17-29-24Z: v2 metrics have a limit of 100 buckets for performance reasons. For metrics across a higher number of buckets, use v3 metrics instead.
