Metrics v3 Reference

The following reference lists every v3 metric available in MinIO AIStor.

All metrics are available under the base endpoint /minio/metrics/v3. See Metrics and Alerts for configuration and Prometheus integration.

Table of Contents


API

PathDescription
/api/requestsMetrics about API requests served by the current node.
/bucket/apiPer-bucket API request metrics. Requires bucket query parameter.

API Requests

Path: /api/requests

Metrics about API requests served by the current node.

NameDescriptionLabels
minio_api_requests_rejected_auth_totalTotal number of requests rejected due to authentication failure

Type: counter
type, server
minio_api_requests_rejected_header_totalTotal number of requests rejected due to invalid or malformed headers

Type: counter
type, server
minio_api_requests_rejected_timestamp_totalTotal number of requests rejected due to invalid or expired timestamps

Type: counter
type, server
minio_api_requests_rejected_invalid_totalTotal number of requests rejected due to invalid request format or parameters

Type: counter
type, server
minio_api_requests_rejected_notimplemented_totalTotal number of requests rejected because the API operation is not implemented

Type: counter
type, server
minio_api_requests_write_verification_failures_totalTotal number of PutObject/PutObjectPart requests that failed write verification. Tracks data integrity failures where the server could not verify the data was written correctly

Type: counter
type, server
minio_api_requests_waiting_totalCurrent number of requests waiting in the queue before being processed

Type: gauge
type, server
minio_api_requests_incoming_totalCurrent number of incoming requests being accepted by the server

Type: gauge
type, server
minio_api_requests_inflight_totalCurrent number of API requests actively being processed

Type: gauge
name, type, server
minio_api_requests_totalTotal number of API requests processed since server start

Type: counter
name, type, server
minio_api_requests_errors_totalTotal number of API requests that resulted in 4xx or 5xx error responses

Type: counter
name, type, server
minio_api_requests_5xx_errors_totalTotal number of API requests that resulted in 5xx server error responses

Type: counter
name, type, server
minio_api_requests_4xx_errors_totalTotal number of API requests that resulted in 4xx client error responses

Type: counter
name, type, server
minio_api_requests_canceled_totalTotal number of API requests canceled by the client before completion

Type: counter
name, type, server
minio_api_requests_response_totalTotal number of API requests grouped by HTTP status code

Type: counter
name, type, code, server
minio_api_requests_ttfb_seconds_distributionHistogram distribution of time to first byte (TTFB) in seconds for API requests

Type: counter
name, type, le, server
minio_api_requests_duration_totalTotal cumulative duration of all API requests in milliseconds since server start

Type: counter
name, type, server
minio_api_requests_traffic_sent_bytesTotal number of bytes sent in API responses since server start

Type: counter
type, server
minio_api_requests_traffic_received_bytesTotal number of bytes received in API requests since server start

Type: counter
type, server
minio_api_requests_stale_multipart_drive_purged_totalTotal stale multipart upload entries purged, node-level total across all drives

Type: counter
server
minio_api_requests_stale_tmp_windows_drive_purged_totalTotal expired temporary write directories purged, node-level total across all drives

Type: counter
server
minio_api_requests_stale_multipart_drive_cleanup_cycles_totalTotal stale multipart cleanup cycles completed, node-level total across all drives

Type: counter
server
minio_api_requests_stale_multipart_last_cleanup_secondsSeconds since the most recent stale multipart cleanup cycle completed on this node

Type: gauge
server

Bucket API

Path: /bucket/api

Per-bucket API request metrics. Requires bucket query parameter.

NameDescriptionLabels
minio_bucket_api_traffic_received_bytesTotal number of bytes received for a bucket

Type: counter
bucket, type, server
minio_bucket_api_traffic_sent_bytesTotal number of bytes sent for a bucket

Type: counter
bucket, type, server
minio_bucket_api_inflight_totalTotal number of requests currently in flight for a bucket

Type: gauge
bucket, name, type, server
minio_bucket_api_totalTotal number of requests for a bucket

Type: counter
bucket, name, type, server
minio_bucket_api_canceled_totalTotal number of requests canceled by the client for a bucket

Type: counter
bucket, name, type, server
minio_bucket_api_4xx_errors_totalTotal number of requests with 4xx errors for a bucket

Type: counter
bucket, name, type, server
minio_bucket_api_5xx_errors_totalTotal number of requests with 5xx errors for a bucket

Type: counter
bucket, name, type, server
minio_bucket_api_response_totalTotal number of API requests for a bucket grouped by HTTP status code

Type: counter
bucket, name, type, code, server
minio_bucket_api_ttfb_seconds_distributionDistribution of time to first byte across API calls for a bucket

Type: counter
bucket, name, le, type, server
minio_bucket_api_last_minute_qos_throttled_totalTotal number of requests throttled by QoS in the last minute for a bucket

Type: gauge
bucket, name, ruleID, prefix, server
minio_bucket_api_qos_req_configured_counts_per_secondConfigured QoS rate limit in requests per second, counted per rule

Type: gauge
bucket, name, ruleID, prefix, server
minio_bucket_api_last_minute_qos_rate_limit_exceeded_countsTotal number of requests exceeding rate limit for a bucket in the last full minute

Type: gauge
bucket, name, ruleID, prefix, server

Audit

PathDescription
/auditMetrics about audit logging.

Audit

Path: /audit

Metrics about audit logging.

NameDescriptionLabels
minio_audit_failed_messagesTotal number of messages that failed to send since start

Type: counter
target_id, server
minio_audit_target_queue_lengthNumber of unsent messages in queue for target

Type: gauge
target_id, server
minio_audit_total_messagesTotal number of messages sent since start

Type: counter
target_id, server
minio_audit_global_queue_sizeTotal number of events in queue for all targets

Type: counter
target_id, server
minio_audit_total_requestsTotal number of requests made to the audit endpoint

Type: counter
target_id, server
minio_audit_failed_requestsTotal number of failed requests when sending to the audit endpoint

Type: counter
target_id, server
minio_audit_total_targetsTotal number of audit endpoint targets

Type: counter
target_id, server
minio_audit_worker_countTotal number of async audit workers

Type: counter
target_id, server
minio_audit_disk_sizeTotal size on disk in bytes, for the global audit event queue

Type: counter
target_id, server
minio_audit_disk_file_countTotal number of files on disk related to the global audit event queue

Type: counter
target_id, server

Batch

PathDescription
/batchMetrics about batch jobs.
/bucket/batchPer-bucket batch job metrics. Requires bucket query parameter.

Batch Jobs

Path: /batch

Metrics about batch jobs.

NameDescriptionLabels
minio_batch_jobs_completedNumber of completed batch jobs

Type: gauge
type, server
minio_batch_jobs_failedNumber of failed batch jobs

Type: gauge
type, server
minio_batch_jobs_in_progressNumber of in-progress batch jobs

Type: gauge
type, server

Bucket Batch

Path: /bucket/batch

Per-bucket batch job metrics. Requires bucket query parameter.

NameDescriptionLabels
minio_bucket_batch_objects_completedNumber of objects successfully processed by batch jobs for this bucket

Type: gauge
bucket, type, server
minio_bucket_batch_objects_failedNumber of objects that failed processing by batch jobs for this bucket

Type: gauge
bucket, type, server

Cluster

PathDescription
/cluster/configMetrics about cluster configuration.
/cluster/erasure-setMetrics about erasure set health and status.
/cluster/healthMetrics about cluster health status.
/cluster/usage/bucketsMetrics about per-bucket usage.
/cluster/usage/objectsMetrics about cluster-wide object usage.

Cluster Config

Path: /cluster/config

Metrics about cluster configuration.

NameDescriptionLabels
minio_cluster_config_rrs_parityReduced redundancy storage class parity

Type: gauge
-
minio_cluster_config_standard_parityStandard storage class parity

Type: gauge
-
minio_cluster_config_license_expires_inSeconds until license expires (-1 for never)

Type: gauge
-
minio_cluster_config_license_statusLicense operational status: normal (full functionality), readonly (reads only), offline (no I/O)

Type: gauge
state
minio_cluster_config_license_renewal_statusLicense renewal status: success, failed, expired, or disabled

Type: gauge
result

Cluster Erasure Set

Path: /cluster/erasure-set

Metrics about erasure set health and status.

NameDescriptionLabels
minio_cluster_erasure_set_overall_write_quorumOverall write quorum across pools and sets

Type: gauge
-
minio_cluster_erasure_set_overall_healthOverall health across pools and sets (1=healthy, 0=unhealthy)

Type: gauge
-
minio_cluster_erasure_set_read_quorumRead quorum for the erasure set in a pool

Type: gauge
pool_id, set_id
minio_cluster_erasure_set_write_quorumWrite quorum for the erasure set in a pool

Type: gauge
pool_id, set_id
minio_cluster_erasure_set_online_drives_countCount of online drives in the erasure set in a pool

Type: gauge
pool_id, set_id
minio_cluster_erasure_set_healing_drives_countCount of healing drives in the erasure set in a pool

Type: gauge
pool_id, set_id
minio_cluster_erasure_set_healthHealth of the erasure set in a pool (1=healthy, 0=unhealthy)

Type: gauge
pool_id, set_id
minio_cluster_erasure_set_read_toleranceNumber of drive failures that can be tolerated without disrupting read operations

Type: gauge
pool_id, set_id
minio_cluster_erasure_set_write_toleranceNumber of drive failures that can be tolerated without disrupting write operations

Type: gauge
pool_id, set_id
minio_cluster_erasure_set_read_healthHealth of the erasure set in a pool for read operations (1=healthy, 0=unhealthy)

Type: gauge
pool_id, set_id
minio_cluster_erasure_set_write_healthHealth of the erasure set in a pool for write operations (1=healthy, 0=unhealthy)

Type: gauge
pool_id, set_id

Cluster Health

Path: /cluster/health

Metrics about cluster health status.

NameDescriptionLabels
minio_cluster_health_drives_offline_countCount of offline drives in the cluster

Type: gauge
-
minio_cluster_health_drives_online_countCount of online drives in the cluster

Type: gauge
-
minio_cluster_health_drives_countCount of all drives in the cluster

Type: gauge
-
minio_cluster_health_nodes_offline_countCount of offline nodes in the cluster

Type: gauge
-
minio_cluster_health_nodes_online_countCount of online nodes in the cluster

Type: gauge
-
minio_cluster_health_capacity_raw_total_bytesTotal cluster raw storage capacity in bytes

Type: gauge
-
minio_cluster_health_capacity_raw_free_bytesTotal cluster raw storage free in bytes

Type: gauge
-
minio_cluster_health_capacity_usable_total_bytesTotal cluster usable storage capacity in bytes

Type: gauge
-
minio_cluster_health_capacity_usable_free_bytesTotal cluster usable storage free in bytes

Type: gauge
-

Cluster Usage Buckets

Path: /cluster/usage/buckets

Metrics about per-bucket usage.

NameDescriptionLabels
minio_cluster_usage_buckets_since_last_update_secondsTime since last update of usage metrics in seconds

Type: gauge
-
minio_cluster_usage_buckets_total_bytesTotal bucket size in bytes

Type: gauge
bucket
minio_cluster_usage_buckets_objects_countTotal objects count in bucket

Type: gauge
bucket
minio_cluster_usage_buckets_versions_countTotal object versions count in bucket, including delete markers

Type: gauge
bucket
minio_cluster_usage_buckets_delete_markers_countTotal delete markers count in bucket

Type: gauge
bucket
minio_cluster_usage_buckets_quota_total_bytesTotal bucket quota in bytes

Type: gauge
bucket
minio_cluster_usage_buckets_object_size_distributionBucket object size distribution

Type: gauge
range, bucket
minio_cluster_usage_buckets_object_version_count_distributionBucket object version count distribution

Type: gauge
range, bucket
minio_cluster_usage_buckets_object_age_distributionBucket object age distribution

Type: gauge
range, bucket
minio_cluster_usage_buckets_shards_distributionPer-bucket distribution of failed shard writes

Type: gauge
missing_shards, bucket
minio_cluster_usage_buckets_shards_legacy_countPer-bucket count of object versions without shard write status information

Type: gauge
bucket

Cluster Usage Objects

Path: /cluster/usage/objects

Metrics about cluster-wide object usage.

NameDescriptionLabels
minio_cluster_usage_objects_since_last_update_secondsTime since last update of usage metrics in seconds

Type: gauge
-
minio_cluster_usage_objects_total_bytesTotal cluster usage in bytes

Type: gauge
-
minio_cluster_usage_objects_countTotal cluster objects count

Type: gauge
-
minio_cluster_usage_objects_versions_countTotal cluster object versions count, including delete markers

Type: gauge
-
minio_cluster_usage_objects_delete_markers_countTotal cluster delete markers count

Type: gauge
-
minio_cluster_usage_objects_buckets_countTotal cluster buckets count

Type: gauge
-
minio_cluster_usage_objects_size_distributionCluster object size distribution

Type: gauge
range
minio_cluster_usage_objects_version_count_distributionCluster object version count distribution

Type: gauge
range
minio_cluster_usage_objects_age_distributionCluster object age distribution

Type: gauge
range
minio_cluster_usage_objects_shards_distributionCluster-wide distribution of failed shard writes

Type: gauge
missing_shards
minio_cluster_usage_objects_shards_legacyCluster-wide count of object versions without shard write status information

Type: gauge
-

Debug

PathDescription
/debug/erasure-setsDebug metrics for erasure set shard health.
/debug/healDebug metrics for healing operations.

Debug Erasure Sets

Path: /debug/erasure-sets

Debug metrics for erasure set shard health.

NameDescriptionLabels
minio_debug_erasure_sets_shards_healthHealth of the shards in a given erasure set

Type: gauge
pool_id, set_id, drive_id, server

Debug Heal

Path: /debug/heal

Debug metrics for healing operations.

NameDescriptionLabels
minio_debug_heal_manual_intervention_totalTotal objects requiring manual intervention

Type: counter
server
minio_debug_heal_undecided_totalTotal objects in undecided state

Type: counter
server
minio_debug_heal_transitioned_object_totalTotal transitioned objects skipped from dangling detection

Type: counter
server
minio_debug_heal_non_actionable_errors_totalTotal number of objects with non-actionable errors that cannot be automatically healed

Type: counter
server

ILM

PathDescription
/ilmMetrics about Information Lifecycle Management.

ILM

Path: /ilm

Metrics about Information Lifecycle Management.

NameDescriptionLabels
minio_ilm_expiry_pending_tasksNumber of pending ILM expiry tasks in the queue

Type: gauge
server
minio_ilm_transition_active_tasksNumber of active ILM transition tasks

Type: gauge
server
minio_ilm_transition_pending_tasksNumber of pending ILM transition tasks in the queue

Type: gauge
server
minio_ilm_transition_missed_immediate_tasksNumber of missed immediate ILM transition tasks

Type: counter
server
minio_ilm_versions_scannedTotal number of object versions checked for ILM actions since server start

Type: counter
server
minio_ilm_transitioned_bytesTotal bytes transitioned to a tier

Type: gauge
tier, server
minio_ilm_transitioned_objectsTotal number of objects transitioned to a tier

Type: gauge
tier, server
minio_ilm_transitioned_versionsTotal number of versions transitioned to a tier

Type: gauge
tier, server
minio_ilm_expiry_missed_free_versionsNumber of missed free version deletion tasks

Type: counter
server
minio_ilm_expiry_missed_tasksNumber of missed ILM expiry tasks

Type: counter
server
minio_ilm_expiry_missed_tier_journal_tasksNumber of missed tier journal tasks

Type: counter
server
minio_ilm_expiry_num_workersCurrent size of the ILM expiry worker pool

Type: gauge
server
minio_ilm_transition_num_workersCurrent size of the ILM transition worker pool

Type: gauge
server
minio_ilm_action_count_deleteTotal action outcome of lifecycle checks for deleting object

Type: counter
server
minio_ilm_action_count_delete_versionTotal action outcome of lifecycle checks for deleting object version

Type: counter
server
minio_ilm_action_count_delete_all_versionsTotal action outcome of lifecycle checks for deleting all object versions

Type: counter
server
minio_ilm_action_count_transitionTotal action outcome of lifecycle checks for transitioning object

Type: counter
server
minio_ilm_action_count_transition_versionTotal action outcome of lifecycle checks for transitioning object version

Type: counter
server
minio_ilm_action_count_delete_restoredTotal action outcome of lifecycle checks for deleting restored object

Type: counter
server
minio_ilm_action_count_delete_restored_versionTotal action outcome of lifecycle checks for deleting restored object version

Type: counter
server

IAM

PathDescription
/iamMetrics about IAM operations and authentication plugins.

IAM

Path: /iam

Metrics about IAM operations and authentication plugins.

NameDescriptionLabels
minio_iam_last_sync_duration_millisLast successful IAM data sync duration in milliseconds

Type: counter
server
minio_iam_plugin_authn_service_failed_requests_minuteWhen plugin authentication is configured, returns failed requests count in the last full minute

Type: counter
server
minio_iam_plugin_authn_service_last_fail_secondsWhen plugin authentication is configured, returns time (in seconds) since the last failed request to the service

Type: counter
server
minio_iam_plugin_authn_service_last_succ_secondsWhen plugin authentication is configured, returns time (in seconds) since the last successful request to the service

Type: counter
server
minio_iam_plugin_authn_service_succ_avg_rtt_ms_minuteWhen plugin authentication is configured, returns average round-trip time of successful requests in the last full minute

Type: counter
server
minio_iam_plugin_authn_service_succ_max_rtt_ms_minuteWhen plugin authentication is configured, returns maximum round-trip time of successful requests in the last full minute

Type: counter
server
minio_iam_plugin_authn_service_total_requests_minuteWhen plugin authentication is configured, returns total requests count in the last full minute

Type: counter
server
minio_iam_since_last_sync_millisTime (in milliseconds) since last successful IAM data sync.

Type: counter
server
minio_iam_sync_failuresNumber of failed IAM data syncs since server start.

Type: counter
server
minio_iam_sync_successesNumber of successful IAM data syncs since server start.

Type: counter
server
minio_iam_ldap_idp_healthLDAP IDP connectivity health check status (1 = successful, 0 = failed)

Type: gauge
server

Logger Webhook

PathDescription
/webhookMetrics about webhook logging targets.

Webhook

Path: /webhook

Metrics about webhook logging targets.

NameDescriptionLabels
minio_webhook_onlineIs the webhook online (1=online, 0=offline)

Type: gauge
name, endpoint, server
minio_webhook_queue_lengthWebhook queue length

Type: gauge
name, endpoint, server
minio_webhook_total_messagesTotal number of messages sent to this webhook target

Type: counter
name, endpoint, server
minio_webhook_failed_messagesTotal number of messages that failed to send to this webhook target

Type: counter
name, endpoint, server

Logs

PathDescription
/logs/filterRecords dropped by the per-stream exclusion filters configured via exclude_apis / exclude_events.

Log Exclusion Filters

Path: /logs/filter

Records dropped by the per-stream exclusion filters configured via exclude_apis / exclude_events.

NameDescriptionLabels
minio_logs_filter_dropped_totalTotal records dropped before recording by the configured exclusion filter

Type: counter
stream, server

Notification

PathDescription
/notificationMetrics about bucket notification events.

Notification

Path: /notification

Metrics about bucket notification events.

NameDescriptionLabels
minio_notification_events_errors_totalTotal number of events that failed to send to the targets

Type: counter
server
minio_notification_events_send_in_progressNumber of concurrent async Send calls active to all targets

Type: counter
server
minio_notification_events_sent_totalTotal number of events sent to the targets

Type: counter
server
minio_notification_events_skipped_totalNumber of events not sent to the targets due to the in-memory queue being full

Type: counter
server
minio_notification_target_current_send_in_progressNumber of concurrent async Send calls active for this target

Type: gauge
target_id, server
minio_notification_target_queue_lengthNumber of unsent notifications in queue for this target

Type: gauge
target_id, server
minio_notification_target_total_eventsTotal number of events sent to this target

Type: counter
target_id, server
minio_notification_target_failed_eventsTotal number of failed events for this target

Type: counter
target_id, server

Replication

PathDescription
/bucket/replicationPer-bucket replication metrics. Requires bucket query parameter.
/cluster/replicationMetrics about cluster-level replication.
/replicationNode-level replication queue and worker metrics.

Bucket Replication

Path: /bucket/replication

Per-bucket replication metrics. Requires bucket query parameter.

NameDescriptionLabels
minio_bucket_replication_last_hour_failed_bytesTotal number of bytes on a bucket which failed to replicate at least once in the last hour

Type: gauge
bucket, targetArn, server
minio_bucket_replication_last_hour_failed_countTotal number of objects on a bucket which failed to replicate in the last hour

Type: gauge
bucket, targetArn, server
minio_bucket_replication_last_minute_failed_bytesTotal number of bytes on a bucket which failed at least once in the last full minute

Type: gauge
bucket, targetArn, server
minio_bucket_replication_last_minute_failed_countTotal number of objects on a bucket which failed to replicate in the last full minute

Type: gauge
bucket, targetArn, server
minio_bucket_replication_latency_msReplication latency on a bucket in milliseconds

Type: gauge
bucket, operation, range, targetArn, server
minio_bucket_replication_proxied_delete_tagging_requests_totalNumber of DELETE tagging requests proxied to replication target

Type: counter
bucket, targetArn, server
minio_bucket_replication_proxied_get_requests_failuresNumber of failures in GET requests proxied to replication target

Type: counter
bucket, targetArn, server
minio_bucket_replication_proxied_get_requests_totalNumber of GET requests proxied to replication target

Type: counter
bucket, targetArn, server
minio_bucket_replication_proxied_get_tagging_requests_failuresNumber of failures in GET tagging requests proxied to replication target

Type: counter
bucket, targetArn, server
minio_bucket_replication_proxied_get_tagging_requests_totalNumber of GET tagging requests proxied to replication target

Type: counter
bucket, targetArn, server
minio_bucket_replication_proxied_head_requests_failuresNumber of failures in HEAD requests proxied to replication target

Type: counter
bucket, targetArn, server
minio_bucket_replication_proxied_head_requests_totalNumber of HEAD requests proxied to replication target

Type: counter
bucket, targetArn, server
minio_bucket_replication_proxied_put_tagging_requests_failuresNumber of failures in PUT tagging requests proxied to replication target

Type: counter
bucket, targetArn, server
minio_bucket_replication_proxied_put_tagging_requests_totalNumber of PUT tagging requests proxied to replication target

Type: counter
bucket, targetArn, server
minio_bucket_replication_sent_bytesTotal number of bytes replicated to the target

Type: counter
bucket, targetArn, server
minio_bucket_replication_sent_countTotal number of objects replicated to the target

Type: counter
bucket, targetArn, server
minio_bucket_replication_received_countTotal number of objects received from the source

Type: counter
bucket, server
minio_bucket_replication_received_bytesTotal number of bytes received from the source

Type: counter
bucket, server
minio_bucket_replication_total_failed_bytesTotal number of bytes failed to replicate at least once since server start

Type: counter
bucket, targetArn, server
minio_bucket_replication_total_failed_countTotal number of objects that failed to replicate since server start

Type: counter
bucket, targetArn, server
minio_bucket_replication_proxied_delete_tagging_requests_failuresNumber of failures in DELETE tagging requests proxied to replication target

Type: counter
bucket, targetArn, server
minio_bucket_replication_credential_errorsTotal number of credential errors in bucket replication since server start

Type: counter
bucket, targetArn, server

Cluster Replication

Path: /cluster/replication

Metrics about cluster-level replication.

NameDescriptionLabels
minio_cluster_replication_received_bytesTotal number of bytes replicated to this cluster from site replication peer

Type: counter
-
minio_cluster_replication_received_countTotal number of objects received by this cluster

Type: gauge
-
minio_cluster_replication_proxied_get_request_totalNumber of GET requests proxied to replication target

Type: counter
-
minio_cluster_replication_proxied_head_request_totalNumber of HEAD requests proxied to replication target

Type: counter
-
minio_cluster_replication_proxied_put_tagging_request_totalNumber of PUT tagging requests proxied to replication target

Type: counter
-
minio_cluster_replication_proxied_get_tagging_request_totalNumber of GET tagging requests proxied to replication target

Type: counter
-
minio_cluster_replication_proxied_delete_tagging_request_totalNumber of DELETE tagging requests proxied to replication target

Type: counter
-
minio_cluster_replication_proxied_get_request_failuresNumber of failures in GET requests proxied to replication target

Type: counter
-
minio_cluster_replication_proxied_head_request_failuresNumber of failures in HEAD requests proxied to replication target

Type: counter
-
minio_cluster_replication_proxied_put_tagging_request_failuresNumber of failures in PUT tagging proxy requests to replication target

Type: counter
-
minio_cluster_replication_proxied_get_tagging_request_failuresNumber of failures in GET tagging proxy requests to replication target

Type: counter
-
minio_cluster_replication_proxied_delete_tagging_request_failuresNumber of failures in DELETE tagging proxy requests to replication target

Type: counter
-
minio_cluster_replication_queued_bytesNumber of bytes queued for site replication

Type: gauge
-
minio_cluster_replication_queued_countNumber of objects queued for site replication

Type: gauge
-
minio_cluster_replication_in_progress_bytesNumber of bytes currently being replicated for site replication

Type: gauge
-
minio_cluster_replication_in_progress_countNumber of objects currently being replicated for site replication

Type: gauge
-
minio_cluster_replication_active_workersCurrent number of active site replication workers

Type: gauge
-
minio_cluster_replication_retries_last_hourNumber of site replication retries in the last hour

Type: gauge
-
minio_cluster_replication_retries_last_minuteNumber of site replication retries in the last minute

Type: gauge
-
minio_cluster_replication_retries_totalTotal number of site replication retries since server start

Type: counter
-
minio_cluster_replication_errors_last_hourNumber of site replication errors in the last hour

Type: gauge
-
minio_cluster_replication_errors_last_minuteNumber of site replication errors in the last minute

Type: gauge
-
minio_cluster_replication_errors_totalTotal number of site replication errors since server start

Type: counter
-
minio_cluster_replication_sent_bytesTotal number of bytes replicated to the target

Type: counter
endpoint
minio_cluster_replication_sent_countTotal number of objects replicated to the target

Type: gauge
endpoint
minio_cluster_replication_last_minute_failed_bytesTotal number of bytes failed at least once to replicate in the last full minute

Type: gauge
endpoint
minio_cluster_replication_last_minute_failed_countTotal number of objects which failed replication in the last full minute

Type: gauge
endpoint
minio_cluster_replication_last_hour_failed_bytesTotal number of bytes failed at least once to replicate in the last hour

Type: gauge
endpoint
minio_cluster_replication_last_hour_failed_countTotal number of objects which failed replication in the last hour

Type: gauge
endpoint
minio_cluster_replication_total_failed_bytesTotal number of bytes failed at least once to replicate since server uptime

Type: counter
endpoint
minio_cluster_replication_total_failed_countTotal number of objects which failed replication since server uptime

Type: counter
endpoint
minio_cluster_replication_credential_errorsTotal number of credential errors in site replication

Type: counter
endpoint

Node Replication

Path: /replication

Node-level replication queue and worker metrics.

NameDescriptionLabels
minio_replication_average_active_workersAverage number of active replication workers

Type: gauge
server
minio_replication_average_queued_bytesAverage number of bytes queued for replication since server start

Type: gauge
server
minio_replication_average_queued_countAverage number of objects queued for replication since server start

Type: gauge
server
minio_replication_average_transfer_rateAverage replication data transfer rate in bytes/sec

Type: gauge
server
minio_replication_current_active_workersTotal number of active replication workers

Type: gauge
server
minio_replication_current_transfer_rateCurrent replication data transfer rate in bytes/sec

Type: gauge
server
minio_replication_last_minute_queued_bytesNumber of bytes queued for replication in the last full minute

Type: gauge
server
minio_replication_last_minute_queued_countNumber of objects queued for replication in the last full minute

Type: gauge
server
minio_replication_max_active_workersMaximum number of active replication workers seen since server start

Type: gauge
server
minio_replication_max_queued_bytesMaximum number of bytes queued for replication since server start

Type: gauge
server
minio_replication_max_queued_countMaximum number of objects queued for replication since server start

Type: gauge
server
minio_replication_max_transfer_rateMaximum replication data transfer rate in bytes/sec since server start

Type: gauge
server
minio_replication_recent_backlog_countTotal number of objects seen in replication backlog in the last 5 minutes

Type: gauge
server
minio_replication_average_link_latency_msAverage replication link latency in milliseconds

Type: gauge
endpoint, server
minio_replication_current_link_latency_msCurrent replication link latency in milliseconds

Type: gauge
endpoint, server
minio_replication_max_link_latency_msMaximum replication link latency in milliseconds

Type: gauge
endpoint, server
minio_replication_link_onlineReplication link online status (1 for online, 0 for offline)

Type: gauge
endpoint, server
minio_replication_link_offline_duration_secondsTotal time replication link has been offline in seconds

Type: counter
endpoint, server
minio_replication_link_downtime_duration_secondsTotal downtime duration for replication link in seconds

Type: counter
endpoint, server
minio_replication_missed_threshold_totalTotal count of S3 RTC MissedThreshold events (replication failed after exceeding the configured threshold)

Type: counter
server
minio_replication_replicated_after_threshold_totalTotal count of S3 RTC ReplicatedAfterThreshold events (replication succeeded but exceeded the configured threshold)

Type: counter
server

Scanner

PathDescription
/scannerMetrics about the background scanner.

Scanner

Path: /scanner

Metrics about the background scanner.

NameDescriptionLabels
minio_scanner_bucket_scans_finishedTotal number of bucket scans completed since server start

Type: counter
server
minio_scanner_bucket_scans_startedTotal number of bucket scans started since server start

Type: counter
server
minio_scanner_directories_scannedTotal number of directories scanned since server start

Type: counter
server
minio_scanner_objects_scannedTotal number of unique objects scanned since server start

Type: counter
server
minio_scanner_versions_scannedTotal number of object versions scanned since server start

Type: counter
server
minio_scanner_last_activity_secondsTime elapsed (in seconds) since last scan activity

Type: gauge
server
minio_scanner_excess_folders_totalTotal count of excessive sub-folder detections since server start

Type: counter
server
minio_scanner_excess_versions_totalTotal count of excessive versions detections since server start

Type: counter
server
minio_scanner_skipped_folders_totalTotal folders skipped after a scan error, so their contents are missing from usage

Type: counter
server

System

PathDescription
/api/rdmaMetrics about S3-over-RDMA (GPU-Direct) operations.
/system/cpuMetrics about CPU usage.
/system/driveMetrics about storage drives.
/system/drive/smartS.M.A.R.T. disk health monitoring metrics with failure prediction.
/system/memoryMetrics about system memory usage.
/system/network/certificateMetrics about TLS certificates.
/system/network/interfaceMetrics about network interfaces.
/system/network/internodeMetrics about internode network communication.
/system/network/internode/rdmaMetrics about internode RDMA network communication.
/system/processMetrics about the MinIO server process.

API RDMA GPU-Direct

Path: /api/rdma

Metrics about S3-over-RDMA (GPU-Direct) operations.

NameDescriptionLabels
minio_api_rdma_write_bytes_totalTotal bytes written via S3-over-RDMA (GPU-Direct)

Type: counter
server
minio_api_rdma_read_bytes_totalTotal bytes read via S3-over-RDMA (GPU-Direct)

Type: counter
server
minio_api_rdma_write_ops_totalTotal S3-over-RDMA write operations (GPU-Direct)

Type: counter
server
minio_api_rdma_read_ops_totalTotal S3-over-RDMA read operations (GPU-Direct)

Type: counter
server
minio_api_rdma_errors_totalTotal S3-over-RDMA errors by category (GPU-Direct)

Type: counter
category, server

System CPU

Path: /system/cpu

Metrics about CPU usage.

NameDescriptionLabels
minio_system_cpu_loadSystem load average over the last 1 minute representing the average number of runnable processes

Type: gauge
server
minio_system_cpu_load_percSystem load average over the last 1 minute expressed as a percentage of available CPU cores

Type: gauge
server
minio_system_cpu_nicePercentage of CPU time spent running user processes with positive nice priority values

Type: gauge
server
minio_system_cpu_stealPercentage of CPU time stolen by the hypervisor for other virtual machines in virtualized environments

Type: gauge
server
minio_system_cpu_systemPercentage of CPU time spent executing kernel system calls and routines

Type: gauge
server
minio_system_cpu_userPercentage of CPU time spent executing user-space application code

Type: gauge
server
minio_system_cpu_user_avgAverage percentage of CPU time spent executing user-space application code

Type: gauge
server
minio_system_cpu_user_maxMaximum percentage of CPU time spent executing user-space application code

Type: gauge
server
minio_system_cpu_system_avgAverage percentage of CPU time spent executing kernel system calls and routines

Type: gauge
server
minio_system_cpu_system_maxMaximum percentage of CPU time spent executing kernel system calls and routines

Type: gauge
server
minio_system_cpu_idle_avgAverage percentage of CPU time spent idle (not processing any tasks)

Type: gauge
server
minio_system_cpu_idle_maxMaximum percentage of CPU time spent idle (not processing any tasks)

Type: gauge
server
minio_system_cpu_iowait_avgAverage percentage of CPU time spent waiting for I/O operations to complete

Type: gauge
server
minio_system_cpu_iowait_maxMaximum percentage of CPU time spent waiting for I/O operations to complete

Type: gauge
server
minio_system_cpu_nice_avgAverage percentage of CPU time spent running user processes with positive nice priority values

Type: gauge
server
minio_system_cpu_nice_maxMaximum percentage of CPU time spent running user processes with positive nice priority values

Type: gauge
server
minio_system_cpu_steal_avgAverage percentage of CPU time stolen by the hypervisor for other virtual machines in virtualized environments

Type: gauge
server
minio_system_cpu_steal_maxMaximum percentage of CPU time stolen by the hypervisor for other virtual machines in virtualized environments

Type: gauge
server
minio_system_cpu_load_avgAverage system load over the last 1 minute representing the average number of runnable processes

Type: gauge
server
minio_system_cpu_load_maxMaximum system load over the last 1 minute representing the average number of runnable processes

Type: gauge
server
minio_system_cpu_load_perc_avgAverage system load over the last 1 minute expressed as a percentage of available CPU cores

Type: gauge
server
minio_system_cpu_load_perc_maxMaximum system load over the last 1 minute expressed as a percentage of available CPU cores

Type: gauge
server
minio_system_cpu_load5System load average over the last 5 minutes representing the average number of runnable processes

Type: gauge
server
minio_system_cpu_load5_avgAverage system load over the last 5 minutes representing the average number of runnable processes

Type: gauge
server
minio_system_cpu_load5_maxMaximum system load over the last 5 minutes representing the average number of runnable processes

Type: gauge
server
minio_system_cpu_load5_percSystem load average over the last 5 minutes expressed as a percentage of available CPU cores

Type: gauge
server
minio_system_cpu_load5_perc_avgAverage system load over the last 5 minutes expressed as a percentage of available CPU cores

Type: gauge
server
minio_system_cpu_load5_perc_maxMaximum system load over the last 5 minutes expressed as a percentage of available CPU cores

Type: gauge
server
minio_system_cpu_load15System load average over the last 15 minutes representing the average number of runnable processes

Type: gauge
server
minio_system_cpu_load15_avgAverage system load over the last 15 minutes representing the average number of runnable processes

Type: gauge
server
minio_system_cpu_load15_maxMaximum system load over the last 15 minutes representing the average number of runnable processes

Type: gauge
server
minio_system_cpu_load15_percSystem load average over the last 15 minutes expressed as a percentage of available CPU cores

Type: gauge
server
minio_system_cpu_load15_perc_avgAverage system load over the last 15 minutes expressed as a percentage of available CPU cores

Type: gauge
server
minio_system_cpu_load15_perc_maxMaximum system load over the last 15 minutes expressed as a percentage of available CPU cores

Type: gauge
server

System Drive

Path: /system/drive

Metrics about storage drives.

NameDescriptionLabels
minio_system_drive_used_bytesTotal storage used on a drive in bytes

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_free_bytesTotal storage free on a drive in bytes

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_total_bytesTotal storage available on a drive in bytes

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_used_inodesTotal used inodes on a drive

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_free_inodesTotal free inodes on a drive

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_total_inodesTotal inodes available on a drive

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_timeout_errors_totalTotal timeout errors on a drive

Type: counter
drive, pool_index, set_index, drive_index, server
minio_system_drive_io_errors_totalTotal I/O errors on a drive

Type: counter
drive, pool_index, set_index, drive_index, server
minio_system_drive_availability_errors_totalTotal availability errors (I/O errors, timeouts) on a drive

Type: counter
drive, pool_index, set_index, drive_index, server
minio_system_drive_waiting_ioTotal waiting I/O operations on a drive

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_api_latency_microsAverage last minute latency in µs for drive API storage operations

Type: gauge
drive, pool_index, set_index, drive_index, api, server
minio_system_drive_healthDrive health (0 = offline, 1 = healthy, 2 = healing)

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_offline_countCount of offline drives

Type: gauge
server
minio_system_drive_online_countCount of online drives

Type: gauge
server
minio_system_drive_countCount of all drives

Type: gauge
server
minio_system_drive_reads_per_secReads per second on a drive

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_reads_kb_per_secKilobytes read per second on a drive

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_reads_awaitAverage time for read requests served on a drive

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_writes_per_secWrites per second on a drive

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_writes_kb_per_secKilobytes written per second on a drive

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_writes_awaitAverage time for write requests served on a drive

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_perc_utilPercentage of time the drive was busy

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_cache_capacityTotal configured cache capacity

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_cache_usedTotal drive cache currently used

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_cache_hitsTotal drive cache hits

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_cache_missesTotal drive cache misses

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_cache_delete_hitsTotal drive cache delete hits

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_cache_delete_missesTotal drive cache delete misses

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_cache_collisionsTotal drive cache collisions

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_corruption_detected_totalTotal number of silent data corruption errors (bitrot) detected on the drive since server start

Type: counter
drive, pool_index, set_index, drive_index, server
minio_system_drive_corruption_healed_totalTotal number of corrupted objects healed on the drive since server start

Type: counter
drive, pool_index, set_index, drive_index, server
minio_system_drive_trash_purged_bytes_totalTotal bytes purged from the drive’s trash directory

Type: counter
drive, pool_index, set_index, drive_index, server
minio_system_drive_trash_purged_objects_totalTotal entries purged from the drive’s trash directory

Type: counter
drive, pool_index, set_index, drive_index, server
minio_system_drive_trash_last_cleanup_secondsSeconds since the last trash cleanup completed on the drive

Type: gauge
drive, pool_index, set_index, drive_index, server

System Drive SMART

Path: /system/drive/smart

S.M.A.R.T. disk health monitoring metrics with failure prediction.

NameDescriptionLabels
minio_system_drive_smart_statusDrive SMART health status (0=unknown, 1=healthy, 2=warning, 3=critical, 4=collection_error)

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_smart_temperature_celsiusDrive temperature in Celsius from SMART data

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_smart_power_on_hoursDrive power-on hours from SMART data

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_smart_power_cyclesDrive power cycle count from SMART data

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_smart_failure_riskEstimated annual drive failure risk (0.0-1.0+)

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_smart_available_spare_percentNVMe available spare capacity percentage

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_smart_percentage_usedNVMe percentage of rated endurance used

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_smart_media_errorsNVMe media and data integrity error count

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_smart_reallocated_sectorsSATA reallocated sector count (failure predictor)

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_smart_pending_sectorsSATA current pending sector count (failure predictor)

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_smart_offline_uncorrectableSATA offline uncorrectable sector count (failure predictor)

Type: gauge
drive, pool_index, set_index, drive_index, server
minio_system_drive_smart_megaraid_pd_stateMegaRAID physical drive firmware state (0=unconfiguredGood, 1=unconfiguredBad, 2=hotSpare, 16=offline, 17=failed, 20=rebuild, 24=online, 32=copyback, 64=system)

Type: gauge
controller, enclosure, slot, server
minio_system_drive_smart_megaraid_pd_media_errorsMegaRAID physical drive media error count

Type: gauge
controller, enclosure, slot, server
minio_system_drive_smart_megaraid_pd_other_errorsMegaRAID physical drive other error count

Type: gauge
controller, enclosure, slot, server
minio_system_drive_smart_megaraid_pd_predictive_failuresMegaRAID physical drive predictive failure count

Type: gauge
controller, enclosure, slot, server

System Memory

Path: /system/memory

Metrics about system memory usage.

NameDescriptionLabels
minio_system_memory_totalTotal physical RAM installed on the server node in bytes

Type: gauge
server
minio_system_memory_usedAmount of physical RAM currently in use by the system in bytes

Type: gauge
server
minio_system_memory_freeAmount of physical RAM not currently in use and immediately available in bytes

Type: gauge
server
minio_system_memory_availableEstimated amount of physical RAM available for starting new applications without swapping in bytes

Type: gauge
server
minio_system_memory_buffersAmount of physical RAM used by kernel buffers in bytes

Type: gauge
server
minio_system_memory_cacheAmount of physical RAM used for file system cache and page cache in bytes

Type: gauge
server
minio_system_memory_sharedAmount of physical RAM used by shared memory segments in bytes

Type: gauge
server
minio_system_memory_used_percPercentage of total physical RAM currently in use by the system

Type: gauge
server
minio_system_memory_available_avgAverage estimated amount of physical RAM available for starting new applications without swapping in bytes

Type: gauge
server
minio_system_memory_available_maxMaximum estimated amount of physical RAM available for starting new applications without swapping in bytes

Type: gauge
server
minio_system_memory_buffers_avgAverage amount of physical RAM used by kernel buffers in bytes

Type: gauge
server
minio_system_memory_buffers_maxMaximum amount of physical RAM used by kernel buffers in bytes

Type: gauge
server
minio_system_memory_cache_avgAverage amount of physical RAM used for file system cache and page cache in bytes

Type: gauge
server
minio_system_memory_cache_maxMaximum amount of physical RAM used for file system cache and page cache in bytes

Type: gauge
server
minio_system_memory_free_avgAverage amount of physical RAM not currently in use and immediately available in bytes

Type: gauge
server
minio_system_memory_free_maxMaximum amount of physical RAM not currently in use and immediately available in bytes

Type: gauge
server
minio_system_memory_shared_avgAverage amount of physical RAM used by shared memory segments in bytes

Type: gauge
server
minio_system_memory_shared_maxMaximum amount of physical RAM used by shared memory segments in bytes

Type: gauge
server
minio_system_memory_total_avgAverage total physical RAM installed on the server node in bytes

Type: gauge
server
minio_system_memory_total_maxMaximum total physical RAM installed on the server node in bytes

Type: gauge
server
minio_system_memory_used_avgAverage amount of physical RAM currently in use by the system in bytes

Type: gauge
server
minio_system_memory_used_maxMaximum amount of physical RAM currently in use by the system in bytes

Type: gauge
server
minio_system_memory_used_perc_avgAverage percentage of total physical RAM currently in use by the system

Type: gauge
server
minio_system_memory_used_perc_maxMaximum percentage of total physical RAM currently in use by the system

Type: gauge
server

System Network Certificate

Path: /system/network/certificate

Metrics about TLS certificates.

NameDescriptionLabels
minio_system_network_certificate_expires_inNumber of seconds until the certificate expires

Type: gauge
issuer, subject, server

System Network Interface

Path: /system/network/interface

Metrics about network interfaces.

NameDescriptionLabels
minio_system_network_interface_if_rx_bytesBytes received on the interface in 60s

Type: gauge
interface, server
minio_system_network_interface_if_rx_bytes_avgBytes received on the interface in 60s (avg) since uptime

Type: gauge
interface, server
minio_system_network_interface_if_rx_bytes_maxBytes received on the interface in 60s (max) since uptime

Type: gauge
interface, server
minio_system_network_interface_if_rx_errorsReceive errors in 60s

Type: gauge
interface, server
minio_system_network_interface_if_rx_errors_avgReceive errors in 60s (avg)

Type: gauge
interface, server
minio_system_network_interface_if_rx_errors_maxReceive errors in 60s (max)

Type: gauge
interface, server
minio_system_network_interface_if_tx_bytesBytes transmitted in 60s

Type: gauge
interface, server
minio_system_network_interface_if_tx_bytes_avgBytes transmitted in 60s (avg)

Type: gauge
interface, server
minio_system_network_interface_if_tx_bytes_maxBytes transmitted in 60s (max)

Type: gauge
interface, server
minio_system_network_interface_if_tx_errorsTransmit errors in 60s

Type: gauge
interface, server
minio_system_network_interface_if_tx_errors_avgTransmit errors in 60s (avg)

Type: gauge
interface, server
minio_system_network_interface_if_tx_errors_maxTransmit errors in 60s (max)

Type: gauge
interface, server

System Network Internode

Path: /system/network/internode

Metrics about internode network communication.

NameDescriptionLabels
minio_system_network_internode_errors_totalTotal number of failed internode calls

Type: counter
server
minio_system_network_internode_dial_errors_totalTotal number of internode TCP dial timeouts and errors

Type: counter
server
minio_system_network_internode_dial_avg_time_nanosAverage dial time of internode TCP calls in nanoseconds

Type: gauge
server
minio_system_network_internode_sent_bytes_totalTotal number of bytes sent to other peer nodes

Type: counter
server
minio_system_network_internode_recv_bytes_totalTotal number of bytes received from other peer nodes

Type: counter
server
minio_system_network_internode_rtt_msLast RTT in milliseconds to peer node

Type: gauge
peer, server
minio_system_network_internode_reconnects_totalTotal number of reconnects to peer node

Type: counter
peer, server
minio_system_network_internode_out_queue_lengthOutgoing message queue length for peer connection

Type: gauge
peer, server
minio_system_network_internode_peers_connectedNumber of peer nodes this server is connected to

Type: gauge
server

System Network Internode RDMA

Path: /system/network/internode/rdma

Metrics about internode RDMA network communication.

NameDescriptionLabels
minio_system_network_internode_rdma_write_bytes_totalTotal bytes written via inter-node RDMA

Type: counter
server
minio_system_network_internode_rdma_read_bytes_totalTotal bytes read via inter-node RDMA

Type: counter
server
minio_system_network_internode_rdma_write_ops_totalTotal inter-node RDMA write operations

Type: counter
server
minio_system_network_internode_rdma_read_ops_totalTotal inter-node RDMA read operations

Type: counter
server
minio_system_network_internode_rdma_errors_totalTotal inter-node RDMA errors by category

Type: counter
category, server
minio_system_network_internode_rdma_pool_fallbacks_totalTotal inter-node PUTs that fell back to TCP because the RDMA receive-buffer pool was busy (graceful backpressure, not an error)

Type: counter
server
minio_system_network_internode_rdma_nic_writes_throttled_totalInter-node RDMA WRITEs throttled by the per-peer congestion window, per local NIC

Type: counter
nic, server
minio_system_network_internode_rdma_nic_credit_waits_totalInter-node RDMA sends that blocked waiting on receiver credits, per local NIC

Type: counter
nic, server
minio_system_network_internode_rdma_nic_mr_register_fallback_totalInter-node RDMA per-op memory-region registration fallbacks (unregistered buffers), per local NIC

Type: counter
nic, server
minio_system_network_internode_rdma_nic_grant_send_timeouts_totalInter-node RDMA credit-grant sends that timed out, per local NIC

Type: counter
nic, server
minio_system_network_internode_rdma_nic_recv_cq_errors_totalInter-node RDMA receive completion-queue errors, per local NIC

Type: counter
nic, server
minio_system_network_internode_rdma_nic_inflight_writesInter-node RDMA WRITE_WITH_IMM operations currently in flight, per local NIC

Type: gauge
nic, server

System Process

Path: /system/process

Metrics about the MinIO server process.

NameDescriptionLabels
minio_system_process_cpu_total_secondsTotal user and system CPU time spent in seconds

Type: counter
server
minio_system_process_go_routine_totalTotal number of go routines running

Type: gauge
server
minio_system_process_io_rchar_bytesTotal bytes read by the process from the underlying storage system including cache, /proc/[pid]/io field rchar

Type: counter
server
minio_system_process_io_read_bytesTotal bytes read by the process from the underlying storage system, /proc/[pid]/io field read_bytes

Type: counter
server
minio_system_process_io_wchar_bytesTotal bytes written by the process to the underlying storage system including page cache, /proc/[pid]/io field wchar

Type: counter
server
minio_system_process_io_write_bytesTotal bytes written by the process to the underlying storage system, /proc/[pid]/io field write_bytes

Type: counter
server
minio_system_process_start_time_secondsStart time for MinIO process in seconds since Unix epoch

Type: gauge
server
minio_system_process_uptime_secondsUptime for MinIO process in seconds

Type: gauge
server
minio_system_process_file_descriptor_limit_totalLimit on total number of open file descriptors for the MinIO Server process

Type: gauge
server
minio_system_process_file_descriptor_open_totalTotal number of open file descriptors by the MinIO Server process

Type: gauge
server
minio_system_process_syscall_read_totalTotal read SysCalls to the kernel. /proc/[pid]/io field syscr

Type: counter
server
minio_system_process_syscall_write_totalTotal write SysCalls to the kernel. /proc/[pid]/io field syscw

Type: counter
server
minio_system_process_resident_memory_bytesResident memory size in bytes

Type: gauge
server
minio_system_process_virtual_memory_bytesVirtual memory size in bytes

Type: gauge
server
minio_system_process_virtual_memory_max_bytesMaximum virtual memory size in bytes

Type: gauge
server
minio_system_process_threads_totalTotal number of OS threads

Type: gauge
server
minio_system_process_threads_maxMaximum number of OS threads allowed

Type: gauge
server
minio_system_process_thread_pressureThread pressure level (0=normal, 1=warning, 2=critical)

Type: gauge
server

Heal

PathDescription
/healMetrics about healing operations.

Heal

Path: /heal

Metrics about healing operations.

NameDescriptionLabels
minio_heal_objects_totalObjects scanned in current self healing run

Type: counter
type, server
minio_heal_objects_heal_totalObjects healed in current self healing run

Type: counter
type, server
minio_heal_objects_errors_totalObjects for which healing failed in current self healing run

Type: counter
type, server
minio_heal_objects_lock_errors_totalObjects with locking conflict/timeout errors since server uptime

Type: counter
server
minio_heal_time_last_activity_secondsTime elapsed in seconds since last self healing activity

Type: gauge
server
minio_heal_dangling_objects_totalTotal dangling objects detected, by action taken

Type: counter
action, server
minio_heal_dangling_bytes_totalTotal bytes of dangling objects detected, by action taken

Type: counter
action, server
minio_heal_quarantine_drive_purged_totalTotal quarantined entries purged after expiry, node-level total across all drives

Type: counter
server
minio_heal_quarantine_drive_purged_bytes_totalTotal bytes purged from quarantine after expiry, node-level total across all drives

Type: counter
server

KMS

PathDescription
/kmsMetrics about Key Management Service operations.

KMS

Path: /kms

Metrics about Key Management Service operations.

NameDescriptionLabels
minio_kms_request_succeededTotal number of successful KMS requests

Type: counter
server
minio_kms_request_failed_internalTotal number of KMS requests that failed due to some internal failure (HTTP 5xx status code)

Type: counter
server
minio_kms_request_failed_errorTotal number of KMS requests that failed due to some error (HTTP 4xx status code)

Type: counter
server
minio_kms_onlineStatus of KMS cluster reachability (1=online, 0=offline). Tracks aggregate cluster state since KMS/KES SDKs use round-robin but don’t expose which endpoint serves each successful request

Type: gauge
server
minio_kms_online_secondsDuration in seconds that MinIO has maintained successful connectivity with the KMS cluster. Aggregate metric since SDKs don’t expose per-endpoint request routing

Type: gauge
server
minio_kms_request_duration_seconds_distributionHistogram distribution of KMS request durations (aggregate across KMS/KES cluster). SDKs use round-robin but don’t expose which endpoint served each request. Use with Prometheus histogram_quantile() for percentiles

Type: histogram
le, server

Lambda

PathDescription
/lambdaMetrics about Lambda webhook targets.

Lambda

Path: /lambda

Metrics about Lambda webhook targets.

NameDescriptionLabels
minio_lambda_active_requestsNumber of in progress lambda requests

Type: gauge
target_id, server
minio_lambda_total_requestsTotal number of lambda requests sent since start

Type: counter
target_id, server
minio_lambda_failed_requestsTotal number of lambda requests that failed to send since start

Type: counter
target_id, server

Locks

PathDescription
/locksMetrics about distributed locks.

Locks

Path: /locks

Metrics about distributed locks.

NameDescriptionLabels
minio_locks_totalNumber of current locks on this peer

Type: gauge
server
minio_locks_droppedNumber of dropped calls of any lock APIs

Type: gauge
server
minio_locks_timeoutNumber of timed out calls of any lock APIs

Type: gauge
server
minio_locks_expiredNumber of expired locks on this peer

Type: gauge
server
minio_locks_dist_max_latencyMaximum recorded time of the execution of network lock APIs in nanoseconds, during the last minute

Type: gauge
server
minio_locks_dist_avg_latencyHighest per-location average time of network lock API execution in nanoseconds, during the last minute

Type: gauge
server
minio_locks_local_max_latencyMaximum recorded time of the execution of local lock APIs in nanoseconds, during the last minute

Type: gauge
server
minio_locks_local_avg_latencyHighest per-location average time of local lock API execution in nanoseconds, during the last minute

Type: gauge
server

Software

PathDescription
/softwareMetrics about MinIO software version.

Software

Path: /software

Metrics about MinIO software version.

NameDescriptionLabels
minio_software_version_infoMinIO Release tag for the server

Type: gauge
version, server
minio_software_commit_infoGit commit hash for the MinIO release

Type: gauge
commit, server

Stdout

PathDescription
/stdoutMetrics about stdout logging.

Stdout

Path: /stdout

Metrics about stdout logging.

NameDescriptionLabels
minio_stdout_failed_messagesTotal number of logs that failed to send since start

Type: counter
target_id, server
minio_stdout_target_queue_lengthNumber of unsent logs in queue for the specific target

Type: gauge
target_id, server
minio_stdout_total_messagesTotal number of logs sent since start

Type: counter
target_id, server
minio_stdout_global_queue_sizeTotal number of logs in queue for all targets

Type: counter
target_id, server
minio_stdout_total_targetsTotal number of system endpoint targets

Type: counter
target_id, server

Tier

PathDescription
/tierMetrics about remote tier storage.

Tier

Path: /tier

Metrics about remote tier storage.

NameDescriptionLabels
minio_tier_ttlb_seconds_distributionDistribution of time to last byte for tiering requests

Type: histogram
tier, le, server
minio_tier_requests_successNumber of requests to download object from warm tier that were successful

Type: counter
tier, server
minio_tier_requests_failureNumber of requests to download object from warm tier that were failure

Type: counter
tier, server

Delta Sharing

PathDescription
/delta-sharingMetrics for Delta Sharing API operations.

Delta Sharing

Path: /delta-sharing

Metrics for Delta Sharing API operations.

NameDescriptionLabels
minio_delta_sharing_inflight_totalCurrent number of Delta Sharing API requests actively being processed

Type: gauge
name, type, server
minio_delta_sharing_totalTotal number of Delta Sharing API requests processed since server start

Type: counter
name, type, server
minio_delta_sharing_errors_totalTotal number of Delta Sharing API requests that resulted in errors

Type: counter
name, type, server
minio_delta_sharing_4xx_errors_totalTotal number of Delta Sharing API requests that resulted in 4xx client errors

Type: counter
name, type, server
minio_delta_sharing_5xx_errors_totalTotal number of Delta Sharing API requests that resulted in 5xx server errors

Type: counter
name, type, server
minio_delta_sharing_canceled_totalTotal number of Delta Sharing API requests canceled by client

Type: counter
name, type, server
minio_delta_sharing_auth_success_totalTotal successful Delta Sharing authentications

Type: counter
server
minio_delta_sharing_auth_failures_totalTotal failed Delta Sharing authentications

Type: counter
server
minio_delta_sharing_oauth_tokens_issued_totalTotal OAuth tokens issued for Delta Sharing

Type: counter
server
minio_delta_sharing_cache_hits_totalTotal Delta Sharing cache hits

Type: counter
cache_type, server
minio_delta_sharing_cache_misses_totalTotal Delta Sharing cache misses

Type: counter
cache_type, server
minio_delta_sharing_cache_sizeCurrent size of Delta Sharing cache

Type: gauge
cache_type, server
minio_delta_sharing_rate_limited_totalTotal number of rate limited Delta Sharing requests

Type: counter
server
minio_delta_sharing_requests_ttfb_seconds_distributionHistogram distribution of time to first byte (TTFB) in seconds for Delta Sharing API requests

Type: counter
api, le, server

Tables

PathDescription
/tablesMetrics for Tables (Apache Iceberg REST Catalog) operations.

Tables

Path: /tables

Metrics for Tables (Apache Iceberg REST Catalog) operations.

NameDescriptionLabels
minio_tables_warehouses_totalCurrent number of warehouses

Type: gauge
server
minio_tables_namespaces_totalCurrent number of namespaces across all warehouses

Type: gauge
server
minio_tables_tables_totalCurrent number of tables across all warehouses

Type: gauge
server
minio_tables_views_totalCurrent number of views across all warehouses

Type: gauge
server
minio_tables_staged_tables_totalCurrent number of staged tables

Type: gauge
server
minio_tables_transactions_active_currentCurrently total active transactions (pending)

Type: gauge
server
minio_tables_recovery_zombie_detected_totalTotal zombie transactions detected

Type: counter
server
minio_tables_recovery_operations_totalTotal recovery operations performed

Type: counter
server
minio_tables_recovery_rollback_totalTotal transaction rollbacks

Type: counter
type, server
minio_tables_vended_credentials_totalTotal short-lived storage credentials vended for table access, counted per result

Type: counter
result, server
minio_tables_inflight_totalCurrent number of Tables API requests actively being processed

Type: gauge
name, type, server
minio_tables_totalTotal number of Tables API requests processed since server start

Type: counter
name, type, server
minio_tables_5xx_errors_totalTotal number of Tables API requests that resulted in 5xx server errors

Type: counter
name, type, server
minio_tables_canceled_totalTotal number of Tables API requests canceled by client

Type: counter
name, type, server
minio_tables_requests_ttfb_seconds_distributionHistogram distribution of time to first byte (TTFB) in seconds for Tables API requests

Type: counter
api, le, server
minio_tables_maintenance_cycle_totalTotal number of completed maintenance cycles

Type: counter
type, server
minio_tables_maintenance_runningWhether a maintenance cycle is currently running (0 or 1)

Type: gauge
type, server
minio_tables_maintenance_last_cycle_duration_secondsDuration of the last completed maintenance cycle in seconds

Type: gauge
type, server
minio_tables_maintenance_last_run_timestampUnix timestamp of the last completed maintenance cycle

Type: gauge
type, server
minio_tables_maintenance_tables_processed_totalTotal tables successfully processed by maintenance

Type: counter
type, server
minio_tables_maintenance_errors_totalTotal maintenance errors after exhausting retries

Type: counter
type, server
minio_tables_maintenance_retries_totalTotal retry attempts during maintenance

Type: counter
type, server
minio_tables_maintenance_configs_enabled_totalNumber of maintenance configs with status enabled

Type: gauge
type, server
minio_tables_maintenance_snapshots_expired_totalTotal snapshots expired by snapshot expiration maintenance

Type: counter
server
minio_tables_maintenance_orphan_files_marked_totalTotal orphan files marked for deletion by unreferenced file removal maintenance

Type: counter
server
minio_tables_maintenance_configs_totalTotal number of registered maintenance configs

Type: gauge
server
minio_tables_catalog_scanner_cycle_totalTotal number of completed catalog scanner cycles (leader only)

Type: counter
server
minio_tables_catalog_scanner_runningWhether a catalog scanner cycle is currently running (0 or 1, leader only)

Type: gauge
server
minio_tables_catalog_scanner_last_cycle_duration_secondsDuration of the last completed catalog scanner cycle in seconds (leader only)

Type: gauge
server
minio_tables_catalog_scanner_last_run_timestampUnix timestamp of the last completed catalog scanner cycle (leader only)

Type: gauge
server
minio_tables_catalog_scanner_cycle_errors_totalTotal number of catalog scanner cycles that failed with a non-cancellation error (leader only)

Type: counter
server
minio_tables_catalog_scanner_actions_totalTotal catalog mutations applied by the scanner, by action (leader only)

Type: counter
action, server
minio_tables_catalog_scanner_warehouses_last_cycleNumber of warehouse buckets scanned in the last catalog scanner cycle (leader only)

Type: gauge
server
minio_tables_compaction_tables_skipped_totalTotal tables skipped during compaction

Type: counter
server
minio_tables_compaction_files_rewritten_totalTotal data files rewritten by compaction

Type: counter
server
minio_tables_compaction_files_added_totalTotal data files created by compaction

Type: counter
server
minio_tables_compaction_redistribute_groups_totalTotal compaction groups redistributed to a surviving peer after a peer’s stream failed

Type: counter
server
minio_tables_compaction_format_unsupported_groups_totalTotal compaction groups skipped because the data file format is not supported by iceberg-go’s reader (ORC, Avro)

Type: counter
server
minio_tables_compaction_peer_rpcs_totalTotal distributed-compaction RPCs this node handled as a peer, counted per node

Type: counter
server

On this page