SuperAPI AI 工具集

analytics

数据与分析

查看项目

更新于 10-16 05:47

技能介绍

用途:构建能回答明确产品或运营问题的最小度量系统。适合设计事件埋点、合规追踪、错误与日志监控、存活/就绪健康检查、内部仪表盘和业务报表,也用于审计现有分析实现。除非请求包含迁移,否则保留现有服务商与数据结构。

流程:先检查框架、路由与运行时、部署目标、认证模型、已有分析与监控包、环境变量示例、隐私控制和现有事件调用。明确数据要支持的决策(获客、激活、留存、采用、收入、可靠性或事故响应),并为每个指标记录单位、适用人群与排除项、分子/事件、分母、队列锚点、观察窗口、成熟/删失规则、时区、负责人和决策阈值;同时记录事件名、必需属性、身份规则、留存需求及需排除的敏感字段。

在选择工具前区分四类关注点:流量分析;产品分析与实验;错误、链路与日志;存活、就绪与业务报表。优先复用已安装的服务商;若没有,给出最小技术栈建议并说明取舍。只询问会实质影响实现的未决选择,例如同意要求、数据驻留、服务商偏好,或就绪检查是否应依赖数据库。不要让用户在对话中粘贴密钥;在 .env.example 中搭好名称,由用户在部署环境设置值。

先创建或更新度量计划再添加调用。使用稳定事件名、带类型属性、服务端捕获权威结果,并记录匿名到已认证的身份转换。仅实现选定的路径:改 PostHog 浏览器/服务端设置、身份、页面浏览或事件前先阅读 PostHog;改 Sentry 初始化、边界、日志、回放、追踪或 source map 前先阅读 Sentry;添加存活/就绪路由或可用性监控前先阅读健康端点。内部仪表盘应作为已认证的产品界面实现,而非公开健康端点;使用服务端聚合查询,定义新鲜度与缓存,让每个图块对应其指标契约,强制角色/租户访问,抑制或粗化小的敏感分组,并覆盖加载、空、过期、部分和错误状态;即使同页展示,也应将运营状态与产品指标分开。

隐私控制应在采集前应用:最小化属性,默认排除凭据、支付数据和内容,避免含个人数据的 URL 或查询串,遵守适用的同意/退出规则,审查回放遮罩与日志脱敏。保留密钥与部署边界:公开采集令牌仅在服务商定义为公开时可暴露;source map 令牌、service-role 密钥和个人 API 密钥留在服务端,不入日志和 git。

验证:只验证实际实现的系统。触发已知页面浏览和带类型产品事件,在服务商确认名称/属性准确;测试匿名活动、登录识别、账号切换和登出重置且不错误合并用户;触发受控客户端与服务端错误,记录事件 ID,验证脱敏、环境/发布标签和已解析 source map,然后删除测试路径;独立于依赖测试存活,用强制依赖失败、短超时和预期非 2xx 响应测试就绪;仪表盘测试授权与租户边界,将聚合查询对源夹具核对,验证时区/窗口/成熟度行为,渲染加载、空、过期、部分、错误和已有数据状态;运行项目的 lint/type/test/build 命令,在无服务器或边缘行为重要时于目标运行时测试。需要仪表盘访问或生产凭据的项记为手动设置,不算已验证。

输出应包含:系统现在能回答的问题及事件/监控计划;已实现指标的度量契约;复用、新增或有意省略的服务商;改动的文件与环境变量名;仪表盘路由/组件、聚合查询、访问策略、新鲜度与渲染状态;隐私、同意、身份、采样与留存决策;已执行的验证及事件 ID 或观测响应;仍需的仪表盘、DNS、令牌、告警与生产检查。限制:资料未提供具体服务商版本、价格、平台支持范围或默认采样策略。