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

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 只负责改变这些记录的展示形式。它不会自动替你选择字段,也不会把普通文本日志转换成另一套业务数据。

systemd 日志来源、journal entry 字段和 json-pretty 展示层的静态关系说明图
图1:结构说明图,展示服务日志记录与 JSON 字段的静态关系,不是终端截图或运行证据。

可以先按服务和最近时间范围查看,再决定需要保留哪些字段:

# 只查看目标服务最近 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 查询约束、字段选择和 JSON 输出选项的静态依赖关系说明图
图2:结构说明图,展示查询约束、字段选择和 JSON 展示选项的静态依赖,不是命令运行截图。
# 只保留排障所需字段,方便人工横向比较多条记录
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 的访问权限;应先处理用户可读范围或权限边界。

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