用途:为 PostHog 支持工单和故障排查收集诊断证据,自动汇总 SDK 版本、API 连通性、功能开关状态、事件流验证结果以及脱敏后的配置信息。
主要能力:生成带时间戳的调试包目录,记录 Node/npm/Python 版本与操作系统信息;列出 posthog-js、posthog-node 及 Python posthog 包版本;检测美国云、欧洲云采集端点与应用 API 的连通性;对 POSTHOG 相关环境变量做脱敏处理;识别项目密钥与个人 API 密钥类型;发送测试事件验证采集链路;通过 /decide 端点检查功能开关;使用个人 API 密钥验证管理 API 访问;打包前扫描是否残留密钥。
使用方式:需项目已安装 PostHog SDK,可访问环境变量,并具备 curl 与 jq。按步骤依次运行诊断脚本、测试事件采集、检查功能开关、验证管理 API,最后打包并审查。关键命令包括 curl 请求 https://us.i.posthog.com/capture/ 与 https://us.i.posthog.com/decide/?v=3,以及 tar -czf 打包。
适用场景:排查 SDK 兼容性、网络或防火墙、事件采集失败、功能开关评估异常、密钥类型错误等。
限制:资料未提供具体收费、价格或平台支持范围;所有密钥自动脱敏,分享前仍需人工审查;连通性失败可能源于企业防火墙,需检查代理或 VPN;采集返回非 200 通常为无效 API 密钥;/decide 失败可能是密钥与主机区域不匹配;个人 API 返回 401 表示密钥过期,需在设置中重新生成。