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:
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.
Cluster Metrics
MinIO collects the following metrics at the cluster level. Metrics may include one or more labels, such as the server that calculated that metric.
These metrics can be obtained from any MinIO server once per collection by using the following URL:
https://HOSTNAME:PORT/minio/v2/metrics/cluster
Replace HOSTNAME:PORT
with the hostname of your MinIO deployment.
For deployments behind a load balancer, use the load balancer hostname instead of a single node hostname.
Audit Metrics
Cluster Capacity Metrics
Cluster Drive Metrics
Cluster ILM Metrics
Cluster KMS Metrics
Cluster Health Metrics
Cluster Replication Metrics
Metrics marked as Site Replication Only
only populate on deployments with Site Replication configurations.
For deployments with bucket or batch configurations, these metrics populate instead under the Bucket Metrics endpoint.
Node Replication Metrics
Metrics marked as Site Replication Only
only populate on deployments with Site Replication configurations.
For deployments with bucket or batch configurations, these metrics populate instead under the Bucket Metrics endpoint.
Healing Metrics
Inter Node Metrics
Bucket Notification Metrics
S3 API Request Metrics
Software Metrics
Drive Metrics
Identity and Access Management (IAM) Metrics
Information Lifecycle Management (ILM) Metrics
Tier Metrics
System Metrics
Scanner Metrics
Bucket Metrics
MinIO collects the following metrics at the bucket level.
Each metric includes the bucket
label to identify the corresponding bucket.
Metrics may include one or more additional labels, such as the server that calculated that metric.
These metrics can be obtained from any MinIO server once per collection by using the following URL:
https://HOSTNAME:PORT/minio/v2/metrics/bucket
Replace HOSTNAME:PORT
with the hostname of your MinIO deployment.
For deployments behind a load balancer, use the load balancer hostname instead of a single node hostname.
Distribution Metrics
Replication Metrics
These metrics only populate on deployments with Bucket Replication or Batch Replication configurations. For deployments with Site Replication configured, select metrics populate under the Cluster Metrics endpoint.
Traffic Metrics
Usage Metrics
Requests Metrics
Resource Metrics
MinIO collects the following resource metrics at the node level.
Each metric includes the server
label to identify the corresponding node.
Metrics may include one or more additional labels, such as the drive path, interface name, etc.
These metrics can be obtained from any MinIO server once per collection by using the following URL:
https://HOSTNAME:PORT/minio/v2/metrics/resource
Replace HOSTNAME:PORT
with the hostname of your MinIO deployment.
For deployments behind a load balancer, use the load balancer hostname instead of a single node hostname.