prom/prometheus-cli

Prometheus CLI Docker镜像

镜像概述

该Docker镜像封装了用于查询Prometheus服务器HTTP API的命令行工具，用户无需本地安装依赖即可通过容器化方式快速使用，实现对Prometheus指标数据的查询、获取与导出。

核心功能和特性

• 多查询类型支持：提供query（即时查询）、query_range（范围查询）、metrics（指标列表获取）三种核心命令
• 输出格式灵活：支持CSV格式输出，并可通过参数自定义CSV分隔符
• 超时控制：允许设置查询Prometheus服务器的超时时间，避免长时间阻塞
• 容器化部署：轻量级镜像设计，支持快速拉取和运行，无本地环境依赖

使用场景和适用范围

• 监控Prometheus服务器自身状态及可用指标
• 查询Prometheus中的实时指标或历史时间段指标数据
• 集成到自动化脚本/CI流程中，定期获取Prometheus数据用于分析或告警
• 在受限环境（如无本地工具安装权限的服务器）中访问Prometheus API

使用方法和配置说明

拉取镜像

通过Docker Hub拉取官方镜像：

bash
docker pull prom/prometheus-cli

基础运行命令格式

bash
docker run --rm -ti prom/prometheus-cli [flags] <command> [arguments]

支持的Flags参数

常用命令示例

1. 获取Prometheus指标列表

bash
docker run --rm -ti prom/prometheus-cli -server="http://prometheus:9090" metrics

2. 执行即时查询

查询表达式为up的当前指标值：

bash
docker run --rm -ti prom/prometheus-cli -server="http://prometheus:9090" query "up"

3. 执行范围查询

查询过去1小时（3600秒）内，每60秒采样一次的http_requests_total指标（结束时间为当前Unix时间戳）：

bash
docker run --rm -ti prom/prometheus-cli -server="http://prometheus:9090" query_range "http_requests_total" $(date +%s) 3600 60

4. 自定义CSV输出格式

使用逗号作为CSV分隔符查询指标：

bash
docker run --rm -ti prom/prometheus-cli -server="http://prometheus:9090" -csvDelimiter="," query "http_requests_total"

使用注意事项

• 确保容器网络可访问-server参数指定的Prometheus服务（需包含正确端口，如默认9090）
• --rm参数可在容器退出后自动清理，避免残留容器占用资源
• -ti参数用于交互式运行，确保命令输出正常显示；非交互式场景可省略