Prometheus 报 "Context Deadline Exceeded" 错误怎么办？
Prometheus 报 Context Deadline Exceeded 表示操作超过截止时间，需先区分抓取、查询或客户端请求。本文列出四大成因（查询过重、服务高负载、网络问题、资源不足）与对应解法：优化查询、调大 query.timeout、扩容与引入 Thanos 等长期方案。
"Context Deadline Exceeded" 表示某项操作超过了上下文截止时间——可能来自抓取、查询或客户端请求，需要先看报错位置。按下面的清单逐项排查即可定位。
常见成因
- 查询本身太重：大范围时间聚合、未过滤的高基数指标、多层嵌套子查询，执行时间超过超时阈值；
- Prometheus 高负载：写入速率高、并发查询多，CPU/内存被打满；
- 网络问题：Grafana 等查询端与 Prometheus 之间连通性差；
- 资源不足：CPU/内存配额太小，GC 频繁。
解决办法
优化查询：缩小时间范围、先过滤再聚合、避免无必要地扩大匹配序列范围；.* 本身不一定是瓶颈、用录制规则（recording rule）把重查询预计算成新指标。
调大超时：启动参数调整（当前查询默认 2 分钟，抓取超时则由 scrape_timeout 控制）：
prometheus --config.file=prometheus.yml --query.timeout=3m
修改已有服务的启动参数后需重启该实例，不要另起第二个进程争用数据目录；先保留原有其他参数。注意 Grafana 侧也有自己的超时设置（数据源的 Timeout 与 Query timeout），两端要一起调。
加资源或扩容：垂直加 CPU/内存；确认容量瓶颈后可评估 Thanos、Cortex、Mimir 这类方案；拆分查询与存储并不能自动解决低效查询或客户端超时。
常见问题（FAQ）
Q：只是偶尔报一次需要处理吗？ 偶发一般是瞬时高负载，观察即可；频繁出现就要按上文排查。
Q：grafana 面板超时但 Prometheus 后台查很快？ 多半是 Grafana 数据源超时设置太短，或面板一次查询的序列过多，减少面板上的查询数量试试。
