登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  linux

journalctl 怎样按服务实时跟踪并过滤日志

来源:17golang原创

时间:2026-11-17 00:38:17 265浏览 收藏

排查 systemd 服务时,最实用的组合通常是 journalctl -u 服务名 -f:-u 先把范围收窄到指定 unit,-f 再持续输出新写入的日志。需要回看某个时间段时加上 --since 和 --until;需要按结构化字段或消息正文继续缩小范围时,分别使用 FIELD=VALUE 和 --grep。

官方文档:https://www.freedesktop.org/software/systemd/man/latest/journalctl.html

要点速览
  • -u api.service 按 systemd unit 过滤,-f 持续打印追加到 journal 的新记录。
  • --since 与 --until 是时间边界,既能回看历史,也能与实时跟踪组合。
  • _SYSTEMD_UNIT=api.service 这类字段匹配适合精确定位,--grep=timeout 针对 MESSAGE 字段做正则过滤。
api.service、systemd-journald、journalctl、-u 服务过滤和-f 实时跟踪之间关系的原创静态结构说明图
图1:服务单元写入 journal、journalctl 按 unit 读取并持续跟踪新增记录的静态关系图,不是运行截图。

先用 -u 把服务范围锁定

如果直接运行 journalctl,看到的可能是当前用户有权限读取的多类日志。排查某个服务时,先写出完整 unit 名称,例如 api.service,再用 -u 或 --unit= 限定范围。官方手册说明,这个选项会匹配 unit 本身的消息,也会纳入 systemd 针对该 unit 的相关消息。

# 只查看 api.service 的最近日志;--no-pager 便于在脚本或远程终端中直接阅读
journalctl --unit=api.service --no-pager

# 需要同时关注多个 unit 时重复使用 -u,避免把无关服务混进来
journalctl -u api.service -u worker.service --no-pager

-u 不是普通文本搜索,它按 journal 中的 unit 关联字段工作。服务使用模板实例时,可以传入匹配模式;如果只是想找消息里出现的某个词,应改用后面的 --grep。

用 -f 实时跟踪新增日志

实时观察发布、重启或请求处理时,使用 -f。它会先显示最近的日志记录,然后持续打印追加到 journal 的新记录,直到按下 Ctrl-C 或进程被终止。

# 先看 api.service 的近期记录,再持续接收新日志
journalctl -u api.service -f

# 只保留最近 50 条作为初始上下文,然后继续跟踪新记录
journalctl -u api.service -n 50 -f

第二条命令中的 -n 50 只影响进入跟踪状态前的初始输出;实时阶段仍然会继续显示新记录。只想从现在开始观察而不需要历史上下文时,可以把初始条数设为零,并保留 -f 的监听语义。

给实时查询加上时间窗口

--since 表示从某个时间点(含)开始,--until 表示到某个时间点(含)结束。日期、完整时间、today、now 和相对时间都可以作为时间表达式;具体写法要让当前 shell 把整个表达式作为一个参数传给 journalctl。

# 回看今天到当前时刻的服务日志,并保持实时跟踪
journalctl -u api.service --since today --until now -f

# 只观察最近 15 分钟内的服务记录,避免旧日志淹没当前排查
journalctl -u api.service --since "-15 min" -f

当 --until 使用 now 时,它限制的是查询开始时的历史范围,而不是把未来时间冻结住;配合 -f 后,新追加的记录仍会继续输出。要导出一个已经结束的时间段,则不要加 -f。

用字段匹配和 --grep 缩小内容

journal 记录是结构化的。可以把 FIELD=VALUE 作为匹配参数,例如 _SYSTEMD_UNIT=api.service;不同字段之间默认是同时满足,同一字段重复匹配则表示任一值满足。消息正文过滤使用 --grep,它针对 MESSAGE 字段使用 PCRE 正则。

# 用结构化字段和时间范围同时约束结果
journalctl _SYSTEMD_UNIT=api.service --since today --no-pager

# 在服务日志中筛选 MESSAGE 字段含 timeout 的记录;小写模式默认不区分大小写
journalctl -u api.service --grep=timeout --since "-30 min" --no-pager

# 需要限定多个条件时,把参数组合在同一条命令中形成 AND 关系
journalctl -u api.service _HOSTNAME=node-a --grep="connection (reset|refused)" -f

--grep 不会替代 -u:前者看消息字段,后者看 unit 关联。若正则包含空格、括号或竖线,建议用引号保护它;模式全部小写时,journalctl 默认进行大小写不敏感匹配,混入大写后则会按大小写敏感处理,必要时可显式使用 --case-sensitive=。

journalctl 的 -u 服务过滤、--since 和--until 时间窗口、--grep MESSAGE 内容过滤共同缩小匹配日志的原创说明图
图2:unit、时间窗口和 MESSAGE 字段过滤共同作用的静态交集关系图,不是运行截图。

把常见排查场景整理成三条命令

场景命令形态关注点
发布时盯住服务journalctl -u api.service -f先看最近记录,再接收新增记录
回看一段时间journalctl -u api.service --since "-30 min"不进入持续跟踪,命令输出到当前范围结束
找特定故障词journalctl -u api.service --grep=timeout --since todayunit、时间和 MESSAGE 三层同时收窄

如果需要让输出更适合复制到工单,可以再加 --no-pager;如果需要保留完整结构化字段,再考虑 --output=json 或 --output=verbose。不要把 --grep 当成字段查询,也不要把 -f 加到一次性历史导出任务中。

常见问题

为什么 -u 查不到服务日志?

先确认传入的是完整 unit 名称,并确认当前用户有权限读取系统 journal。必要时使用具备相应 journal 读取权限的账号,再检查服务实际写入的 unit 归属。

--since today 和 -f 能一起用吗?

可以。前者决定初始查询从今天零点开始,后者让命令在初始结果之后继续输出新追加的记录。

--grep 能筛选任意字段吗?

不能。--grep 针对 MESSAGE 字段;要筛选主机、unit 或优先级等结构化字段,应使用对应的 FIELD=VALUE 或专用选项。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>