mcpField
E
error-tracking-node

error-tracking-node

github.com/posthog开发76110 次安装今天更新
代码仓库

关于 error-tracking-node

为 Node.js 应用提供 PostHog 错误跟踪实施指导，面向需要接入错误监控的开发者。内容涵盖 SDK 配置、异常捕获、源码映射及问题管理，并强调保留现有错误处理。

主要功能

  1. 01配置 posthog-node 异常自动捕获
  2. 02在错误边界手动捕获异常
  3. 03上传源码映射还原堆栈
  4. 04跟踪路由操作与错误
  5. 05提供告警和问题管理参考

适用场景

  1. 01为 Node.js 服务添加错误监控
  2. 02在 Express、Fastify 或 Koa 中捕获错误
  3. 03为短生命周期脚本配置即时发送
  4. 04排查经压缩代码映射后的堆栈

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/posthog/skills --skill error-tracking-node

安装后在 Claude Code 中输入/error-tracking-node确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
alerts.md
assigning-issues.md
fingerprints.md
monitoring.md
node.md
upload-source-maps.md

详细介绍

Node.js 的 PostHog 错误跟踪

此技能可帮助你在 Node.js 应用程序中添加 PostHog 错误跟踪。

参考文件

  • references/node.md - Node.js 错误跟踪安装文档
  • references/fingerprints.md - 指纹文档
  • references/alerts.md - 发送错误跟踪警报文档
  • references/monitoring.md - 监控和搜索问题文档
  • references/assigning-issues.md - 将问题分配给队友的文档
  • references/upload-source-maps.md - 上传源映射文档

请查阅文档，了解 API 详情和特定框架的模式。

核心原则

  • 环境变量：始终使用环境变量设置 PostHog 密钥和主机 URL。切勿将其硬编码。
  • 最小改动：在现有错误处理中添加错误跟踪。不要替换或重构现有错误处理代码。
  • 优先启用自动捕获：在添加手动捕获之前，先在 SDK 初始化时启用异常自动捕获。
  • 源映射：上传源映射，使堆栈跟踪能够解析到原始源代码，而不是压缩后的代码包。
  • 在错误边界处手动捕获：对于不会传播到全局处理程序的错误，在错误边界和 catch 块中使用 captureException()。

框架指南

  • posthog-node 是 Node.js 服务端 SDK 的包名——服务端切勿使用 posthog-js
  • 在 PostHog 构造函数选项中加入 enableExceptionAutocapture: true
  • 在路由处理程序中为有意义的用户操作添加 posthog.capture() 调用——每个创建、更新或删除数据的路由都应使用上下文属性跟踪事件
  • 在应用程序的错误处理程序中添加 posthog.captureException(err, distinctId)（例如，Express 错误中间件、Fastify setErrorHandler、Koa app.on('error')）
  • 对于长时间运行的服务端，SDK 会自动批量发送事件——除非有特定原因，否则不要设置 flushAt 或 flushInterval
  • 对于短生命周期进程（脚本、CLI、无服务器），将 flushAt 设为 1，将 flushInterval 设为 0，以便立即发送事件
  • 服务端 Node.js 无需反向代理——只有客户端 JavaScript 需要代理来避免广告拦截器
  • 请记住，node_modules 目录中提供了源代码
  • 检查 package.json 中的类型检查或构建脚本，以验证更改

评论

支持 Markdown