mcpField
E
error-tracking-angular

error-tracking-angular

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

关于 error-tracking-angular

面向 Angular 应用的 PostHog 错误跟踪技能，指导异常捕获、问题监控和源码映射，并遵循 Angular 服务与组件实践。

主要功能

  1. 01异常自动捕获与手动捕获
  2. 02问题监控与搜索
  3. 03告警和问题分配
  4. 04上传源码映射
  5. 05使用单例 PosthogService 封装 SDK

适用场景

  1. 01为 Angular 应用添加 PostHog 错误跟踪
  2. 02在错误边界捕获异常
  3. 03排查问题并将其分配给团队成员

安装

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

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

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

包含的文件

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

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

详细介绍

Angular 的 PostHog 错误跟踪

此技能可帮助你在 Angular 应用中添加 PostHog 错误跟踪。

参考文件

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

请查阅文档，了解 API 详情和框架专用模式。

核心原则

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

框架指南

  • 使用 inject() 而非构造函数注入。需要使用 PostHog 服务的组件或服务应通过 inject() 注入该服务。
  • 创建专用的 PosthogService 单例根服务，用于封装 PostHog SDK。
  • 始终优先使用独立组件，而非 NgModules。
  • 在 src/environments/environment.ts 文件中配置 PostHog 凭据，因为 Angular 会从这些配置文件中读取环境变量

评论

支持 Markdown