SuperAPI AI 工具集

logging-observability

部署与运维

查看项目

更新于 10-15 21:51

技能介绍

用途:在 sentry-mcp 代码库中审查代码的日志与错误处理模式,核心原则是 4xx 错误(用户可自行修正)绝不创建 Sentry 问题,5xx 错误(系统故障)必须创建 Sentry 问题。

主要能力:区分错误层级——ApiClientError(4xx,含 400/401/403/404/422/429)不发送 Sentry;ApiServerError(5xx)发送 Sentry;UserInputError、ConfigurationError、LLMProviderError 不创建问题。日志函数中 logDebug/logInfo/logWarn/logError 不创建 Sentry 问题,仅 logIssue 创建并返回 Event ID。

使用方式:4xx 用 logWarn(),5xx 用 logIssue(),未知错误用 logIssue() 调查;禁止裸用 console.log/warn/error 与直接调用 captureException(),改用结构化日志包装。工具处理器让错误冒泡至 MCP 服务器包装器 formatErrorForUser;嵌入式智能体工具使用 agentTool() 包装器,其自动区分 4xx/5xx 并返回对应结果。降级逻辑需先判别错误类型再决定是否回退。5xx 面向用户的错误应附带 Event ID。

适用场景:代码审查、错误分类、日志级别选择、结构化上下文(loggerScope、contexts、extra)检查。

限制:资料仅针对 sentry-mcp 代码库,未提供其他项目适配、安装命令或收费信息。