error-tracking-ruby

Ruby 的 PostHog 错误跟踪

此技能可帮助你将 PostHog 错误跟踪添加到 Ruby 应用程序中。

参考文件

• references/ruby.md - Ruby 错误跟踪安装文档
• references/fingerprints.md - Fingerprint 文档
• references/alerts.md - 发送错误跟踪警报文档
• references/monitoring.md - 监控和搜索问题文档
• references/assigning-issues.md - 将问题分配给队友的文档
• references/upload-source-maps.md - 上传 source map 文档

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

关键原则

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

框架指南

• posthog-ruby 是 Ruby SDK 的 gem 名称（将 gem 'posthog-ruby' 添加到 Gemfile），但应通过 require 'posthog' 引入（不要使用 require 'posthog-ruby'）。
• 在脚本和 CLI 中，使用 PostHog::Client.new(api_key: key, host: host) 进行基于实例的初始化。
• 在 CLI 和脚本中：退出前必须调用 client.shutdown，否则所有事件都会丢失。
• 使用 begin/rescue/ensure，并在 ensure 块中调用 shutdown，以正确清理。
• capture 和 identify 接受单个哈希参数：client.capture(distinct_id: 'user_123', event: 'my_event', properties: { key: 'value' })
• capture_exception 接受位置参数（而非关键字参数）：client.capture_exception(exception, distinct_id, additional_properties) — 不要使用 distinct_id: 关键字语法。