如何使用Prometheus监控MinIO服务器
Prometheus Prometheus是最初在SoundCloud上构建的云原生监视平台。Prometheus提供了多维数据模型，其中包含通过度量标准名称和键/值对标识的时间序列数据。数据收集通过HTTP / HTTPS上的拉模型进行。通过服务发现或静态配置发现要提取数据的目标。
MinIO默认情况下将Prometheus兼容数据作为授权端点导出/minio/prometheus/metrics。希望监视其MinIO实例的用户可以指向Prometheus配置，以从该终结点抓取数据。
本文档说明了如何设置Prometheus并将其配置为从MinIO服务器抓取数据。
目录
- 先决条件
- 1. 下载Prometheus
- 2. 为Prometheus指标配置身份验证类型
- 3. 配置Prometheus
- 3.1 经过身份验证的Prometheus配置
- 3.2 Public Prometheus配置
- 4.
scrape_configsprometheus.yml中的更新部分 - 5. 启动 Prometheus
- MinIO公开的指标列表
先决条件
要开始使用MinIO，请参阅MinIO快速入门文档。请按照以下步骤开始使用Prometheus进行MinIO监视。
1. 下载 Prometheus
为您的平台下载最新版本的Prometheus，然后解压缩
tar xvfz prometheus-*.tar.gz
cd prometheus-*Prometheus服务器是一个称为prometheus（或prometheus.exe在Microsoft Windows上）的二进制文件。运行二进制和通过--help标志以查看可用选项
./prometheus --help
usage: prometheus [<flags>]
The Prometheus monitoring server
. . .
有关更多详细信息，请参阅Prometheus文档。
2. 为Prometheus指标配置身份验证类型
MinIO支持Prometheus jwt或两种身份验证模式public，默认情况下，MinIO以jwtmode 运行。要允许对prometheus度量标准不进行身份验证就可以进行公共访问，请按如下所示设置环境。
export MINIO_PROMETHEUS_AUTH_TYPE="public"
minio server ~/test3. 配置Prometheus
3.1 经过身份验证的Prometheus配置
如果将MinIO配置为在不进行身份验证的情况下公开指标，则无需使用它mc来生成prometheus配置。您可以跳过进一步阅读并移至3.2部分。
MinIO中的Prometheus端点默认需要身份验证。Prometheus支持使用承载令牌方法对Prometheus抓取请求进行身份验证，并使用mc生成的默认Prometheus配置覆盖默认的Prometheus配置。要为别名生成Prometheus配置，请使用mc，如下所示mc admin prometheus generate <alias>。
该命令将生成scrape_configs prometheus.yml 的部分，如下所示：
scrape_configs:
- job_name: minio-job
bearer_token: <secret>
metrics_path: /minio/prometheus/metrics
scheme: http
static_configs:
- targets: ['localhost:9000']3.2 Public Prometheus配置
如果Prometheus端点身份验证类型设置为public。遵循prometheus的配置足以开始从MinIO抓取指标数据。
scrape_configs:
- job_name: minio-job
metrics_path: /minio/prometheus/metrics
scheme: http
static_configs:
- targets: ['localhost:9000']4. scrape_configs 更新部分prometheus.yml
要授权每个刮取请求，请将生成的scrape_configs部分复制并粘贴到prometheus.yml中，然后重新启动Prometheus服务。
5. 启动 Prometheus
通过运行启动（或）重新启动Prometheus服务
./prometheus --config.file=prometheus.yml这prometheus.yml是配置文件的名称。现在，您可以在Prometheus仪表板中查看MinIO指标。默认情况下，可以从访问Prometheus仪表板http://localhost:9090。
MinIO公开的指标列表
MinIO服务器在/ minio / prometheus / metrics端点上公开以下指标。 所有这些都可以通过Prometheus仪表板进行访问。 演示服务器的https://play.min.io:9000/minio/prometheus/metrics 中提供了暴露指标的完整列表及其定义。
这些是将在之后生效的新指标集RELEASE.2019-10-16*。下面列出了此更新中的一些关键更改。 -指标绑定到各个节点，并且不在群集范围内。集群中的每个节点都将公开自己的指标。 -添加了涵盖s3和节点间流量统计信息的其他指标。 -记录http统计信息和延迟的度量标准被标记为其各自的API（putobject，getobject等）。 -磁盘使用情况指标已分发并标记到相应的磁盘路径。
有关更多详细信息，请检查 Migration guide for the new set of metrics
指标列表及其定义如下。（注意：这里的实例是一个MinIO节点）
注意:
- 这里的实例是一个MinIO节点。
s3 requests排除节点间请求。
标准go运行时指标的前缀
go_流程级别指标以开头
process_prometheus 抓取以开头的指标
promhttp_disk_storage_used: 磁盘使用的磁盘空间。disk_storage_available: 磁盘上剩余的可用磁盘空间。disk_storage_total: 磁盘上的总磁盘空间。minio_disks_offline: 当前MinIO实例中的脱机磁盘总数。minio_disks_total: 当前MinIO实例中的磁盘总数。s3_requests_total: 当前MinIO实例中s3请求的总数。s3_errors_total: 当前MinIO实例中s3请求中的错误总数。s3_requests_current: 当前MinIO实例中活动s3请求的总数。internode_rx_bytes_total: 当前MinIO服务器实例接收到的节点间字节总数。internode_tx_bytes_total: 当前MinIO服务器实例发送到其他节点的字节总数。s3_rx_bytes_total: 当前MinIO服务器实例接收的s3字节总数。s3_tx_bytes_total: 当前MinIO服务器实例发送的s3字节总数。minio_version_info: 具有提交ID的当前MinIO版本。s3_ttfb_seconds: 保存请求的延迟信息的直方图。
除了上述指标外，MinIO还公开了低于模式的指标
缓存特定指标
启用了磁盘缓存的MinIO Gateway实例公开了与缓存相关的指标。
cache_data_served:cache_data_served：从缓存提供的总字节数。cache_hits_total:cache_hits_total：缓存命中总数。cache_misses_total:cache_misses_total：缓存未命中总数。
网关和缓存特定指标
MinIO Gateway实例公开与网关与云后端（S3，Azure和GCS Gateway）的通信相关的指标。
gateway_<gateway_type>_requests:向云后端发出的请求总数。此度量标准具有method标识GET，HEAD，PUT和POST请求的标签。gateway_<gateway_type>_bytes_sent:发送到云后端的总字节数（在PUT和POST请求中）。gateway_<gateway_type>_bytes_received:从云后端接收的字节总数（在GET和HEAD请求中）。
请注意，这目前仅支持Azure，S3和GCS网关
MinIO自愈指标 - self_heal_*
MinIO 仅针对擦除代码部署公开与自我修复相关的指标。这些度量标准在网关或单节点单驱动器部署中不可用。请注意，只有在MinIO服务器上发生相关事件时，才会公开这些指标。
self_heal_time_since_last_activity:自上一次自我修复相关活动以来经过的时间。self_heal_objects_scanned:在当前运行中由自愈线程扫描的对象数。重新开始自我修复运行时，它将重置。这用扫描的对象类型标记。self_heal_objects_healed: 当前运行中通过自愈线程修复的对象数。重新开始自我修复运行时，它将重置。这用扫描的对象类型标记。self_heal_objects_heal_failed:当前运行中自愈失败的对象数。重新开始自我修复运行时，它将重置。这被标记为磁盘状态及其端点。
新指标集的迁移指南
本迁移指南适用于旧版本或之前的任何版本 RELEASE.2019-10-23*
MinIO磁盘级别指标 - disk_*
迁移包括
- `minio_total_disks` to `minio_disks_total`
- `minio_offline_disks` to `minio_disks_offline`MinIO磁盘级别指标 - disk_storage_*
这些指标只有一个标签。
- `disk`: Holds the disk path迁移包括
- `minio_disk_storage_used_bytes` to `disk_storage_used`
- `minio_disk_storage_available_bytes` to `disk_storage_available`
- `minio_disk_storage_total_bytes` to `disk_storage_total`MinIO网络级指标
详细介绍了这些指标，以涵盖s3和节点间网络统计信息。
迁移包括
- `minio_network_sent_bytes_total` to `s3_tx_bytes_total` and `internode_tx_bytes_total`
- `minio_network_received_bytes_total` to `s3_rx_bytes_total` and `internode_rx_bytes_total`添加的一些其他指标是
- `s3_requests_total`
- `s3_errors_total`
- `s3_ttfb_seconds`