日志里没有时间戳,排障就少了一半线索:给服务输出加结构化日志

举报
yd_255038127 发表于 2026/10/30 09:45:29 2026/10/30
【摘要】 日志只有一句话时很难排障。本文介绍结构化日志应包含的时间、级别、请求标识等字段,以及不写敏感信息、按请求串联日志的落地顺序。

很多服务出问题时,第一反应是去翻日志,结果却发现日志只有一句话,既不知道发生在哪一次请求,也不知道前后发生了什么。问题往往不在日志太少,而在日志没有结构:时间、级别、请求标识和关键字段缺失,后续再想还原现场就很难了。

先把每条日志写完整

一条能用于排障的日志,至少应该包含以下字段:

  • 时间:精确到毫秒,并统一使用同一时区,避免多台机器时间口径不一致。
  • 级别:区分调试、信息、警告和错误,不要把所有日志都写成信息级别。
  • 请求标识:一次请求从入口到出口使用同一个标识,方便把分散的日志串起来。
  • 模块与操作:写清楚是哪个模块、在做什么,而不是只写结果。
  • 结果与耗时:关键步骤要记录成功或失败,以及耗时,便于判断是慢还是错。

用结构化格式代替自由文本

自由文本看起来顺眼,但搜索和统计都很麻烦。结构化日志把字段固定下来,例如:

时间=2026-10-30 09:00:00.123 级别=INFO 请求标识=req-demo-001 模块=订单查询 操作=查询订单 结果=成功 耗时=42ms

这样在日志平台里可以直接按请求标识过滤,也可以按模块、结果和耗时做统计。排障时先定位一次失败请求,再按时间顺序看同一标识下的全部日志,往往比逐行猜测快得多。

哪些内容不应该写进日志

日志不是越详细越好。口令、密钥、令牌、完整的账号信息和用户的敏感内容都不应该出现在日志里。需要记录用户相关信息时,只记录脱敏后的标识或类型,例如用户类型、订单状态,而不是原始敏感字段。

一个简单的落地顺序

  1. 先统一时间格式和时区,再统一级别的含义。
  2. 在请求入口生成请求标识,并透传到后续调用中。
  3. 给核心流程加上开始、结束和异常三类日志。
  4. 定期检查日志量和噪声,把重复、无意义的调试日志降级或删除。

日志的价值不在写得多,而在出问题时能快速回答三个问题:什么时候发生的、影响了哪一次请求、前后还发生了什么。把这三个问题写进每条日志,排障就有了稳定的起点。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。