SuperAPI AI 工具集

instrument-metrics

通用与其它

查看项目

更新于 10-16 03:45

技能介绍

用途:为新增或变更代码添加 PostHog 指标采集(计数器、仪表、直方图),适合在实现功能或审查 PR 后补齐关键操作度量,也可用于提示“添加指标或计数器”或将现有指标镜像到 PostHog。

主要能力与接入路径:若已安装 PostHog SDK(posthog-js、posthog-node、posthog-python),使用 posthog.metrics API,无需额外 OpenTelemetry 包;若代码库已导出 OpenTelemetry 指标,可将现有 OTLP 指标导出器(或 Collector)指向 PostHog,仅需配置导出器;其余情况参考“Other Languages”通用 OpenTelemetry 方式。

使用方式(按顺序):分析代码库并识别语言、框架与现有指标设置,检查依赖文件与 Prometheus、StatsD/Datadog、OpenTelemetry 等现有埋点及 PostHog SDK;选择采集路径;在现有指标旁叠加 PostHog 调用,复用同名与属性,不删除或重构原有埋点;为关键流程补充成功/失败计数、外部调用与任务耗时直方图、队列深度与连接池仪表,命名采用点分隔描述性名称并设置服务名;保持低基数,属性用 route、status、plan、queue 等有限维度,避免用户 ID、会话 ID、请求 ID 和时间戳;配置环境变量,项目已配置则跳过,缺少项目 token 时可通过 PostHog MCP 获取或询问用户;验证指标到达,短生命周期进程退出前需 flush(如 posthog.metrics.flush() 或 OTel 的 forceFlush()/shutdown())。

环境变量与区域:PostHog host 美国为 https://us.i.posthog.com,欧洲为 https://eu.i.posthog.com;OTLP 指标端点美国为 https://us.i.posthog.com/i/v1/metrics,欧洲为 https://eu.i.posthog.com/i/v1/metrics,使用项目 token 作为 Authorization: Bearer 头。代码中引用环境变量,不要硬编码。

限制与原则:最小改动,不改变文件原有架构;写入前先读取文件;仅做有针对性的补充;无 SDK 时才使用 OTLP;需要每用户或每请求细节时应使用日志或追踪,而非指标。参考文件含 javascript、nodejs、python、kubernetes、other 等平台说明。具体收费、价格等信息暂未提供。