← ClaudeAtlas

promqllisted

PromQL query writing: selectors, operators, vector matching, functions, aggregations, histograms, subqueries, recording rules, alerting rules, and query optimization. Invoke whenever task involves any interaction with PromQL — writing, debugging, optimizing, reviewing, or explaining Prometheus queries for dashboards, alerts, recording rules, or ad-hoc exploration.
xobotyi/cc-foundry · ★ 23 · AI & Automation · score 81
Install: claude install-skill xobotyi/cc-foundry
# PromQL PromQL is a nested functional language for selecting and aggregating Prometheus time series. Every query is an expression tree: selectors at the leaves, functions and operators at the nodes, a single root value (scalar, instant vector, range vector, or string) at the top. Type discipline makes queries correct; cardinality awareness makes them fast. Authoritative reference for **writing PromQL queries** — dashboards, alerts, recording rules, exploration. The companion `backend/prometheus` skill covers **instrumentation** (metric types, naming, labels, exporters). When both apply, use `backend/prometheus` for emitting metrics and this skill for querying them. ## References - **Selectors and data types** — [`${CLAUDE_SKILL_DIR}/references/selectors-and-types.md`] Expression types, instant and range vector selectors, label matchers (`=`, `!=`, `=~`, `!~`), time durations, offset and `@` modifiers, staleness, instant vs range queries, string and float literals - **Operators** — [`${CLAUDE_SKILL_DIR}/references/operators.md`] Arithmetic, comparison, logical/set, vector matching (`on`, `ignoring`, `group_left`, `group_right`), aggregation operators, `by`/`without`, fill modifiers, operator precedence - **Functions** — [`${CLAUDE_SKILL_DIR}/references/functions.md`] Full function catalog: counter family, gauge functions, classic and native histograms, `*_over_time`, existence checks, label manipulation, math, time, type conversion, sorting, trigonometric - **