SuperAPI AI 工具集

sentry-node-sdk

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:为服务端 JavaScript/TypeScript 运行时(Node.js、Bun、Deno)配置 Sentry SDK,覆盖错误监控、追踪、日志、性能分析、Crons、指标与 AI 监控。

主要能力:先检测运行时、框架、模块系统、已有 @sentry 包、instrument 文件、日志库、定时任务、AI 库与 OpenTelemetry 追踪,再给出推荐方案并引导安装配置。支持 Express、Fastify、Koa、Hapi、Connect、Bun.serve()、Deno.serve() 等框架的错误处理器。

使用方式:Node.js 可运行 npx @sentry/wizard@latest -i node,或手动安装 @sentry/node 并创建 instrument 文件;ESM 用 node --import ./instrument.mjs app.mjs,CJS 在入口首行 require("./instrument")。Bun 安装 @sentry/bun,用 bun --preload ./instrument.ts server.ts 启动。Deno 需 2.0+,通过 deno.json 的 npm:@sentry/deno 导入,Sentry.init() 必须是入口文件首个导入,并授予网络、读取与环境变量权限。

适用场景:后端 JS/TS 应用需要错误监控、HTTP/DB 追踪、结构化日志、CPU 性能分析、定时任务监控、自定义指标或 LLM 调用监控时。

限制:Bun 与 Deno 无向导,仅手动配置;性能分析仅 Node.js 可用,Deno 不支持性能分析与运行时指标;检测到 OpenTelemetry 追踪时应改用 OTLP 路径,不设置 tracesSampleRate;NestJS 与 Next.js 应使用各自专用技能。SDK 版本与配置细节需以官方文档为准。