可观测性与稳定性 / 系统课时
range 怎样查询时间和耗时
range 怎样查询时间和耗时
排查日志时经常需要同时限定“发生在某个时间窗口”“耗时超过阈值”“状态码落在某一段”。range 查询正是为日期和数值区间准备的,可以把时间、响应时间和状态码限制组合成可重复、边界清晰的筛选条件。
学习目标
- 掌握
gt、gte、lt、lte四种范围边界 - 能同时按时间、耗时和状态码筛选日志
- 能用半开时间区间避免相邻窗口重复统计边界记录
范围查询先把边界写清楚
range 针对一个字段定义上下界:gt 表示大于,gte 表示大于等于,lt 表示小于,lte 表示小于等于。它既可用于数值字段,也可用于日期字段;日期字段还支持日期数学表达式。([Elastic][3])
日志查询里最常见的是把多个范围放进 bool.filter。范围条件通常用于“是否满足过滤条件”,并不需要贡献相关性评分,因此放在 filter 语境更符合排障检索的意图。
同时筛时间、慢请求和错误状态码
下面创建四条演示日志,然后筛选 2026-09-17 02:00:00Z 至 03:00:00Z 之间、耗时至少 1000 ms、状态码为 5xx 的请求。时间采用 gte + lt 的半开区间 [02:00, 03:00)。
curl -s -X DELETE "http://localhost:9200/logs-range-demo" >/dev/null || true
curl -s -X PUT "http://localhost:9200/logs-range-demo" -H "Content-Type: application/json" -d '{"mappings":{"properties":{"@timestamp":{"type":"date"},"latency_ms":{"type":"long"},"status_code":{"type":"integer"},"path":{"type":"keyword"}}}}' >/dev/null
curl -s -X POST "http://localhost:9200/logs-range-demo/_bulk?refresh=wait_for" -H "Content-Type: application/x-ndjson" --data-binary @- >/dev/null <<'NDJSON'
{"index":{}}
{"@timestamp":"2026-09-17T02:00:00Z","latency_ms":120,"status_code":200,"path":"/pay"}
{"index":{}}
{"@timestamp":"2026-09-17T02:15:00Z","latency_ms":950,"status_code":504,"path":"/pay"}
{"index":{}}
{"@timestamp":"2026-09-17T02:20:00Z","latency_ms":1600,"status_code":500,"path":"/pay"}
{"index":{}}
{"@timestamp":"2026-09-17T03:05:00Z","latency_ms":1300,"status_code":500,"path":"/pay"}
NDJSON
curl -s -X GET "http://localhost:9200/logs-range-demo/_search?filter_path=hits.total,hits.hits._source" -H "Content-Type: application/json" -d '{"query":{"bool":{"filter":[{"range":{"@timestamp":{"gte":"2026-09-17T02:00:00Z","lt":"2026-09-17T03:00:00Z"}}},{"range":{"latency_ms":{"gte":1000}}},{"range":{"status_code":{"gte":500,"lt":600}}}]}}}'预期输出
{"hits":{"total":{"value":1,"relation":"eq"},"hits":[{"_source":{"@timestamp":"2026-09-17T02:20:00Z","latency_ms":1600,"status_code":500,"path":"/pay"}}]}}第二条日志虽然是 504,但耗时只有 950 ms;第四条虽然满足慢请求和 5xx,却已经超出时间窗口,因此最终只返回第三条。
时间窗口为什么常用 gte 加 lt
如果按小时连续查询,第一段使用 02:00 <= t < 03:00,下一段使用 03:00 <= t < 04:00,恰好位于 03:00:00 的日志只会属于后一段。若两边都使用 lte,相邻窗口更容易把边界记录重复纳入。
对日期字段还可以使用 now-15m、now/d 之类的日期数学。需要注意,time_zone 可以影响日期值和日期数学取整的解释,但不会改变 now 本身代表的 UTC 当前时刻。([Elastic][3])
状态码是否一定要用 range
查“所有 5xx”时,500 <= status_code < 600 很自然;如果只查固定的 500,精确条件通常表达得更直接。类似地,latency_ms >= 1000 是典型范围查询,而 trace.id、request.method 这类离散值不应为了统一写法硬套 range。
实践时先确认字段映射:时间应是 date,耗时和状态码应是数值类型。边界一旦明确,range 就能把“什么时候发生、到底多慢、错误落在哪个区间”稳定地组合进同一个日志查询。