Semon Tech Notes

· 可观测性

结构化日志:从一条请求串起多个服务

选择能定位问题的字段,并为敏感数据留出明确边界。

定义最小字段集合

时间、服务、请求 ID、方法、路由模板、状态码和耗时通常够用。路由模板用 /items/:id 这类稳定值,避免把具体用户或资源 ID 变成指标标签。

{"ts":"2026-11-20T10:00:00Z","service":"catalog","request_id":"example-01","route":"/items/:id","status":503,"duration_ms":240}

沿调用链传播同一个标识

入口可生成自己的请求 ID,并将它传给后续受信服务。处理调用方传入的值时,应限制长度和格式。按同一个标识查找开始与结束事件,再用时间顺序定位哪个环节先出错。

控制内容与保留成本

默认不记录认证头、Cookie、完整请求体和含密钥的查询参数。先定义字段,再做脱敏,最后才允许格式化输出。抽查生产样本,确认日志结构一致,并检查查询和留存成本。