SuperAPI AI 工具集

alibabacloud-livedebug

测试与质量

查看项目

更新于 10-16 04:59

技能介绍

用途:本技能用于构建和管理阿里云 CMS 上的 Live-Debug ServiceTask 诊断任务,并通过 SLS 查询采集结果,面向运行时诊断场景。它不负责接入 APM/Agent,也不是通用的 CMS 管理技能。

主要能力:支持动态日志、方法快照、动态指标、动态 Span(含 Span 标签)以及 JVM 检查,可禁用/清理探针,也可查询采集结果。

使用前提:需先检查 aliyun CLI 是否存在(which aliyun 或 where aliyun),最低版本要求 3.3.15,比较时按整数逐段比较;版本不满足可运行 aliyun upgrade -y(需先确认 upgrade 子命令存在)。随后检查 cms2 插件与 SLS:运行 aliyun cms2 apm service-task --help 和 aliyun sls --help。若插件缺失,确认其位于 ~/.aliyun/ 且有可执行权限(ls -l ~/.aliyun/aliyuncms2、chmod +x ~/.aliyun/aliyuncms2),仍失败则报告错误。凭证复用 aliyun CLI 凭证系统,可用 --profile 切换。

用法约定:所有 aliyun 命令必须带 --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-livedebug/{session-id}",session-id 为 32 位小写十六进制(openssl rand -hex 16 或 uuidgen | tr -d '-' | tr '[:upper:]' '[:lower:]')。先读项目根目录 .arms-info 获取 workspace、serviceId、regionId、slsProject、targetIp,缺失再询问;先运行子命令 --help 获取完整参数。ServiceTask 建议 -o json,taskConfig 为扁平 JSON,不要包裹成 commands/probes 数组。

安全与限制:删除任务/探针须两阶段执行,先给删除计划再等明确确认;只读操作可直接执行。禁用探针需用 Delete 而非创建 enabled:false 任务。失败时按错误分类处理:限流/服务端错误短暂等待后原样重试最多 3 次;权限错误不重试,给出授权建议并如实报告;参数错误核对后修正重试;区域/不存在错误检查 region 与标识符。重试耗尽后原样报告 code、message、requestId。绝不编造 workspace、serviceId、taskId、任务状态或采集结果。