首页/云/可观测性速查/结构化日志:字段化与规范
本包目录(282 条)
监控体系与方法40 条Prometheus 与采集64 条Grafana 与看板53 条
日志平台52 条
链路追踪23 条告警与响应50 条

结构化日志:字段化与规范

JSON 结构化日志让机器可解析:固定字段名(ts/level/service/trace_id)+ 稳定取值,过滤、聚合、关联都更简单。

可观测性速查云更新于 2026-10-12

结构化日志行示例

结构化日志行示例
{"ts":"2026-10-12T10:00:00.123Z","level":"error","service":"api",
 "trace_id":"4bf92f3577b34da6a3ce929d0e0e4736","route":"/v1/order",
 "status":500,"duration_ms":812,"msg":"upstream timeout"}
字段约定先小后大:时间用 ISO8601 UTC、级别用固定枚举、service 用部署名,其余按需扩展。

易错点

  • 时间字段用本地时区字符串会让跨区域排序错乱,统一 UTC ISO8601
  • 敏感信息(证件号、令牌、完整卡号)禁止进入日志正文,脱敏在写入前完成

数据来源与参考

  • OpenTelemetry 文档 · Logs data model
  • Elastic 官方文档 · ECS 字段规范
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌