注释查询（Prometheus）
注释查询（Prometheus）
# 进程重启事件
changes(process_start_time_seconds{job="node"}[1h]) > 0
# 告警触发时间线
ALERTS{alertstate="firing"}
# 手工注释：Dashboard settings → Annotations → Add annotation把发布窗口标成注释后，故障时间线与变更时间点能对在一起看。
本包目录（282 条）
监控体系与方法40 条Prometheus 与采集64 条
Grafana 与看板53 条
- Query 变量：从指标里展开下拉选项
- Time series 面板：趋势展示主力
- 添加 Prometheus 数据源
- 内置宏：$__interval 与 $__rate_interval
- Grafana 是什么：可视化与看板核心概念
- 用 Docker 运行 Grafana
- 看板 JSON 的结构要点
- 阈值与阈值线：颜色随数值变化
- Explore：临时探索与对比
- grafana.ini 常用配置项
- Stat 面板：关键数字与迷你趋势
- Table 面板：清单与明细
- Transformations：可视化前的数据加工
- Query Inspector：面板排障入口
- 看板性能优化清单
- Loki 数据源接入
- 数据源 provisioning 化
- Gauge 与 Bar gauge：表盘与条形
- 单位与数值格式
- Data links：数据点下钻跳转
- 分享、嵌入与 Kiosk 模式
- 看板 provisioning 与 sidecar 模式
- 用 HTTP API 管理看板
- Heatmap 面板：时延分布热力图
- 图例格式化：让序列名可读
- Field overrides：字段级显示覆盖
- Annotations 注释：把事件画到图上
- Max data points 与步长控制
- Tempo 数据源接入
- Custom / Interval / Constant 变量
- State timeline：状态条带
- Logs 面板：把日志嵌进看板
- Reduce 转换：序列归约成表
- Library panels：可复用面板
- 时间范围与时区设置
- Elasticsearch 数据源接入
- 面板与行重复（Repeat）
- 变量级联：先选上层再展开下层
- Pie chart 面板：占比构成
- Value mappings：数值到文案的映射
- Dashboard links：看板间导航
- 文件夹与权限：按团队授权
- URL 参数：受控打开看板
- Ad hoc filters：看板级标签过滤条
- Text 面板：把说明固化在页面里
- Join by field：横向拼接多查询
- 看板导出图片渲染
- 看板版本历史与回滚
- 服务账号与令牌（自动化凭据）
- Filter data by query：只看指定查询
- 匿名访问：只读展示大屏
- Playlist：看板轮播
- 插件管理与安装
Annotations 注释：把事件画到图上
注释把发布、重启、告警触发画成时间竖线：Prometheus 数据源可用查询自动生成，也可手工标注发布窗口，便于对照“动作与曲线”。
易错点
- changes() 会把采集抖动误算成重启，置信度不足时结合指标交叉验证
- 注释查询同样消耗数据源查询预算，别用大范围扫描换几根竖线
数据来源与参考
- Grafana 官方文档 · Annotations