Linux journalctl --output=json-pretty 怎样按字段查看服务日志
来源:17golang原创
时间:2026-11-18 06:35:56 254浏览 收藏
排查 systemd 服务时,日志里真正有用的往往不是整段长文本,而是 MESSAGE、PRIORITY、_SYSTEMD_UNIT 和时间等字段。journalctl --output=json-pretty 会把每条记录展开成多行 JSON 结构,适合人工阅读;再配合 --unit、时间范围和 --output-fields,就能把注意力收敛到目标服务和目标字段。
官方地址:https://www.freedesktop.org/software/systemd/man/latest/journalctl.html
想看清一条服务日志包含哪些字段,用--output=json-pretty;想缩小内容,用--unit和--output-fields;想给程序消费,则优先考虑单行json,不要把 pretty 输出当成稳定的单行协议。
先把日志范围和单条记录分开
我第一次用结构化输出时容易把“查哪些日志”和“每条日志长什么样”混在一起。-u/--unit、--since、--until 负责缩小记录集合;--output=json-pretty 只负责改变这些记录的展示形式。它不会自动替你选择字段,也不会把普通文本日志转换成另一套业务数据。

可以先按服务和最近时间范围查看,再决定需要保留哪些字段:
# 只查看目标服务最近 30 分钟的 20 条日志,并展开结构化字段 journalctl --no-pager --unit=demo.service --since="30 min ago" --lines=20 --output=json-pretty
在结果里,_SYSTEMD_UNIT 通常用于确认记录属于哪个服务单元,MESSAGE 是主要消息,PRIORITY 表示日志级别。若服务本身没有写入 journal,或者当前用户没有读取系统日志的权限,换输出格式也不会凭空产生记录。
json-pretty 怎样把一条日志展开
json-pretty 的作用是把一条记录格式化成更适合人看的多行 JSON 结构。官方手册还说明,journal 允许同名字段重复,而 JSON 对象通常不允许同名键,因此遇到重复字段时,JSON 表示可能使用数组保存多个值;字段过长时,默认还可能以 null 表示,想看完整内容需要显式使用 --all。
这几个边界很重要:多行格式方便定位字段,却不适合作为“每行一条 JSON”的输入;字段值是数组或 null 时,也不能简单假定它永远是普通字符串。人工排障可以从完整输出开始:
# 需要查看长字段或不可打印字段时显式关闭默认的字段缩略 journalctl --no-pager --unit=demo.service --lines=5 --all --output=json-pretty
如果只关心消息和级别,直接进入下一节的字段筛选更省眼力。不要把示意图当成真实机器输出;图中的节点只帮助理解记录、字段和展示层之间的关系。
按服务、时间和字段缩小排查范围
排障时我更常用“先限制范围,再限制字段”的组合。不同字段的多个匹配条件通常按逻辑与组合;同一个字段写出多个值时,则可以表达该字段的替代条件。这样可以把命令的职责分开:服务和时间负责筛选记录,--output-fields 负责筛选展示字段。

# 只保留排障所需字段,方便人工横向比较多条记录 journalctl --no-pager --unit=demo.service \ --since="2026-11-18 06:00:00" --until="2026-11-18 06:30:00" \ --output=json-pretty \ --output-fields=MESSAGE,PRIORITY,_SYSTEMD_UNIT
--output-fields 对 json、json-pretty、json-sse、json-seq 等会展示完整字段的格式有效;时间戳和启动标识等少数字段仍会被保留。若要先了解某个 journal 当前出现过哪些字段,可以使用:
# 列出日志中出现过的字段名称,先确认筛选名是否存在 journalctl --no-pager --unit=demo.service --fields
看不到字段时先判断是哪一层出了问题
| 现象 | 优先判断 | 处理方式 |
|---|---|---|
| 没有任何服务日志 | 查询范围、服务单元名或读取权限 | 先去掉时间限制,确认 --unit 名称,并在允许的情况下使用有权限的账户读取系统 journal。 |
长字段显示为 null | 字段超过默认输出限制 | 人工查看时加 --all,不要把缺省值误判成业务字段真的为空。 |
| 输出很多行,程序解析困难 | 把 pretty 格式当成单行协议 | 人工阅读保留 json-pretty;程序消费改用 --output=json,并自行处理字段值可能是数组或空值。 |
| 筛选后仍有固定元数据 | 系统保留的时间戳、启动标识等字段 | 把它们视为 journal 输出契约的一部分,不要仅凭字段未消失判断 --output-fields 失效。 |
最终可以把命令拆成三层检查:先确认日志是否存在,再确认服务和时间范围是否正确,最后确认字段筛选和输出格式是否符合阅读或程序消费的目标。这样遇到“字段为空”时,能区分权限、记录内容、字段截断和格式选择,而不是反复替换一个参数。
相关问题
json-pretty 和 json 应该怎么选?
json-pretty 面向人工阅读,会把一条记录排成多行;json 更适合把每条记录保持为一行,再交给脚本或日志处理程序。两者都应配合明确的字段范围和错误处理。
为什么 output-fields 之后还有额外字段?
官方手册规定,部分时间戳和启动标识字段始终输出。先按这个契约理解结果,再判断自己选择的字段是否已经生效。
权限不足时换成 json-pretty 有用吗?
没有用。输出格式只改变可见记录的表达方式,不改变 journal 的访问权限;应先处理用户可读范围或权限边界。
-
426 收藏
-
387 收藏
-
242 收藏
-
238 收藏
-
402 收藏
-
413 收藏
-
243 收藏
-
141 收藏
-
143 收藏
-
123 收藏
-
211 收藏
-
433 收藏
-
459 收藏
-
432 收藏
-
文章 · linux | 1天前 | 权限管理 · linux运维 · Linux systemd capabilities 最小权限 file capabilities ambient capabilities266 收藏
-
499 收藏
-
186 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习