用途:该技能用于在 posthog 仓库内,通过内部 Metabase 实例对生产 ClickHouse 集群做即席分析,重点是 system.query_log,适合排查慢查询、物化候选与按团队统计查询开销。预置的现成查询在 query-performance-analysis 仓库中,使用同一套 Metabase API。
环境:美国区 https://metabase.prod-us.posthog.dev,欧盟区 https://metabase.prod-eu.posthog.dev,均位于带 Cognito OAuth 的 AWS ALB 之后,仅 API key 无法认证。美国区暴露一个 ClickHouse 数据库;欧盟区有两个(查询层用于 query_log 分析,数据层用于生产读取),以 metabase:databases 实际输出为准。
用法:数据库 ID 不稳定,须用 hogli metabase:databases --region us(或 eu)动态获取,不得硬编码。用户需自行运行 hogli metabase:login --region us/eu 完成 SSO,cookie 缓存在 ~/.config/posthog/metabase/cookie-{region}。代理侧用 hogli metabase:query --region <region> --database-id <id>,SQL 经 stdin 或 --file 传入,大结果集用 --save <path>,默认 TSV,--format json 返回原始响应体。标准表引用为 clusterAllReplicas(posthog, system, query_log)。
慢查询判定:query_duration_ms > 30000 或 exception_code 为 159/160/241。
限制:Metabase 原生查询默认约 60 秒超时;log_comment 字段会漂移,过滤时需加非空判断;每个区域 cookie 独立,须分别登录;DB ID 错误会非零退出。