用途:回答“我的数据是否正常流动?”,通过一次运行聚合流(streams)、作业(jobs)、模式(schema)和事件配额(event quota)四类健康信号,输出统一且可执行的报告。全程只读,需要已认证的 API 访问,凭据解析见 ../references/auth.md。
主要能力:检查流健康,依据 last_msg_ts 判断活跃、陈旧或死亡,并区分批处理与连续流;检查作业健康,识别 runnable、sleeping、paused、fault、failed、killed 等状态,对故障作业拉取日志,并检测超过 1 小时未更新的疑似卡住作业;检查模式健康,统计标识字段、PII 字段、陈旧字段及低覆盖率字段;检查事件配额,对照 50%、75%、100%、125% 阈值报告用量。可选指标深挖,按 stream、works、segment 维度查看 24 小时趋势。
使用方式:依次执行四类检查的 curl 命令,命令使用 ${LYTICS_API_URL:-https://api.lytics.io} 与 ${LYTICS_API_TOKEN} 环境变量,例如流检查 curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/stream" -H "Authorization: ${LYTICS_API_TOKEN}";作业检查 curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/job" -H "Authorization: ${LYTICS_API_TOKEN}";模式检查 curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/schema/user/field" -H "Authorization: ${LYTICS_API_TOKEN}";配额检查 curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/control/eventquota/thresholds" -H "Authorization: ${LYTICS_API_TOKEN}"。随后按固定格式输出报告,包含总体状态、各维度明细与建议。
适用场景:日常数据管道巡检、故障排查、配额预警、模式字段治理。
限制:仅只读,不修改任何配置;依赖已认证 API 访问;单个检查失败时报告该维度错误并继续其余检查,超时则跳过并注明;空响应会提示未找到对应资源,可能表示新账户或未配置账户。该技能组合了 stream-inspector、job-manager、schema-manager 技能。