khaliq/drl-exporter

镜像概述

drl-exporter是一个用于获取Docker Hub速率限制计数的Prometheus exporter，可作为Prometheus的抓取目标。它通过获取认证令牌，使用HEAD请求查询Docker Hub registry，解析RateLimit-Limit（速率限制总量）、RateLimit-Remaining（剩余速率限制）和RateLimit-Reset（速率限制重置时间）等信息，并将其转换为Gauge指标。支持使用Docker Hub凭证进行认证，未提供凭证时则使用***令牌。

核心功能和特性

• 速率限制监控：获取并解析Docker Hub的速率限制相关指标（RateLimit-Limit、RateLimit-Remaining、RateLimit-Reset）
• Prometheus兼容：以Prometheus Gauge指标格式输出，便于Prometheus抓取和监控
• 认证支持：可使用Docker Hub账户凭证进行认证，也支持访问（使用令牌）
• 轻量高效：通过HEAD请求获取所需信息，资源消耗低

使用场景和适用范围

• Docker Hub使用监控：适用于需要监控Docker Hub速率限制使用情况的环境
• CI/CD流水线：帮助避免因Docker Hub速率限制导致的镜像拉取失败
• 容器化部署环境：监控团队或组织的Docker Hub资源使用情况，提前预警速率限制问题
• Prometheus监控体系：作为Prometheus的抓取目标，整合到现有监控系统中

使用方法和配置说明

项目地址

该项目为开源项目，详细使用说明可参考 https://github.com/m47ik/drl-exporter%E3%80%82

基本部署

Docker Run示例

bash
docker run -d -p 9170:9170 --name drl-exporter docker.xuanyuan.run/m47ik/drl-exporter

配置认证（可选）

如需使用Docker Hub账户认证（获取更高的速率限制），可通过环境变量传入凭证：

bash
docker run -d -p 9170:9170 \
  -e DOCKERHUB_USERNAME=your_username \
  -e DOCKERHUB_PASSWORD=your_password \
  --name drl-exporter docker.xuanyuan.run/m47ik/drl-exporter

指标说明

exporter输出的主要Prometheus指标包括：

• dockerhub_rate_limit_limit：Docker Hub速率限制总量
• dockerhub_rate_limit_remaining：剩余速率限制次数
• dockerhub_rate_limit_reset：速率限制重置时间（Unix时间戳）

Prometheus配置

在Prometheus配置文件中添加如下job以抓取指标：

yaml
scrape_configs:
  - job_name: 'drl-exporter'
    static_configs:
      - targets: ['drl-exporter:9170']  # 替换为exporter实际地址