可观测性与稳定性 / 系统课时
怎样按时间范围查询日志
怎样按时间范围查询日志
排查故障时,先限定时间范围通常比先输入关键字更重要。时间窗口越准确,需要扫描的日志越少,也越容易把部署、报警和用户报错对应起来。本篇以 Elasticsearch 为例,演示如何用绝对时间和相对时间过滤 @timestamp,并避免常见的边界与时区误差。
学习目标
- 根据故障发生时间构造日志查询窗口
- 使用
range查询限定@timestamp的起止时间 - 识别时区、边界条件和过大时间范围带来的查询偏差
先把故障时间变成查询窗口
实际排障很少知道“异常恰好发生在某一秒”。更常见的是已知报警出现在 10:35 左右,因此应先给它一个前后缓冲,例如查询 10:30 到 10:40,再根据结果逐步缩小。
时间窗口通常有两种写法。绝对时间适合复盘已知事件,例如某天 10:30 到 10:40;相对时间适合查看“最近 15 分钟”“最近 1 小时”。无论使用哪种方式,都应优先查询日志平台真正用于时间排序和过滤的时间字段,而不是在 message 中搜索日期字符串。
使用 range 查询绝对时间
Elasticsearch 的 range 查询可以在日期字段上使用 gte、gt、lte 和 lt 指定边界。假设索引模式为 logs-*,下面查询 2026-09-17 02:30:00Z 到 02:40:00Z 之间的日志,并按时间升序查看。将 <PORT> 替换为 Elasticsearch 实际 HTTP 端口,将 <PATH> 替换为可写的本地目录。
curl -sS -o <PATH>/absolute-range.json -w '%{http_code}\n' -X POST 'http://localhost:<PORT>/logs-*/_search' \
-H 'Content-Type: application/json' \
-d '{
"size": 3,
"sort": [
{ "@timestamp": "asc" }
],
"_source": ["@timestamp", "service.name", "log.level", "message"],
"query": {
"range": {
"@timestamp": {
"gte": "2026-09-17T02:30:00Z",
"lt": "2026-09-17T02:40:00Z"
}
}
}
}'预期输出为 HTTP 状态码;成功查询时:
200响应体写入 <PATH>/absolute-range.json。其中最多返回 3 条命中,并按 @timestamp 升序排列;命中日志的具体内容取决于你的数据。
这里使用 gte 配合 lt,形成半开区间 [02:30, 02:40)。连续查询相邻窗口时,例如下一段从 02:40 开始,可以避免同一条边界日志被两个窗口重复命中。
用相对时间快速查看近期日志
日期字段的范围查询也支持日期数学表达式,因此可以直接写“现在往前 15 分钟”。
curl -sS -o <PATH>/recent-range.json -w '%{http_code}\n' -X POST 'http://localhost:<PORT>/logs-*/_search' \
-H 'Content-Type: application/json' \
-d '{
"size": 20,
"sort": [
{ "@timestamp": "desc" }
],
"query": {
"range": {
"@timestamp": {
"gte": "now-15m",
"lte": "now"
}
}
}
}'预期输出:
200响应体写入 <PATH>/recent-range.json,成功时其中只包含查询执行时最近 15 分钟范围内的命中,最多 20 条,并按 @timestamp 倒序排列。
相对时间适合值班期间快速查看近期异常,但不适合需要重复复盘的报告。因为几分钟后再次执行,now-15m 对应的绝对时间已经变化。需要让查询结果可复现时,应把最终窗口记录成明确的 ISO 8601 时间。
注意时区和时间字段含义
看到“10:35 报错”时,先确认这个时间来自哪里。浏览器界面可能显示本地时区,而索引中的 @timestamp 常以 UTC 形式保存。若直接把本地时间当成 UTC 输入,查询窗口可能整体偏移数小时。
此外还要确认 @timestamp 表示的是事件发生时间还是采集时间。如果日志在网络阻塞后延迟到达,以采集时间查询可能找不到真正的故障现场。日志平台最好明确区分事件时间与采集时间,并让日常检索统一使用一个主时间字段。
从宽窗口逐步收窄
高效排障可以遵循一个简单顺序:先根据报警或用户报错建立较宽的时间窗口,再加入服务名、日志级别、请求 ID 等字段条件,最后逐步收窄到几分钟甚至几十秒。时间过滤负责减少候选数据,字段过滤负责提高相关性,两者配合比无范围的全文搜索更稳定。
当查询需要长期保存或交接给其他人时,记录明确的起止时间、时区和使用的时间字段。这样下一位排障人员能够执行同一查询,而不会因为“最近 15 分钟”或本地时区不同得到另一批日志。