用途:监控 PostHog 集成健康度,围绕四类信号——事件摄取速率(事件是否在流动)、功能开关评估延迟(热路径是否够快)、按类型的事件量(发现埋点回归)、API 速率限制消耗(是否接近 429)。
主要能力:通过 PostHog 查询 API 与 HogQL 检查近 24 小时事件摄取;用 posthog-node SDK 包装 getFeatureFlag 并记录评估耗时直方图与计数;按 cron 统计当月事件量、独立用户与日均值,并推算月度用量与免费额度占比;提供 Prometheus 告警规则(摄取量下降、开关评估 P95 超 200ms、接近 100 万免费额度、capture 错误升高);给出仪表盘 HogQL 查询(每小时事件、按类型事件、日活、摄取新鲜度)。
使用方式:需 PostHog 项目与个人 API key(phx_...),应用已接入 PostHog SDK,Prometheus/Grafana 等监控栈为可选。示例命令使用 curl 调用 https://app.posthog.com/api/projects/$POSTHOG_PROJECT_ID/query/ 并携带 Authorization: Bearer $POSTHOG_PERSONAL_API_KEY;代码示例展示用 prom-client 的 Histogram、Counter、Gauge 上报指标。
适用场景:需要持续观测 PostHog 埋点与功能开关性能、控制事件量成本、并在异常时自动告警的团队。
限制:资料未提供具体价格、平台支持范围与效果保证;免费额度 1M 为示例中出现的数值,实际以官方为准;部分告警表达式依赖自定义指标命名,需按实际监控栈调整。