模块资料｜Prometheus、PromQL 与 TSDB
原图深度模块的结构化资料摘录，保留目标、知识、命令线索、风险、排障、练习与验收。它不是一张原子知识卡，也不是可直接执行的操作手册。
所属方向：可观测性。
目标
- 稳定采集指标、控制基数并写出可维护查询。
知识拆解
- pull/service discovery
- metric types
- label model
- WAL/block/compaction
- PromQL vector matching
- recording rules
- federation/remote write
命令 / 配置 / 关键对象
以下是原图中的命令名、缩写或配置对象，并非经校验的完整命令行；其中可能含写操作。执行前必须补齐版本、权限、目标和风险。
- promtool check/test rules
- up/scrape metrics
- rate/increase/histogram_quantile
- topk/sum by
- TSDB status
高频故障与风险
- scrape down
- 高基数/OOM
- remote write backlog
- 慢查询
- histogram 使用错误
排障路径
- target→scrape→ingest→query→rule
- 检查 series churn/cardinality
- 解释 query plan 与时间范围
实战练习
- 实现 RED/USE 看板
- 写并测试 SLO recording/alert rules
验收标准
- 规则有单测
- 基数预算
- 查询在目标时间内完成
对应优秀开源项目
继续拆卡的规则
本页是资料入口。只在形成一个能独立解释、带依据与边界的认识后，提炼为 Concept；故障观察进入 Troubleshooting，满足诊断条件的处置进入 Runbook，真实事件进入 Incident。