MinIO

Prometheus Metrics

MinIO is a high-performance, S3-compatible object storage system that exposes native Prometheus metrics.

Prometheus Metrics

Service Configuration

Prometheus metrics are available by default on the MinIO API port (9000) at /minio/v2/metrics/cluster, but the endpoint requires authentication.

Option 1: Public metrics (no authentication)

Set the following environment variable to expose metrics without authentication:

MINIO_PROMETHEUS_AUTH_TYPE=public

Option 2: Authenticated access with bearer token

Generate a bearer token using the MinIO client:

mc admin prometheus generate <alias>

Note the token value from the output for the Glouton configuration below.

Glouton Configuration

Linux

sudo tee /etc/glouton/conf.d/99-minio.conf > /dev/null << 'EOF'
metric:
  prometheus:
    targets:
      - url: "http://localhost:9000/minio/v2/metrics/cluster"
        name: "minio"
        allow_metrics:
          - "minio_s3_requests_total"
          - "minio_s3_requests_errors_total"
          - "minio_s3_traffic_received_bytes"
          - "minio_s3_traffic_sent_bytes"
          - "minio_bucket_usage_total_bytes"
          - "minio_cluster_nodes_online_total"
          - "minio_node_disk_used_bytes"
EOF

Windows

Create or edit C:\ProgramData\glouton\conf.d\99-minio.conf:

metric:
  prometheus:
    targets:
      - url: "http://localhost:9000/minio/v2/metrics/cluster"
        name: "minio"
        allow_metrics:
          - "minio_s3_requests_total"
          - "minio_s3_requests_errors_total"
          - "minio_s3_traffic_received_bytes"
          - "minio_s3_traffic_sent_bytes"
          - "minio_bucket_usage_total_bytes"
          - "minio_cluster_nodes_online_total"
          - "minio_node_disk_used_bytes"

If you are using authenticated access, add an Authorization header to the target:

metric:
  prometheus:
    targets:
      - url: "http://localhost:9000/minio/v2/metrics/cluster"
        name: "minio"
        headers:
          Authorization: "Bearer <your-bearer-token>"
        allow_metrics:
          - "minio_s3_requests_total"
          - "minio_s3_requests_errors_total"
          - "minio_s3_traffic_received_bytes"
          - "minio_s3_traffic_sent_bytes"
          - "minio_bucket_usage_total_bytes"
          - "minio_cluster_nodes_online_total"
          - "minio_node_disk_used_bytes"

Customize collected metrics

The metrics below are our recommended defaults. You can adjust the allow_metrics list to include any metric from MinIO’s metrics documentation, or use deny_metrics to exclude specific ones. See Metrics Filtering for details.

Metric	Description
minio_s3_requests_total	Total number of S3 requests
minio_s3_requests_errors_total	Total number of failed S3 requests
minio_s3_traffic_received_bytes	Total bytes received via S3 API
minio_s3_traffic_sent_bytes	Total bytes sent via S3 API
minio_bucket_usage_total_bytes	Total storage used per bucket
minio_cluster_nodes_online_total	Number of online nodes in the cluster
minio_node_disk_used_bytes	Disk space used per node