SuperAPI AI 工具集

exporting-session-recordings

数据与分析

查看项目

更新于 10-16 03:44

技能介绍

用途:把某条会话录制的存储块与 ClickHouse 元数据(events.json、session-replay-events.json)打包成对象存储中的 zip,供离线分析或支持排查使用。该操作仅限员工,经由 Django admin 门户交互认证完成,不会写回录制本身;没有导出 API 或 MCP 工具,导出与下载只在管理后台中进行。

主要能力与用法:需要先确定录制所属团队的 team_id,并按录制所在区域使用 us.posthog.com 或 eu.posthog.com。先用 team_id 生成导出链接以触发导出(表单填写 session_id 与 reason,reason 会进入审计日志):https://<region>.posthog.com/admin/posthog/team/<team_id>/export-replay/。随后用导出历史页查看状态与下载:https://<region>.posthog.com/admin/posthog/team/<team_id>/export-history/;状态为 complete 后可直接下载单个归档:https://<region>.posthog.com/admin/posthog/team/<team_id>/download-export/<export_id>/。小型录制通常数秒到几分钟完成,页面显示 pending / running / complete / failed。下载视图直接从 replay-v2 S3 桶流式返回 export-<session_id>.zip;export_location 只是存储键而非 URL,本地或代理会话没有生产凭证,需由用户在浏览器中从管理页下载。

限制与注意:必须从拥有该录制的团队的管理页导出,否则任务仍显示 complete 但 zip 为空(零块、空 events.json)。超过 7 天的导出会标记 is_expired 且数据可能被清除,应重新导出。旧的失败导出可能长期停留在 running;新导出会把超过约 48 小时仍 pending/running 的记录清理为 failed。多 GB 的大型录制不实用,流程会将每个块经 Redis 做 base64 并零填充到磁盘字节偏移,建议使用数百 MB 量级的录制。reason 会被审计记录并展示给人工审核者。