用途:这是一个决策框架类技能,解决“埋点时该发什么信号”的问题。错误、追踪、日志、指标四类遥测常相互重叠,选错会导致数据虽在却无法用于后续工作流。本技能帮助在具体代码位置决定由哪种信号承载某个值或事件。
主要能力:给出四类信号各自回答的问题——错误回答“什么坏了”(堆栈与异常类型,聚合成可指派跟踪的 Issue);追踪回答“请求是否按预期流转”(带计时的 Span 瀑布,多为自动埋点);日志回答“此刻代码状态是什么、为什么”(结构化事件,含配置、开关、输入输出与决策);指标回答“长期趋势如何”(计数器、仪表、分布,可按属性切片、告警、跨部署对比)。并提供决策表与重叠消解规则:单请求上下文用 Span 属性,跨请求可图表化/告警的独立值用指标;Span 回答位置与耗时,日志回答状态与原因;日志找单个出错请求,指标统计出错比例,不要靠数日志行推导速率;需堆栈并跟踪的用错误,已处理但值得记录的用日志,非关键带堆栈可用 logger.warning(exc_info=True)。还说明采样与过滤:追踪按 traces_sample_rate 采样,错误默认捕获,日志与指标不采样而用 before_send_log、before_send_metric 过滤;四类信号共享 trace_id 可互相关联。
使用方式:在埋点、规划“何处埋什么”、审查现有埋点缺口,或需要为编码代理提供一致选择规则时调用。实际接线交由对应 sentry-<platform>-sdk 技能(如 sentry-python-sdk、sentry-nextjs-sdk、sentry-node-sdk),LLM/代理调用埋点交由 sentry-setup-ai-monitoring。
适用场景:服务或请求处理器的埋点规划、错误流为空但用户报障等缺口审查。
限制:文中 SDK API 与代码示例仅为示意,实施前须对照 docs.sentry.io 与相应 SDK 技能核实签名与最低版本;具体采样与过滤配置见对应 SDK 技能的 references/tracing.md 与 references/metrics.md;日志与指标需先在 SDK 中启用。其余细节暂未提供。