minio/docs
1
0
Fork 0
mirror of https://github.com/minio/docs.git synced 2025-09-17 18:22:26 +03:00
Code Activity
Files
main
docs/source/operations/monitoring/metrics-v2.rst
Daryl White 292c604f47 Updates for mc RELEASE.2025-03-12T17-29-24Z (#1441) 
- removes `--logs` flag from `mc support callhome`
- enforces 100 bucket limit for v2 metrics

Closes #1439

Opportunistic fix to remove errant copy/paste for
`--noncurrent-expire-days` flag in `mc ilm rule add`

Closes #1438
2025-04-01 15:04:32 -04:00

4.4 KiB
Raw Permalink Blame History

Metrics version 2

minio

Table of Contents

MinIO publishes cluster and node metrics using the Prometheus Data Model <concepts/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:

  • Cluster Metrics <minio-available-cluster-metrics>
  • Bucket Metrics <minio-available-bucket-metrics>
  • Resource Metrics <minio-available-resource-metrics>

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. <minio-metrics-and-alerts>

Existing deployments can continue to use version 2 metrics <minio-metrics-v2> and Grafana dashboards <minio-grafana>.

MinIO Grafana dashboard

MinIO publishes two Grafana Dashboards <minio-grafana> for visualizing v2 metrics. For more complete documentation on configuring a Prometheus-compatible data source for Grafana, see the Prometheus documentation on Grafana Support <visualization/grafana/>.

Available version 2 metrics

The following sections describe the version 2 endpoints and metrics.

Cluster Metrics

You can scrape cluster-level metrics <minio-available-cluster-metrics> using the following URL endpoint:

http://HOSTNAME:PORT/minio/v2/metrics/cluster

Replace HOSTNAME:PORT with the FQDN (Fully Qualified Domain Name) and port of the MinIO deployment. For deployments with a load balancer managing connections between MinIO nodes, specify the address of the load balancer.

Bucket Metrics

MinIO RELEASE.2023-07-21T21-12-44Z

Bucket metrics have moved to use their own, separate endpoint.

RELEASE.2023-08-31T15-31-16Z

You can scrape bucket-level metrics <minio-available-bucket-metrics> using the following URL endpoint:

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 <minio-metrics-and-alerts-available-metrics> instead.

http://HOSTNAME:PORT/minio/v2/metrics/bucket

Replace HOSTNAME:PORT with the FQDN (Fully Qualified Domain Name) and port of the MinIO deployment. For deployments with a load balancer managing connections between MinIO nodes, specify the address of the load balancer.

Resource Metrics

RELEASE.2023-10-07T15-07-38Z

You can scrape resource metrics <minio-available-resource-metrics> using the following URL endpoint:

http://HOSTNAME:PORT/minio/v2/metrics/resource

Replace HOSTNAME:PORT with the FQDN (Fully Qualified Domain Name) 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-available-cluster-metrics>
  • Bucket Metrics <minio-available-bucket-metrics>
  • Resource Metrics <minio-available-resource-metrics>

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 <minio-metrics-and-alerts-available-metrics> instead.