用途:在遇到 Hex 持续性故障、准备支持工单或收集证据时,将 Hex API 连接状态、项目列表、运行历史、数据连接健康度与速率限制状态汇总为单一诊断包,用于排查笔记本运行失败、数据连接失效、定时运行失败和 API 认证问题。
主要能力:脚本先检查环境变量 HEX_API_KEY 是否设置,再请求 https://app.hex.tech/api/v1/projects 获取连接状态,拉取项目列表、最近 10 次运行记录(/api/v1/runs?limit=10)及数据连接(/api/v1/connections),并将速率限制响应头写入文件,最后以 tar -czf 打包。另提供一个 async 健康检查函数,输出 API 状态与可访问项目数量。
使用方式:设置 HEX_API_KEY 后运行收集脚本,生成 debug-hex-<时间戳>.tar.gz;解包后查看 summary.txt 的认证与连通性、用 jq 查看项目、运行历史与连接状态。常见问题映射包括:401 需重新生成 API 令牌;运行长时间 pending 需检查算力配额;连接错误需重新认证;定时任务缺失需检查项目是否已发布;429 需减少轮询。
限制:资料强调需具备事件 ID、受限收集窗口、获批的目标位置与沙箱项目;须有脱敏策略,排除 API 令牌、SQL、单元格输出、数据集值、用户身份和连接元数据。只收集状态、延迟区间、运行状态、配置版本、配额头和不可逆的项目/运行关联 ID。脱敏失败、目标未知或命令可能暴露生产输出与凭据时必须停止并升级,不得绕过策略。输出清单需含事件 ID、收集窗口、检查项、关联 ID、聚合指标、配置版本、目标、负责人与保留日期。具体价格、平台支持范围等暂未提供。