SuperAPI AI 工具集

error-monitoring

部署与运维

查看项目

更新于 10-15 23:33

技能介绍

用途:该技能用于在 Next.js 应用中实现健壮的错误处理、日志记录与监控,覆盖从本地开发到生产监控的常见需求,帮助捕获并修复问题。

主要能力:提供 React 错误边界示例,包括 app/error.tsx 基础边界、app/global-error.tsx 全局边界以及嵌套路由级边界;定义 AppError 及 ValidationError、AuthenticationError、AuthorizationError、NotFoundError、DatabaseError 等自定义错误类;给出 Logger 与 StructuredLogger 实现,支持 debug/info/warn/error 级别、上下文与请求 ID;演示 API 路由中的错误处理,区分 AppError、Zod 校验错误、Prisma P2002 唯一约束与未知错误;集成 Sentry,含 instrumentation.ts、客户端与服务端配置、captureException、captureMessage、setUser、addBreadcrumb;提供客户端全局错误与未处理 Promise 拒绝追踪;包含 PerformanceMonitor 慢操作告警、retry 重试逻辑与最佳实践清单。

使用方式:按资料中的文件路径与代码片段在 Next.js 项目中落地,例如在 app 目录添加 error.tsx,在 lib 下创建 errors.ts、logger.ts、retry.ts,在 API 路由中调用 handleApiError,并通过环境变量 NEXT_PUBLIC_SENTRY_DSN 配置 Sentry。

适用场景:设置错误边界、实现错误日志、接入 Sentry 等监控工具、处理 API 错误、创建自定义错误类、调试生产问题、性能监控与重试逻辑。

限制:资料未提供具体安装命令、依赖版本、收费与价格信息,也未说明各监控服务的完整配置细节;部分函数如 sendToLogService 仅有占位实现,需自行补充。