query-examples

在 PostHog 中查询数据

如果 MCP 服务未提供在 PostHog 中查询数据的说明，请阅读指南。

数据架构

PostHog 核心系统模型的架构参考，按领域整理：

• 活动日志
• 操作
• 提醒
• 注释
• 批量导出
• 抢先体验功能
• 群组与用户
• 仪表板、磁贴与洞察
• 数据仓库
• 数据建模端点
• 错误跟踪
• 标记与实验
• Hog 流程
• Hog 函数
• 集成
• 日志
• 笔记本
• 会话录制播放列表
• 会话录制
• 支持工单
• 问卷
• SQL 变量
• read-data-schema 工具中跳过的事件
• 动态用户和事件属性 — 类似 $survey_dismissed/{id}、$feature/{key} 的模式不会出现在工具结果中

HogQL 参考

• 用户属性模式（事件时间与查询时间）。使用 person.properties.* 时请阅读，以了解值是历史值还是当前值。
• 迷你图、SemVer、会话回放、操作、翻译、HTML 标签与链接、文本效果等
• SQL 变量。
• HogQL 中可用的函数。重要：列表很长，因此请使用 grep 等 bash 命令读取数据。

分析查询示例

使用以下示例创建经过优化的分析查询。

• 趋势（独立用户、特定时间范围、单个系列）
• 趋势（总计数，包含多个细分维度）
• 漏斗（两个步骤，按独立用户聚合，按用户角色细分，顺序执行，14 天转化窗口）
• 转化趋势（漏斗、两个步骤，按独立群组聚合，1 天转化窗口）
• 留存（独立用户，在接下来的 12 周内返回并执行某个事件，重复留存）
• 用户路径（页面浏览量、三个步骤，应用路径清理和筛选条件，最多 50 条路径）
• 生命周期（按页面浏览量统计独立用户）
• 黏性（按独立用户的页面浏览量计数，以时间间隔内至少发生一个事件为判定标准，非累计）
• LLM 跟踪记录（生成、跨度、嵌入、人工反馈、捕获的 AI 指标）
• LLM 跟踪记录列表（通过属性筛选条件搜索和列出跟踪记录，分两阶段查询）
• 网页路径统计（路径、访客、浏览量、跳出率）
• 网站流量渠道（直接流量、自然搜索等）
• 按设备类型统计网页浏览量
• 网站概览
• 错误跟踪（在错误中搜索某个值，并按自定义属性筛选）
• 日志（按严重程度筛选并搜索关键词）
• 会话（列出会话的时长、页面浏览量和跳出率）
• 会话回放（列出符合活动筛选条件的录制内容）
• 团队分类（按计数排列的热门事件，支持分页）
• 事件分类（事件的属性及示例值）
• 用户属性分类（用户属性的示例值）