Documentation

Monitoring and Alerts

Metrics and Alerts

MinIO provides point-in-time metrics on cluster status and operations. The MinIO Console provides a graphical display of these metrics.

For historical metrics and analytics, MinIO publishes cluster and node metrics using the Prometheus Data Model. You can use any scraping tool which supports that data model to pull metrics data from MinIO for further analysis and alerting.

The following table lists tutorials for integrating MinIO metrics with select third-party monitoring software.

Monitoring and Alerting using Prometheus

Configure Prometheus to Monitor and Alert for a MinIO deployment

Configure MinIO to query the Prometheus deployment to enable historical metrics via the MinIO Console

Monitoring and Alerting using InfluxDB

Configure InfluxDB to Monitor and Alert for a MinIO deployment.

Other metrics and analytics software suites which support the Prometheus data model may work regardless of their inclusion on the above list.

Logging

MinIO publishes all minio server operations to the system console. MinIO also supports publishing server logs and audit logs to an HTTP webhook.

  • Server logs contain the same minio server operations logged to the system console. Server logs support general monitoring and troubleshooting of operations.

  • Audit logs are more granular descriptions of each operation on the MinIO deployment. Audit logging supports security standards and regulations which require detailed tracking of operations.

MinIO publishes logs as a JSON document as a PUT request to each configured endpoint. The endpoint server is responsible for processing each JSON document. MinIO requires explicit configuration of each webhook endpoint and does not publish logs to a webhook by default.

See Publish Server or Audit Logs to an External Service for more complete documentation.

Healthchecks

MinIO exposes unauthenticated endpoints for probing node uptime and cluster high availability for simple healthchecks. These endpoints return only an HTTP status code. See Healthcheck API for more information.