用途：为新增或修改的代码添加 PostHog 指标采集（计数器、仪表、直方图），在实现功能或审查 PR 后确保关键操作被度量，也可用于把已有指标镜像到 PostHog。支持任意平台或语言。
支持平台：Web（JavaScript）、Node.js、Python（posthog.metrics SDK API）、Kubernetes（metrics agent），以及通过 OpenTelemetry（OTLP）的任意语言。
使用方式按顺序执行：一、分析代码库并识别平台，检查依赖文件与现有指标（Prometheus、StatsD/Datadog、OpenTelemetry）及是否已装 PostHog SDK。二、选择采集路径：已装 PostHog SDK 则用 posthog.metrics API；已有 OTel 指标导出则把 OTLP 导出器或 Collector 指向 PostHog；否则用通用 OpenTelemetry 方案。三、在已有指标旁并列添加 PostHog 调用，复用相同指标名与属性，不删除或重构原有埋点，改动保持最小。四、在合适位置新增指标：统计关键流程成功与失败、用直方图计时外部调用与任务、用仪表记录队列深度与连接池大小；计数器用于只增的值，仪表用于可增可减的值，直方图用于时长等分布并显式设置单位（ms、bytes）；使用稳定、描述性、点分隔的名称（如 jobs.processed、api.request.duration）并设置服务名。五、保持低基数：route、status、plan、queue 等有界属性可用，用户 ID、会话 ID、请求 ID、时间戳不可用；需要按用户或按请求的细节应使用 PostHog 日志或追踪。六、配置环境变量：若 SDK 已配置可跳过；缺少项目 token 时可通过 PostHog MCP 的 projects-get 获取，多项目时询问用户；host 按 region 映射 US 为 https://us.i.posthog.com、EU 为 https://eu.i.posthog.com，不确定时询问用户，不要默认 US；OTLP 指标端点为 https://us.i.posthog.com/i/v1/metrics 或 https://eu.i.posthog.com/i/v1/metrics，以项目 token 作为 Authorization: Bearer 头；写入对应 env 文件并在代码中引用，不要硬编码。七、验证指标到达：短生命周期进程退出前 flush（posthog.metrics.flush() 或 OTel 的 forceFlush()/shutdown()），在 PostHog 侧边栏 Metrics 中按名称选择，数据点应在一分钟内出现。
参考文件涵盖 JavaScript、Node.js、Python、Kubernetes、其他语言及入门、基础、架构与框架规则。
限制：需按平台参考文件完成具体 SDK 与 OTLP 配置；未提供具体代码示例、收费与价格信息。