文档基于2025-10-10日社区最终版构建     
切换到英文版    进入演示系统    进入交流社区

MinIO Documentation

mc admin prometheus metrics

描述

Themc admin prometheus metrics该命令打印集群的 Prometheus 指标。

输出包含关于每个指标的附加信息,例如其值是否为counter or gauge.

有关使用 MinIO 与 Prometheus 的更完整文档,请参阅如何使用 Prometheus 监控 MinIO 服务器

Starting with MinIO ServerRELEASE.2024-07-15T19-02-30Z和 MinIO ClientRELEASE.2024-07-11T18-01-28Z, metrics version 3 (v3)提供额外的端点和指标。 要打印v3指标,请使用--api_version v3选项。

MinIO 建议新部署使用版本 3 (v3)现有部署可以继续使用metrics version 2

使用mc admin仅限 MinIO 部署

MinIO 不支持使用mc admin与其他 S3兼容服务的命令,无论它们声称与MinIO部署的兼容性如何。

以下命令从部署中打印集群指标别名 myminio:

mc admin prometheus metrics myminio cluster

该命令具有以下语法:

mc [GLOBALFLAGS] admin prometheus metrics  \
                                  ALIAS                                           \
                                  [TYPE]                                          \
                                  [--api_version v3]                              \
                                  [--bucket <bucket name>]
  • Brackets[]表示可选参数。

  • 共享同一行的参数是相互依赖的。

  • 使用竖线分隔的参数|操作符是互斥的。

将示例复制到文本编辑器中,根据需要修改,然后在终端/Shell中运行命令。

参数

ALIAS
必需

Thealias已配置的 MinIO 部署的指标输出命令。

--api-version
可选

打印版本 3 (v3)metrics, 包括一个--api-version v3parameter.v3是唯一接受的值。

省略--api-version打印version 2 (v2)指标。

--bucket
可选

需要--api-version对于返回存储桶级别指标的 v3 指标类型,请指定存储桶名称。

--bucket适用于以下 v3 指标类型:

  • api

  • replication

以下示例打印存储桶的 API 指标mybucket:

mc admin prometheus metrics ALIAS api --bucket mybucket --api-version v3
TYPE
可选

要打印的指标类型。

指标版本3的有效值为:

  • api

  • audit

  • cluster

  • debug

  • ilm

  • logger

  • notification

  • replication

  • scanner

  • system

如果未指定,v3命令返回所有指标。

指标版本 2 的有效值为:

  • bucket

  • cluster

  • node

  • resource

如果未指定,v2命令返回集群指标。 集群指标包括某些节点指标的汇总数据。

全局标志

此命令支持任何全局标志.

示例