日志里没有时间戳,排障就少了一半线索:给服务输出加结构化日志
【摘要】 日志只有一句话时很难排障。本文介绍结构化日志应包含的时间、级别、请求标识等字段,以及不写敏感信息、按请求串联日志的落地顺序。
很多服务出问题时,第一反应是去翻日志,结果却发现日志只有一句话,既不知道发生在哪一次请求,也不知道前后发生了什么。问题往往不在日志太少,而在日志没有结构:时间、级别、请求标识和关键字段缺失,后续再想还原现场就很难了。
先把每条日志写完整
一条能用于排障的日志,至少应该包含以下字段:
- 时间:精确到毫秒,并统一使用同一时区,避免多台机器时间口径不一致。
- 级别:区分调试、信息、警告和错误,不要把所有日志都写成信息级别。
- 请求标识:一次请求从入口到出口使用同一个标识,方便把分散的日志串起来。
- 模块与操作:写清楚是哪个模块、在做什么,而不是只写结果。
- 结果与耗时:关键步骤要记录成功或失败,以及耗时,便于判断是慢还是错。
用结构化格式代替自由文本
自由文本看起来顺眼,但搜索和统计都很麻烦。结构化日志把字段固定下来,例如:
时间=2026-10-30 09:00:00.123 级别=INFO 请求标识=req-demo-001 模块=订单查询 操作=查询订单 结果=成功 耗时=42ms
这样在日志平台里可以直接按请求标识过滤,也可以按模块、结果和耗时做统计。排障时先定位一次失败请求,再按时间顺序看同一标识下的全部日志,往往比逐行猜测快得多。
哪些内容不应该写进日志
日志不是越详细越好。口令、密钥、令牌、完整的账号信息和用户的敏感内容都不应该出现在日志里。需要记录用户相关信息时,只记录脱敏后的标识或类型,例如用户类型、订单状态,而不是原始敏感字段。
一个简单的落地顺序
- 先统一时间格式和时区,再统一级别的含义。
- 在请求入口生成请求标识,并透传到后续调用中。
- 给核心流程加上开始、结束和异常三类日志。
- 定期检查日志量和噪声,把重复、无意义的调试日志降级或删除。
日志的价值不在写得多,而在出问题时能快速回答三个问题:什么时候发生的、影响了哪一次请求、前后还发生了什么。把这三个问题写进每条日志,排障就有了稳定的起点。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)