Linux 与服务器运维 / 系统课时

用 journalctl 查指定服务日志

用 journalctl 查指定服务日志

一台主机的 Journal 同时保存许多服务和系统组件的记录,直接运行 journalctl 很容易得到大量无关信息。本篇聚焦最常用的 Unit 过滤方式:查看某个 Service Unit 的历史日志,并在排障时实时跟踪它刚产生的新输出。

学习目标

  • 使用 journalctl -u 精确筛选指定 Service Unit
  • 结合 -n、--since 缩小日志范围
  • 使用 -f 实时跟踪服务后续产生的日志

按 Unit 查询日志

journalctl -u 会根据 systemd Unit 过滤记录。排查服务时应尽量写完整 Unit 名,例如 myapp.service,这样查询目标清晰,也便于把命令直接写进排障文档。

下面先创建一个临时服务产生两条确定的测试日志,再按 Unit 查询。示例需要运行在 systemd 主机上,并需要相应的 sudo 权限。

bash
sudo systemd-run --unit=journal-query-demo --property=Type=oneshot \
  /bin/sh -c 'echo "query-demo-start"; echo "query-demo-done"'
sudo journalctl -u journal-query-demo.service -o cat --no-pager

预期输出中可以找到两条测试消息;部分系统还可能包含 Unit 生命周期相关消息。

text
query-demo-start
query-demo-done

实际排障时,把 journal-query-demo.service 换成目标服务即可,例如 nginx.service、postgresql.service 或项目自己的 Unit 名。若不确定准确名称,可以先通过 systemctl status <UNIT> 或 systemctl list-units --type=service 确认。

先缩小时间和数量范围

生产服务可能已经积累大量日志,没有必要每次都从最早记录开始读取。-n 用于限制末尾记录数量,--since 用于限制起始时间,两者可以组合。

bash
sudo journalctl -u journal-query-demo.service -n 20 --since "10 minutes ago" --no-pager

预期结果是只显示该 Unit 在最近 10 分钟内的记录,并且最多取末尾 20 条。如果最近 10 分钟没有对应日志,命令可能只显示没有可用记录的提示或不显示日志正文。

text
<最近 10 分钟内 journal-query-demo.service 的日志;无匹配记录时没有日志正文>

--since 也可以接受明确时间,例如 2026-09-16 08:00:00。排查一次已经发生的故障时,先围绕故障时间缩小范围,通常比在完整日志中滚动查找更高效。

实时跟踪新日志

服务正在异常重试、接收请求或执行启动流程时,可以使用 -f 持续等待新记录。它的行为类似 tail -f,但过滤对象是 Journal 中指定 Unit 的记录。

bash
sudo journalctl -u journal-query-demo.service -f

预期结果是先显示当前查询位置附近的日志,然后保持运行;目标 Unit 产生新记录时,新行会继续出现在终端。由于输出取决于服务后续行为,没有固定日志内容,按 Ctrl+C 可以结束跟踪。

text
<已有日志>
<随后实时出现的新日志>

如果只关心启动跟踪之后的新消息,可以再结合 -n 0:journalctl -u <UNIT> -f -n 0。这样不会先打印历史记录,更适合一边触发操作、一边观察服务响应。

查询不到日志时检查什么

首先确认 Unit 名是否正确,并检查服务确实启动过。其次检查 Unit 是否把 stdout、stderr 重定向到了文件或其他目标;应用如果自行写文件,也不会自动出现在对应 Unit 的标准输出日志中。

还要区分“当前 Journal 中没有记录”和“服务从未产生日志”。journald 的持久化、轮转和磁盘空间策略都可能影响历史记录保留范围。因此故障排查时,journalctl -u <UNIT> 解决的是按服务定位现有 Journal 记录的问题,而不是保证任意时间跨度的日志都永久存在。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 journalctl 查指定服务日志

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通