Logfire
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 安装 @user_3c6cb52e/logfire。
技能介绍
##要解决的问题
日志排查常卡在三点:混合语言栈下格式不统一、把结构化字段写死成字符串、静态配置过期没人验证。写排查规则时还要反复改采集端,最后线上仍然出现格式漂移、字段缺失和静默截断。
- 把时间戳、请求 ID、错误码和 trace 拼成一行文本,读日志要二次解析。
- 临时改
日志采集、规则维护和字段映射,上线前没人跑冒烟测试。 - 规则文档和实际 payload 不同步,字段改名后告警变成噪音。
##核心能力与关键步骤
这个 skill 的做法是“约定优先、边界显式、写入前可推导”。
- 读取配置与字段约定,明确哪些字段必填,以及每类事件的 schema 版本。
- 把日志事件规范化为结构化记录,保留时间、级别、请求标识、错误类型和上下文摘要。
- 控制敏感字段与截断策略,避免把长文本或个人信息整段写入。
- 提供可执行的测试样例,使样例结果成为文档的一部分。
##适用边界与注意点
本仓库只收录一个技能文件,适合作为规则和测试夹具,而不是即插即用的运维平台。复杂拓扑需要与团队的网络、安全和观测配置共同评审。规则、脱敏和容量阈值必须随 payload 变更持续维护。
使用场景
- 混合语言栈后端需要统一日志格式,为每类事件定义结构化字段与 schema 校验
- 维护解析规则前,先用测试样例验证字段缺失或改名是否导致误告警
- 线上日志出现静默截断或敏感信息泄漏,需要补充截断策略与脱敏规则后重放样例确认
- 跨团队 schema 变更后,需要生成变更清单并更新文档与告警配置
适合人员
- 需要为多语言后端项目统一日志结构的后端工程师,希望补充可验证的字段约定与测试样例
- 负责日志采集和告警规则维护的 SRE,需要降低字段变更带来的误报与漏报风险
- 处理日志中敏感信息的 data security 负责人,需要为采集和展示添加脱敏与边界约束
- 设计或维护观测平台的后端架构师,需要让文档、规则和 payload 保持一致