用途:对 PostHog 项目中的 Endpoints 做全项目审计,找出可清理项。它只读报告,不修改;逐端点的深入排查应交给 diagnosing-endpoint-performance。
适用场景:用户要求“审计端点/我能清理哪些端点”;接手项目想了解遗留端点;按月或按季定期复查端点膨胀;物化成本超预算、想知道该关停哪些。
主要能力与用法:优先用 execute-sql(HogQL)读系统表。查询 system.data_modeling_endpoints 获取 name、is_active、current_version、derived_from_insight、last_executed_at 等元数据;查询 query_log 获取端点级调用次数、最近调用、时长与读写字节。物化健康用 endpoint-materialization-status(不在系统表中),查看是否可物化、状态、上次运行与错误。逐版本情况用 endpoint-versions,每个版本带自己的 last_executed_at。修改路径为 endpoint-update,可设 is_active: false 或 is_materialized: false,但必须用户确认后再执行。
问题判定:query_log 无记录视为从未调用;最近调用超过30天视为陈旧;is_active = 0 视为已停用;物化状态为 Failed 视为失败;某物化版本 last_executed_at 为 null 或长期陈旧视为未使用物化版本;版本过多算历史噪音,非问题。
工作流:先列端点与元数据;无行则说明项目无端点并停止;再从 query_log 拉取使用情况交叉比对;然后对每个物化端点调用物化状态工具,并用 endpoint-versions 检查未使用版本;最后输出按类别分组、有优先级的报告,并给出下一步建议(取消物化、停用或转交诊断),不要直接动手。
限制:使用量只统计个人 API key 调用,仅从 Playground 或应用内运行的端点会显得未使用;逐版本 last_executed_at 只记录开启追踪后的运行,可能为 null 但仍在用,删除前必须确认。空结果即健康,不要编造问题;无端点时直接说明。停用或取消物化会影响外部 API 消费者,务必先确认。