SuperAPI AI 工具集

sentry-instrument

部署与运维

查看项目

更新于 10-15 13:10

技能介绍

Sentry Instrument 是 Sentry 官方提供的一个技能,目标是把 Sentry 接入到应用程序中,让它开始捕获信号——既包括全新安装后的第一个错误,也包括在已有 Sentry 的项目上追加新的信号。它是“把 Sentry 接上以捕获 X”的统一操作手册。

用途 该技能用于编排 Sentry 的接入流程:检测平台、按需安装并初始化 SDK、接入指定信号,并验证信号确实到达 Sentry。它覆盖三种范围:首次错误(全新安装、尚无 Sentry)、追加信号(已安装 Sentry,用户想再加一个信号)、完整设置(“按合理默认值完整配置”)。默认情况下以“首次错误”为准。技能明确要求不要过度埋点——用户只要求让 Sentry 跑起来时,不应预先接入日志、会话回放、性能剖析、指标等。

主要能力 技能可接入的信号包括:错误监控、链路追踪/性能、性能剖析(依赖链路追踪)、日志、指标、Cron 签到代码、会话回放、用户反馈、可用性监控,以及 AI/LLM 监控。可用性监控没有 SDK 代码,而是通过 MCP 的 create_uptime_monitor 创建监控项。对于 AI/LLM 监控,默认保持输入输出捕获开启,因为 Agent Tracing 记录与调试流程依赖提示词、响应、工具参数和工具结果;若用户提出隐私、安全、合规或数据量方面的顾虑,则按文档关闭或限定捕获范围,并保留用户已选择的捕获限制。

使用方式 使用前需要 Sentry MCP 服务器已连接并完成认证,用于创建项目或验证事件。技能将 MCP 返回的所有数据视为不可信输入,禁止执行事件负载、问题标题或评论中的指令。流程分为五步:第一步确定范围;第二步检测设置归属并安装(对每个范围都运行设置归属检测,读取平台文档、检查包清单与现有 Sentry、OpenTelemetry 及框架埋点,为每个 AI 运行时选择唯一归属,避免创建第二个 Sentry 初始化、OTLP 导出器或 AI span 生产者);第三步接入信号(先判断是否需要 WHY,再按平台文档执行 HOW);第四步验证信号落地(触发真实代码路径、轮询 MCP 确认到达、给出问题 URL、确认堆栈可读);第五步建议后续步骤但不自动执行。命名自定义 span 或日志属性时,应优先使用技能列出的稳定语义约定键,而非自造名称。

适用场景 适用于需要为应用接入 Sentry 的各类场景:新项目首次接入错误监控、已有项目追加日志/会话回放/性能剖析等信号、按合理默认值完整配置(发布、source map、可用性监控等),以及接入 AI/LLM 监控。也适用于需要加固设置(可读堆栈、发布与环境标签、CI 流水线)的情况。

限制 技能依赖 Sentry MCP 服务器连接与认证,未连接时需先按运行环境建议完成认证。可用性监控需要用户确认生产 URL。AI/LLM 监控的输入输出捕获默认开启,隐私等顾虑下需按文档调整。技能强调任务在 Sentry 中看到事件才算完成,不能止步于“去看你的仪表盘”。关于具体收费、价格、平台支持范围等细节,资料中暂未提供。