在Linux环境通过PromQL执行Prometheus查询的方法及CLI疑问

一、Linux环境下使用PromQL执行Prometheus查询的可行方案 #

完全可以在Linux环境中通过多种方式执行PromQL查询，以下是两种常用实现方式：

1. 直接调用Prometheus HTTP API（无需额外工具） #

Prometheus内置了HTTP API接口，可通过curl等Linux基础工具直接发起查询请求：

• 瞬时查询（获取某一时刻的指标值）：

  curl -g 'http://<prometheus实例地址>:9090/api/v1/query?query=up'
  

  替换<prometheus实例地址>为你的Prometheus服务IP或域名，up为要执行的PromQL语句。

• 范围查询（获取一段时间内的指标序列）：

  # 动态生成时间戳（查询最近1小时的数据）
  curl -g "http://<prometheus实例地址>:9090/api/v1/query_range?query=up&start=$(date -d '-1 hour' +%s)&end=$(date +%s)&step=60s"
  

  参数说明：start/end为查询时间范围的Unix时间戳，step为采样间隔。

2. 使用第三方CLI工具（如prometheus-cli） #

若需要更友好的交互体验，可安装第三方CLI工具prometheus-cli：

• 安装（依赖Python环境）：

  pip install prometheus-cli
  

• 执行查询：

  prometheus-cli --server http://<prometheus实例地址>:9090 query up
  

二、Prometheus自带的专属工具说明 #

Prometheus官方并未提供独立的查询CLI客户端，但随二进制包分发了promtool工具，它具备PromQL查询测试能力，同时还承担配置/规则校验的功能：

• 测试瞬时PromQL查询：

  promtool query instant http://<prometheus实例地址>:9090 'up'
  

• 测试范围PromQL查询：

  promtool query range http://<prometheus实例地址>:9090 --start=$(date -d '-1 hour' +%s) --end=$(date +%s) --step=60s 'up'
  

• 其他常用功能：
  • 校验Prometheus配置文件：promtool check config prometheus.yml
  • 校验告警规则文件：promtool check rules alert_rules.yml

内容的提问来源于stack exchange，提问作者Charlie