格式化、拆分和转换 NDJSON(换行分隔的 JSON)。
将换行符分隔的 JSON 流格式化为可读条目,以进行日志分类、管道验证和事件调试,而不会丢失记录边界。
它逐行解析 NDJSON 并以可检查的结构化格式呈现每个记录。
它有助于快速识别大型事件流中的格式错误的行和摄取输出。
它保留队列、日志和分析管道故障排除所需的每行记录语义。
双行流
{"event":"login","user":"u1"}
{"event":"logout","user":"u1"}混合有效负载
{"level":"info","ts":1741171200}
{"level":"error","message":"timeout"}边缘情况示例
{"id":1}
{"id":2}格式化记录
每行使用可读嵌套字段解析记录 #1 和 #2。
验证摘要
2 个有效行,跳过 1 个空行,0 个语法失败。
调试说明
每行只保留一个 JSON 对象,避免在单条记录末尾保留尾随逗号。
一行上的多个 JSON 对象
将每个对象拆分为自己的换行符分隔记录。
记录中的尾随逗号
确保每一行都是独立且有效的 JSON。
空或仅空白行会破坏解析器
删除空行或配置解析器以忽略它们。
日志中的 UTF-8 编码问题
在摄取或格式化之前规范化文件编码。
NDJSON 格式化器 应作为交付流程中的快速校验步骤,在提交、发布和交接前都建议执行一次。
NDJSON 与 JSON 数组有何不同?
NDJSON 每行存储一个 JSON 对象,而数组会把所有记录包进同一个 JSON 文档。
我可以粘贴非常大的日志流吗?
是的,但是分块大流可以提高调查过程中的响应能力。
为什么只解析某些行?
无效行通常是由语法错误或混合在其中的非 JSON 日志文本引起的。
这对数据管道质量检查有帮助吗?
是的。它对于摄取前健全性检查和模式漂移检测非常有效。