Grafana Cloud

MinIO integration for Grafana Cloud

MinIO is a Kubernetes-native high performance object storage server compatible with Amazon S3. This integration enables the agent to send metrics to Grafana Cloud along with a useful default dashboard for visualization.

Install MinIO integration for Grafana Cloud

  1. In your Grafana instance, Click Integrations and Connections (lightning bolt icon), then click on install integration on MinIO tile.
  2. Wait for the integration to be installed and then follow the steps shown to setup Grafana Agent to automatically scrape and send MinIO metrics to your Cloud Instance.

Pre-install configuration for the MinIO integration

This integration monitors a single MinIO server.

Post-install configuration for the MinIO integration

By default, the agent configuration expects the MINIO_PROMETHEUS_AUTH_TYPE to be set to ‘public’.

If you choose not to set this flag you will need to update the agent configuration prometheus scrape job integrations/minio to include bearer_token generated with mc admin prometheus generate <alias>. You can read more in the monitoring minio docs.

  # ...
  - name: integrations:
    - job_name: integrations/minio
      bearer_token: <secret>
      scrape_interval: 60s
      metrics_path: /minio/prometheus/metrics
        - targets: ['localhost:9000']


This integration includes the following dashboards.

  • MinIO distributed cluster metrics

Minio distributed metrics overview



Below is a list of the metrics used on the dashboards and in alerts of the integration and are automatically written to your Grafana Cloud instance.

  • bucket_objects_count
  • bucket_objects_histogram
  • bucket_usage_size
  • disk_storage_available
  • disk_storage_total
  • disk_storage_used
  • internode_rx_bytes_total
  • internode_tx_bytes_total
  • minio_disks_offline
  • minio_disks_total
  • minio_version_info
  • s3_errors_total
  • s3_requests_total
  • s3_ttfb_seconds_bucket
  • s3_ttfb_seconds_count
  • s3_ttfb_seconds_sum


The integration also comes packaged with a number of handy alerts.

Group: minio

MinioDisksOfflineCritical: MinIO disks offline.
MinioStorageUsedWarning: MinIO disks high storage used percentage.


# 0.0.4 - December 2022

- Update mixin to latest
  - Add instance selector
- Add screenshot

# 0.0.3 - September 2022

- Update dashboard panels descriptions.

# 0.0.2 - October 2021

- Update mixin to latest version:
  - Update queries to use $\_\_rate_interval

# 0.0.1 - November 2020

- Initial release


By connecting your MinIO instance to Grafana Cloud you might incur charges. To view information on the number of active series that your Grafana Cloud account uses for metrics included in each Cloud tier, see Active series and dpm usage and Cloud tier pricing.