首页 / 技能 / PromQL CLI — PromQL 命令行

📦 PromQL CLI — PromQL 命令行

v1.1.2

PromQL 命令行工具。

0· 127·0 当前·0 累计
by @samber·MIT-0
下载技能包
License
MIT-0
最后更新
2026/3/24
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
The skill is internally coherent: it wraps a PromQL CLI, asks only for the expected binaries (promql and jq), and its runtime instructions stay within the stated purpose.
安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

运行时依赖

无特殊依赖

版本

latestv1.1.22026/3/24
● 无害

安装命令

点击复制
官方npx clawhub@latest install promql-cli
🇨🇳 镜像加速npx clawhub@latest install promql-cli --registry https://cn.longxiaskill.com

技能文档

promql-cli (github.com/nalbury/promql-cli) is a Go CLI for querying, analyzing, and visualizing Prometheus metrics, plus PromQL fundamentals.

Reference Files

Read the relevant reference file(s) before executing tasks:

FileWhen to read
references/installation.mdUser needs to install promql-cli or set up configuration (hosts, auth, token, password, multi-host)
references/usage.mdUser wants to discover metrics/exporters/labels, run queries, or choose output formats
references/graphing.mdUser wants to visualize Prometheus data as an ASCII chart in the terminal
references/debugging.mdUser is investigating a performance issue, latency, errors, or saturation
references/promql-reference.mdUser needs help writing PromQL, understanding metric types, functions, or aggregations
For most tasks, read references/usage.md. For PromQL help, read references/promql-reference.md. When debugging, read both references/debugging.md and references/promql-reference.md.

Setup Check

Before running any query, verify that a host is configured:

promql 'up'   # succeeds if host is reachable; fails with connection error if not configured
# or
promql --host xxx 'up'

Recognize these errors as a configuration/auth problem and refer to references/installation.md:

ErrorCause
dial tcp ... connection refusedNo host running at the configured address
dial tcp ... no such hostHostname not resolved — wrong host in config
error querying prometheus: ...401...Bearer token missing or invalid
error querying prometheus: ...403...Token valid but insufficient permissions
please specify an authentication typeAuth flags partially set — use config file instead
If any of these appear, do not create config files on behalf of the user — config files may contain credentials (tokens, passwords) that must never pass through an LLM. Instead, guide the user to set it up themselves:

"Please create ~/.promql-cli.yaml manually with your Prometheus host (and credentials if needed). See references/installation.md for the exact format. Let me know once it's ready."

Only after the user confirms the config is in place should you proceed with queries.

Quick Command Reference

promql 'up'                                          # instant query
promql 'rate(http_requests_total[5m])' --start 1h    # range query (ASCII graph)
promql 'up' --output csv                             # CSV output
promql 'up' --output json                            # JSON output
promql metrics                                       # list all metric names
promql labels                                # list labels for a metric
promql meta                                  # show metric type and help
promql --config ~/.promql-cli-prod.yaml 'up'         # target a specific host

键 Principles

  • 使用 rate() 在...上 counters, never raw values — raw counters 仅 ever increase; absolute 值 meaningless. rate() gives per-第二个 更改 rate, 哪个 什么 您 actually care 关于.
  • 当...时 debugging, isolate single instance — aggregating 穿过 replicas masks per-instance anomalies. single overloaded pod hidden 后面 healthy peers won't show up 在...中 averages.
  • 过滤 early 带有 label matchers 在...中 innermost selector — Prometheus evaluates selectors 之前 functions, 所以 filtering late means scanning 所有 时间 series. Early filters 归约 data scanned 和 查询 latency.
  • 对于 histograms, keep le 在...中 由 clause 之前 histogram_quantile() — 函数 needs 所有 le buckets 到 interpolate percentiles; dropping le early produces NaN 或 wrong results.
  • Prefer --输出 图形 对于 range queries — ASCII sparklines convey trend direction (rising, falling, spiking) 在...中 compact 格式 LLMs 解析 well; raw 时间戳 tables require mental modeling.
  • Store credentials 在...中 ~/.promql-cli.yaml 和 ~/.promql_token, chmod 600 — passing tokens 作为 CLI args exposes them 在...中 shell history 和 process listings.

This skill is not exhaustive. Please refer to the official promql-cli documentation and examples for up-to-date information. Context7 can help as a discoverability platform.

If you encounter a bug or unexpected behavior in promql-cli itself, open an issue at https://github.com/nalbury/promql-cli/issues.

数据来源：ClawHub ↗ · 中文优化：龙虾技能库