用途:对 PostHog 数据仓库中的物化视图(物化的已保存查询)做项目级健康审计,回答“哪些视图坏了”“哪些物化视图在浪费算力”,以及 HogQL 或 schema 变更后复核视图健康、物化视图支撑的仪表盘数据陈旧或报错等场景。
主要能力:通过 data-warehouse-data-health-issues-retrieve 一次性拉取整条管线的失败/降级项,筛选 materialized_view 类型;每个条目含 id、name、type、status、error、failed_at、url。触发条件为 DataWarehouseSavedQuery.is_materialized=true 且 status=Failed,紧急度中等。可用 view-list 查看全部已保存查询/物化视图的状态与 latest_error、物化标记和最近查询信息;用 view-run-history 查看某个物化视图的运行轨迹;warehouse-suggestions-list(status=proposed)获取 PostHog 基于读取使用情况生成的 deprecate / materialize / certify 建议。
使用方式:先做一次性拉取,无视图问题即告知健康并结束,不臆造问题;对失败视图做分诊,失败通常是视图自身的 HogQL 或数据问题(语法错误、缺失表引用、类型不匹配),呈现错误并指向问题查询;以人类可读的优先排序报告输出,而非原始 JSON;在用户明确要求更广审计时,先呈现建议,再用 view-list 找出已物化但近期未被查询的清理候选;结尾给出明确的后续交接,如“要我打开某个视图修复 HogQL 吗”。
限制:审计为只读,未经用户明确确认不得调用破坏性工具(如 view-unmaterialize、view-delete)。data-health 端点只报告活跃失败,不报告非物化视图的错误,也不报告健康但未被使用的物化视图;后者需借助建议或 view-list 额外检查。错误以 Not published: 开头时不是查询问题,而是数据质量检查失败导致刷新被拦截,应移交 debugging-failed-data-quality-checks。source/external_data_sync 属于 auditing-warehouse-source-health;destination(批导出)与 transformation(HogFunction)归其他产品,发现时应转交而非在此诊断。仓库建议为空时可用 warehouse-suggestions-status 判断是仍在计算、不符合条件还是已关闭。具体命令与更多细节暂未提供。