mc admin prometheus generate

Generates a metrics scraping configuration file for use with Prometheus.

Syntax

Example

The following command generates a v3 Prometheus scraping configuration file for the deployment at alias myaistor:

mc admin prometheus generate myaistor --api-version v3

The following command generates a v2 Prometheus scraping configuration file for the deployment at alias myaistor:

mc admin prometheus generate myaistor

Syntax

The command has the following syntax:

mc [GLOBALFLAGS] admin prometheus generate                  \
                                  ALIAS                     \
                                  [TYPE]                    \
                                  [--api_version v3]        \
                                  [--bucket <bucket name>]

Brackets [] indicate optional parameters.
Parameters sharing a line are mutually dependent.
Parameters separated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

Parameters

ALIAS

Required

The alias of a configured AIStor deployment for which the command generates a Prometheus-compatible configuration file.

--api-version

Optional

To generate a scrape configuration for v3 metrics, include an --api-version v3 parameter. v3 is the only accepted value.

Omit --api-version to generate a v2 metrics configuration.

--bucket

Optional

Only valid for v3 metrics.

For v3 metric types that return bucket-level metrics, specify a bucket name. Requires --api-version.

--bucket works for the following v3 metric types:

api
batch
replication

The following example generates a configuration for API metrics from the bucket mybucket:

mc admin prometheus generate ALIAS api --bucket mybucket --api-version v3

TYPE

Optional

The type of metrics to scrape.

Valid values for metrics version 3 are:

api
audit
batch
cluster
debug
ilm
logger
notification
replication
scanner
system

If not specified, a v3 command generates a scrape configuration for all metrics except individual bucket metrics. For v3 bucket metrics, see --bucket.

Valid values for metrics version 2 are:

bucket
cluster
node
resource

If not specified, a v2 command returns cluster metrics. Cluster metrics include selected high level node and bucket replication metrics.

Global Flags

This command supports any of the global flags.

Examples

Generate a default metrics v3 config

Use mc admin prometheus generate --api-version v3 to generate a scrape configuration that collects all v3 metrics for an AIStor deployment:

mc admin prometheus generate ALIAS --api-version v3

Replace ALIAS with the alias of the AIStor deployment.

The output resembles the following:

scrape_configs:
- job_name: aistor-job
  bearer_token: [auth token]
  metrics_path: /minio/metrics/v3
  scheme: http
  static_configs:
  - targets: ['localhost:9000']

Generate a v3 metrics config for another type

To generate a configuration for another metric type, specify the type. The following generates a scrape configuration for v3 cluster metrics:

mc admin prometheus generate ALIAS cluster --api-version v3

Replace ALIAS with the alias of the AIStor deployment.

The output resembles the following:

scrape_configs:
- job_name: aistor-job-cluster
  bearer_token: [auth token]
  metrics_path: /minio/metrics/v3/cluster
  scheme: http
  static_configs:
  - targets: ['localhost:9000']

To generate a configuration for a different metric type, replace cluster with the desired type.

Generate a v3 API, batch, or bucket replication metrics config

The following example generates a scrape configuration for v3 replication metrics of bucket mybucket:

mc admin prometheus generate ALIAS replication --bucket mybucket --api-version v3

Replace ALIAS with the alias of the AIStor deployment.

The output resembles the following:

scrape_configs:
- job_name: aistor-job-replication
  bearer_token: [auth token]
  metrics_path: /minio/metrics/v3/bucket/replication/mybucket
  scheme: https
  static_configs:
  - targets: [`localhost:9000`]

To scrape API or batch metrics for the bucket, replace replication with the desired type.

Generate a v3 config for bucket API metrics

The following example generates a scrape configuration for v3 API metrics for bucket mybucket:

mc admin prometheus generate ALIAS api --bucket mybucket --api-version v3

Replace ALIAS with the alias of the AIStor deployment.

The output resembles the following:

scrape_configs:
- job_name: aistor-job-api
  bearer_token: [auth token]
  metrics_path: /minio/metrics/v3/bucket/api/mybucket
  scheme: https
  static_configs:
  - targets: [`localhost:9000`]

Generate a default metrics v2 config

By default, mc admin prometheus generate generates a scrape configuration for v2 cluster metrics:

mc admin prometheus generate ALIAS

Replace ALIAS with the alias of the AIStor deployment.

The output resembles the following:

scrape_configs:
- job_name: aistor-job
  bearer_token: [auth token]
  metrics_path: /minio/v2/metrics
  scheme: http
  static_configs:
  - targets: ['localhost:9000']

Generate a v2 config for other metric types

To generate a configuration for another metric type, specify the type. The following generates a scrape configuration for v2 bucket metrics:

mc admin prometheus generate ALIAS bucket