Title here
Summary here
响应头
X-Cache
指示响应的返回方式。
| 值 | 描述 |
|---|---|
HIT | 从缓存返回（新鲜） |
MISS | 从源站获取并已缓存 |
STALE | 从缓存返回（过期，在 stale-while-revalidate 或 stale-if-error 窗口内） |
BYPASS | 绕过缓存（no-store、no-cache、路由禁用缓存，或 SSE 请求） |
REVALIDATED | 向源站的条件请求返回 304，从缓存返回并更新新鲜度 |
curl -sI http://localhost:8080/get | grep x-cache
# X-Cache: HITAge
缓存对象的年龄（秒），计算自原始响应的 Date 头加上在
上游转发代理中花费的时间。每次缓存命中时更新。
curl -sI http://localhost:8080/get | grep age
# Age: 42X-Cache-Source
指示由哪个存储层返回了响应。
| 值 | 描述 |
|---|---|
hot | 从 RAM 热层（L0）返回 |
warm | 从 mmap 温层（L1）返回 |
peer | 通过 peer fetch 从集群节点返回 |
origin | 从上游源站获取 —— 自 v0.5.28 起也包括所有 BYPASS 路径（流式源站获取、SSE、upstream-in-process 回退） |
| (空) | 非由存储层返回：bouine 自行合成的响应（only-if-cached 504、卸载 503、无 upstream 的 502）。自 v0.5.28 起，Prometheus source 标签将其呈现为 bouine 而非空字符串。 |
上游错误状态码（自 v0.5.29 起）
对 upstream pool 的 fetch 超时 —— 拨号超时、响应头超时或路由的
cache.fetch_timeout 截止时间 —— 以 504 Gateway Timeout
（RFC 9110 §15.6.5）返回客户端，响应体为 “upstream timeout”，并携带
常规的 X-Cache / X-Cache-Source 归因。其他所有上游失败（拒绝、
重置、DNS）仍返回 502 Bad Gateway。超时分类与
bouine_origin_connection_errors_total 的 reason 标签使用同一字符串，
因此线上状态码与指标一致。only-if-cached 504 与卸载 503 不受影响。
X-Bouine-Route
匹配请求的路由标签。用于仪表板的逐路由归因与访问日志。它不再是
Prometheus 标签：自 v0.5.8 起，数据面 RED 指标改为按 upstream_pool
（由配置限定的小集合）归因，而非路由名；参见
监控。
X-Bouine-Pool
所服务路由的 upstream pool。由路由器以进程本地值的形式设置，被
指标中间件用作 upstream_pool Prometheus 标签；入站头形式原样
转发。无 pool 的路由（静态、catch-all）上报为 _default。