SuperAPI AI 工具集

instrument-logs

通用与其它

查看项目

更新于 10-16 03:45

技能介绍

用途:该技能用于为新代码或改动代码接入 PostHog 日志采集,确保有意义的日志事件以结构化属性被捕获;若尚未配置 PostHog 日志导出,也涵盖初始 OTLP exporter 设置。支持任意平台或语言。

主要能力:按顺序执行七步流程——分析代码库并检测平台(语言、框架、现有日志方案、依赖与锁文件);查阅对应平台参考文件;安装 OpenTelemetry SDK 与 OTLP exporter 依赖;配置指向 PostHog 摄取端点的 OTLP exporter;与现有日志集成(不替换原有 handler 或输出);添加结构化键值属性;设置环境变量。

支持平台:Next.js、Node.js、Python、Go、Java、Datadog、Android、React Native、iOS、Flutter,以及通过 OpenTelemetry 的任意语言。

使用方式:先检测平台与现有 PostHog 日志导出配置,已配置则跳到第五步。安装依赖须用包管理器命令,不手动编辑依赖文件。PostHog 日志使用 OpenTelemetry 协议,端点按区域为 https://us.i.posthog.com/v1(US)或 https://eu.i.posthog.com/v1(EU)。Android、React Native、iOS 使用 SDK 原生日志 API,而非单独 OTLP exporter。环境变量:项目 token 缺失时可用 PostHog MCP 的 projects-get 工具获取 api_token,多项目需询问用户;区域由 MCP 响应的 region 字段判断,US 对应 https://us.i.posthog.com,EU 对应 https://eu.i.posthog.com,无法确定时须询问用户,不得默认 US Cloud。

限制:不替换或重构现有日志代码,改动须最小且有针对性;写入文件前必须先读取该文件;不得硬编码密钥与端点;优先结构化日志而非纯文本。具体各平台配置细节见对应参考文件。