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字段做正则过滤。

先用 -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 api.service -f | 先看最近记录,再接收新增记录 |
| 回看一段时间 | journalctl -u api.service --since "-30 min" | 不进入持续跟踪,命令输出到当前范围结束 |
| 找特定故障词 | journalctl -u api.service --grep=timeout --since today | unit、时间和 MESSAGE 三层同时收窄 |
如果需要让输出更适合复制到工单,可以再加 --no-pager;如果需要保留完整结构化字段,再考虑 --output=json 或 --output=verbose。不要把 --grep 当成字段查询,也不要把 -f 加到一次性历史导出任务中。
常见问题
为什么 -u 查不到服务日志?
先确认传入的是完整 unit 名称,并确认当前用户有权限读取系统 journal。必要时使用具备相应 journal 读取权限的账号,再检查服务实际写入的 unit 归属。
--since today 和 -f 能一起用吗?
可以。前者决定初始查询从今天零点开始,后者让命令在初始结果之后继续输出新追加的记录。
--grep 能筛选任意字段吗?
不能。--grep 针对 MESSAGE 字段;要筛选主机、unit 或优先级等结构化字段,应使用对应的 FIELD=VALUE 或专用选项。
-
422 收藏
-
204 收藏
-
426 收藏
-
387 收藏
-
242 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习