用途:减少火山引擎云拨测的运维噪音。当周期性任务的拨测点失败时,判断该失败是目标真实中断还是瞬时抖动,若拨测点自身损坏则给出同类替代节点建议。
主要能力:不自带脚本,纯编排,全部动作调用 byted-util-volcengine-cloud-detect 技能的 volc_detect.py 命令(get-task、get-result、list-nodes、fuzzy-search-nodes、create-task、delete-task)。决策逻辑为:对失败节点在同目标上重试5次(可配置),全部成功判定为 transient_issue 忽略;任一失败则做控制校验,从同一节点拨测可信域名(中国节点用 https://cn.bing.com,海外节点用 https://www.google.com),控制成功为 real_failure 触发告警,控制失败为 node_issue 并建议替换节点。默认仅自动校验 LastMile 拨测点(client_info.type == "1",节点名含(LM)),IDC/Private 需显式要求。临时任务创建后一律用 delete-task 删除。成功判定依据 basic_detail.usability_info.status 是否为 success/fail,无该字段时回退 http_detail.http_code 在 200–499 视为可达。
使用方式:先解析 volc_detect.py 路径(动态 find,不硬编码),需已配置 VOLC_ACCESSKEY 与 VOLC_SECRETKEY。按扫描单个周期任务的流程执行:get-task 确认任务为 Running(status == 2),get-result 拉取最近1小时、PageSize ≤ 500 的结果;按节点分组取最新样本并映射到节点 id;对失败节点 create-task 重试(interval 60s);必要时 create-task 控制校验;最后 fuzzy-search-nodes 找替代节点。替代优先级:同节点类型(LastMile / IDC / Private)强制,优先同省、其次同国家。输出为结构化 JSON,含 alert、real_failures、node_issues、suppressed、inconclusive 等字段;alert 仅在至少一个 real_failure 时为 true。可按小时调度(cron / CI),通知时只将 real_failures 作为告警负载,并附带 node_issues 供运维处理。
限制:依赖基础技能与火山引擎凭据;API 结果范围限制为不超过1小时、PageSize 不超过500;client_info 映射到多个或零个节点时标记 inconclusive,不自动告警;非 LastMile 节点默认跳过。未提供具体价格、收费与更多平台支持信息。