跳到主要内容

aCLI排障

欢迎使用aCLI排障服务命令行工具​

欢迎使用aCLI排障服务命令行工具，aCLI（Admin CLI）是专为HCI平台设计的命令行排障工具，旨在为技术支持和运维人员提供便捷、高效的系统诊断和问题解决手段。aCLI通过封装复杂的底层操作，提供标准化的命令接口，使排障工作更加规范和高效。

support/host-005056b237a6(acli) ~ # acli --help
用法：acli [参数] {命名空间} + {命令} [命令参数]

参数：
  --help, -?           展示工具用法
  --version            展示版本信息
  --debug              打开debug级别日志
  --cluster            用于遍历集群主机执行acli命令
  --timeout            用于设置命令的超时时间（秒）
  --force              强制模式：忽略交互确认，直接执行操作（使用前请确认风险）
  --formatter          用于命令的格式化参数。枚举值：xml、csv、keyvalue、json
  --container          用于命令的全局容器指定参数，仅对system下的命令生效。枚举值：asv-con、vn-con、vn-agent、vs-cp-manager

可用命名空间：
  acli                 acli说明，允许用户获取附加信息
  alert                告警相关命令
  task                 任务相关命令
  log                  平台日志相关命令
  service              服务相关命令
  vm                   虚拟机相关命令
  system               系统相关命令
  network              网络相关命令
  storage              存储相关命令
  platform             平台相关命令
  hardware             硬件相关命令

技术支持说明：如在使用过程中遇到问题，请联系深信服技术支持团队获取专业协助。

下载与安装​

使用提醒

当前aCLI排障服务命令行工具处于preview试点阶段，请谨慎使用。 请勿随意使用变更命令修改系统环境与配置，否则可能造成不可预知的后果。

下载​

请根据您的 HCI 版本架构选择对应的安装器进行安装，通常情况下，使用Intel、AMD等品牌处理器的系统请选择 x86/64 版本下载，使用海光、飞腾、鲲鹏、兆芯等品牌处理器的请选择 arm/aarch64 版本下载。

下载 x86/64 版本

下载 arm/aarch64 版本

安装​

安装提醒

安装前，请先检查 /sf/data/local 分区可用容量是否大于 1GB ，否则可能安装失败。

  1. 上传安装包

    将下载的安装包上传至 HCI 环境的 /sf/data/local/ 目录

  2. 添加执行权限

    chmod +x acli-installer_x86_64_YYYY-MM-DD_HH-mm-ss.acli

  3. 执行安装

    ./acli-installer_x86_64_YYYY-MM-DD_HH-mm-ss.acli --install

  4. 启用自动补全

    source ~/.profile

  5. 验证安装

    acli --version

使用说明​

命令说明​

  1. 命令格式

    acli   [options]     {namespace}+      {cmd}+      [cmd options]+
     |         |              |              |              |
    主程序 全局参数（可选） 命名空间（多个） 参数（多个）  参数选项（多个）
    展开查看-示例：查询 'HA' 字样操作日志
    support/host-005056b237a6(acli) ~ # acli task get -k HA -l 1
[0]:
action_type: 10
bcancel: 0
description: 虚拟机运行异常，HA尝试恢复运行此虚拟机（vm1）。
dest_host:
end: 2026-05-14 07:31:33
errcode_tracing: null
event_id: 53084160
ha_handle_action: 重启切换
ha_handle_result: 快速重启虚拟机恢复
host: 10.131.136.168
hostid: host-0050568efada
hostname: 10.131.136.168
id: 37
log_id: host-0050568efada:154641:1778715066:778694482582
module_type: 50
object_id:
object_name: vm1
object_type: 虚拟机
otype: 虚拟机
process: 完成
request_id: ,a0509b4bdd3e479dd473c91cf3c92142
reserved2:
reserved3:
risk_level: 10
sched_effect:
sched_reason:
start: 2026-05-14 07:31:04
status: 2
sysloged: 0
target: vm1
type: HA恢复虚拟机
upid:
user: admin (x.x.x.x)
vm: 1055878891514

  2. 命名空间

    acli的命令空间一般按照业务或操作对象进行严格划分，按照层级深入，直到最小操作单元。

    例如查看FC存储的相关统计信息：

    acli storage fc host statistics get

    例如上述命令则是按照 存储 - 存储类型 - 对象 - 事件/子对象 - 操作 进行严格编排得出。

  3. 外置插件

    support/host-005056b237a6(acli) ~ # acli
    用法：acli [参数] {命名空间}+ {命令} [命令参数]

    参数：
      --help, -?           展示工具用法
      --version            展示版本信息
      --debug              打开debug级别日志
      --cluster            用于遍历集群主机执行acli命令
      --timeout            用于设置命令的超时时间（秒）
      --force              强制模式：忽略交互确认，直接执行操作（使用前请确认风险）
      --formatter          用于命令的格式化参数。枚举值：xml、csv、keyvalue、json
      --container          用于命令的全局容器指定参数，仅对system下的命令生效。枚举值：asv-con、vn-con、vn-agent、vs-cp-manager

    可用插件：
      asan_ops             虚拟存储异常场景排障工具
      asys                 系统检查工具
      log_collect          日志收集
      netdoctor            网络异常场景排障
      performance_tools    性能场景排障工具
      vm_start             虚拟机开关机场景排障
      vm_suspend           虚拟机异常挂起场景排障
    ......

    acli支持安装与卸载各类官方或第三方开源插件，目前preview版本预装了部分插件用以体验，后续将会上新更多的插件以供自由选择安装。

参数说明​

  1. 全局参数

    在acli命令体系中，将能够作用于任何命令的参数称之为全局参数。

    使用 acli --help 查看当前支持的所有全局参数

    support/host-005056b237a6(acli) ~ # acli
    用法：acli [参数] {命名空间} + {命令} [命令参数]

    参数：
      --help, -?           展示工具用法
      --version            展示版本信息
      --debug              打开debug级别日志
      --cluster            用于遍历集群主机执行acli命令
      --timeout            用于设置命令的超时时间（秒）
      --force              强制模式：忽略交互确认，直接执行操作（使用前请确认风险）
      --formatter          用于命令的格式化参数。枚举值：xml、csv、keyvalue、json
      --container          用于命令的全局容器指定参数，仅对system下的命令生效。枚举值：asv-con、vn-con、vn-agent、vs-cp-manager
    ......

    通过灵活使用全局参数，实现对命令的精细化控制与强大执行能力。

    例如：acli命令默认在主控节点执行，但可以通过全局参数等方式实现集群执行。

  2. 命令参数

    绝大多数命令需要输入参数进行控制执行逻辑，命令本身的参数被称之为命令参数。

    在有命令参数的命令后面使用 --help 或 直接回车 即可以看到其命令参数，例如：acli alert get --help

    support/host-005056b237a6(acli) ~ # acli alert get --help
    用法：acli alert get [命令参数]

    描述：
      get                                 查询告警信息

    命令参数：
      -k|--keyword=string                 搜索告警对象、事件和描述，示例：虚拟机异常挂起
      -e|--event=string                   指定事件，示例：免key序列号异常
      -o|--object-name=string             指定告警对象，示例：10.134.244.34
      -T|--object-type=string             指定告警对象类型，枚举值：host(主机),storage_obj(存储),vm(虚拟机),vnet(虚拟网络),sn(序列号),others(其他)
      -t|--time=string                    指定时间，格式：'YYYY-MM-DD HH:MM:SS'、'YYYY-MM-DD HH'
      -L|--level=integer                  指定级别，枚举值：1（紧急），0（普通）
      -l|--limit=integer                  指定展示记录的数目（默认值为50），示例：1，2等

使用案例​

故障诊断​

acli命令通过组合可以实现多种故障诊断功能，当然更推荐你使用外置插件进行一键诊断。

例如：使用插件 performance_tools 进行虚拟机性能异常场景排障（以下仅为示例，具体使用方式请参考插件文档）

展开查看
  support/host-005056b237a6(acli) ~ # acli performance_tools check_host
  欢迎使用虚拟机检测工具！当前时间 2026-05-14 11:45:44
  正在进行主机检测...
  主机名: host-0050568efada
  CPU型号: Intel(R) Xeon(R) Gold 5220R CPU @ 2.20GHz
  CPU核心数: 8
  CPU使用率: 41.53 %
  主机总内存大小: 33.28 GB
  主机剩余内存大小 17.47 GB
  运行虚拟机数量: 1
  集群类型: HCI
  -----------------------------------------------------------------------------------------------------------------------------------

  一、检查主机CPU信息
  1.1 CPU超线程 √
  详细信息: 物理主机未开启CPU超线程

  1.2 CPU sys使用率 ×
  告警等级:中
  详细信息:物理主机的CPU sys使用率为21.84%，检测阈值为15.00%
  建议: 如果物理主机的CPU sys使用率比较高，请检查是否存在进程异常占用，是否存在内存降频，时钟源不正确等问题，参考 https://support.sangfor.com.cn/cases/list?product_id=26&type=1&category_id=30186 、https://support.sangfor.com.cn//cases/list?product_id=26&category_id=29936&type=2 若KB无法解决，请联系 云BG中台技术支持

  1.3 非转发核单核CPU使用率 √
  详细信息: 非转发核单核CPU使用率最高为50.00%，检测阈值为95.00%

  1.4 SPDK 转发核占用情况 √
  详细信息: SPDK 转发核核使用率为0.00%，检测阈值为90.00%

  1.5 CPU超配比检测 √
  详细信息: 主机CPU超配比为112.50%，检测阈值为200.00%
  主机当时运行虚拟机列表如下：
  VMID                 CPU        MEM        %CPU_UTIL  MEM_USED        VmName
  1055878891514        1          1.00GB     9.80       429.07MB        vm1


  1.6 检查主机非独占CPU使用率 √
  详细信息: 环境上无独占虚拟机，无需检测

  1.7 CPU降频检查 √
  详细信息: 无法获取当前环境睿频信息

  1.8 CPU使用率 √
  详细信息: 物理主机的CPU使用率为41.53%，检测阈值为65.00%
  当时CPU占用最高的10个进程为：
  PID        %CPU  MEM      STAT  START    TIME     COMMAND
  39966      65.2  1.29GB   S<Ll  07:24    170:27   /sf/sdn/bin/dataplane --proc-type secondary -l 1,2...
  192868     9.8   429.07MB Sl    07:31    25:09    /usr/bin/kvm -id 1055878891514 -chardev socket,id=...
  40028      8.1   11.57MB  S     07:24    21:10    /sf/sdn/bin/dhcp6d
  114421     7.2   132.99MB R     07:28    18:36    WSGI
  49570      5.4   27.88MB  S<l   07:24    14:18    -w
  39573      4.0   20.85MB  S<Ll  07:24    10:38    /sf/sdn/bin/dpp -l 0 --proc-type primary --iova-mo...
  2409188    3.8   17.50MB  Sl+   11:45    0:00     /sf/data/local/acli/plugins/performance_tools/plug...
  5964       3.3   29.57MB  Ssl   07:21    8:51     /usr/local/sf/container/bin/containerd-squashfs-gr...
  187083     2.9   529.37MB S     07:31    7:30     vtpalertd
  10153      2.4   106.45MB Ssl   07:22    6:32     /usr/local/sf/container/bin/kubelet --config /sf/e...


  1.9 CPU主频检测 √
  详细信息: CPU主频为2.2GHz，检测阈值为2.4GHz

  1.10 CPU时钟源检测 √
  详细信息: CPU时钟源为tsc，X86和C86架构检测时钟源需要是tsc

  1.11 主机CPU iowait检测 √
  详细信息: 主机CPU iowait占用率为0.00%，检测阈值为10.00%

  1.12 检查主机SMI中断 √
  详细信息: 主机CPU不存在SMI中断

  -----------------------------------------------------------------------------------------------------------------------------------

  二、检查主机内存信息
  2.1 Slab内存泄漏检测 √
  详细信息: SReclaim内存占用为948.86MB，检测阈值为10.00GB

  2.2 内存插法检测 √
  详细信息: 内存条数3，内存通道数14，未插内存通道：RAM slot #1、RAM slot #2、RAM slot #6、NVD #2、NVD #、RAM slot #3、NVD #1、NVD #6、RAM slot #5、NVD #4、NVD #5、RAM slot #4、NVD #3

  2.3 可用内存大小检测 √
  详细信息: 物理主机的可用内存为17.47GB，占总内存比值为52.50%，检测阈值为剩余不足10GB或可用内存比值不足10.00%
  当时内存占用最高（不包含大页内存）的10个进程为：
  PID        %CPU  MEM      STAT  START    TIME     COMMAND
  39966      65.2  1.29GB   S<Ll  07:24    170:28   /sf/sdn/bin/dataplane --proc-type secondary -l 1,2...
  187083     2.9   529.37MB S     07:31    7:30     vtpalertd
  203202     0.6   528.68MB S     07:32    1:38     vtpcron
  203132     0.6   528.57MB S     07:32    1:40     vtpcron
  203232     0.6   528.45MB S     07:32    1:40     vtpcron
  203172     0.6   528.42MB S     07:32    1:37     vtpcron
  203154     0.6   528.27MB S     07:32    1:37     vtpcron
  1830632    1.4   528.06MB S     10:39    0:59     vtpdaemon
  202311     0.9   527.59MB S     07:31    2:28     vtphwinfod
  204819     0.0   525.68MB Ss    07:32    0:04     backup_clean_schedule


  2.4 内存频率一致 √
  详细信息: 内存条频率一致

  2.5 内存条运行频率和物理频率一致 √
  详细信息: 内存条运行频率和物理频率一致

  2.6 内存降频检测 √
  详细信息: 不存在内存降频

  2.7 内存ECC错误检测 √
  详细信息: 无法获取IPMI日志

  2.8 Swap使用情况 √
  详细信息: Swap内存占用大小为0.00B，检测阈值为0.00GB

  2.9 配置内存占用情况 √
  详细信息: 实际总的配置内存为6.00GB，剩余配置内存为17.00GB，配置内存占用率为35.29%，检测阈值为配置内存占用率超过90.00%

  2.10 Percpu内存泄漏检测 √
  详细信息: Percpu内存占用为265.50MB，检测阈值为10.00GB

  2.11 NUMA节点内存均衡检测 √
  详细信息: 系统只有一个NUMA节点，无需检查内存均衡性

  -----------------------------------------------------------------------------------------------------------------------------------

  三、检查主机磁盘信息
  3.1 磁盘延迟检测 √
  详细信息: 不存在时延超过阈值的磁盘，检测阈值SSD磁盘或外置存储磁盘10ms，HDD磁盘50ms
  当时的磁盘时延为：

  Device:         rrqm/s   wrqm/s     r/s     w/s    rkB/s    wkB/s avgrq-sz avgqu-sz   await r_await w_await  svctm  %util
  sdc               0.00     4.00    0.00    6.00     0.00    40.00    13.33     0.01    0.67    0.00    0.67   1.33   0.80
  sda               0.00     0.00    0.00    0.00     0.00     0.00     0.00     0.00    0.00    0.00    0.00   0.00   0.00
  sdb               0.00     0.00    0.00    0.00     0.00     0.00     0.00     0.00    0.00    0.00    0.00   0.00   0.00
  sdd               0.00     0.00    0.00    0.00     0.00     0.00     0.00     0.00    0.00    0.00    0.00   0.00   0.00


  3.2 VS卡慢盘日志检测 √
  详细信息: 不存在VS卡慢盘日志

  3.3 内核卡慢盘日志检测 √
  详细信息: 不存在内核卡慢盘日志

  -----------------------------------------------------------------------------------------------------------------------------------

  四、检查主机网络信息
  4.1 聚合网口工作方式 √
  详细信息: 聚合网口工作方式正常

  4.2 网络转发核占用情况 √
  详细信息: 网络转发核使用率为3.00%，检测阈值为90.00%

  4.3 网络流量展示 √
  详细信息: 当时的网卡流量如下：
  11:46:18 AM     IFACE   rxpck/s   txpck/s    rxkB/s    txkB/s   rxcmp/s   txcmp/s  rxmcst/s
  11:46:19 AM      eth0   3624.00     95.00    664.13      5.36      0.00      0.00   1203.00
  11:46:19 AM    p_eth1   3622.00      0.00    664.05      0.00      0.00      0.00   1203.00
  11:46:19 AM      eth2   3622.00      0.00    664.05      0.00      0.00      0.00   1203.00
  11:46:19 AM      eth3   3622.00      0.00    664.05      0.00      0.00      0.00   1203.00
  11:46:19 AM      eth4   3622.00      0.00    664.05      0.00      0.00      0.00   1203.00
  11:46:19 AM      eth5   3622.00      0.00    664.05      0.00      0.00      0.00   1203.00
  11:46:19 AM      eth1   3622.00      0.00    659.99      0.00      0.00      0.00      0.00


  4.4 VXLAN网口开启高性能模式检测 √
  详细信息: VXLAN网口开启高性能模式

  4.5 网卡丢包 √
  详细信息: 网卡不存在丢包

  4.6 网卡缓冲区溢出 √
  详细信息: 网卡不存在缓冲区溢出

  4.7 网口带宽检测 √
  详细信息: 存储网口带宽为0mbps，检测阈值1,000mbps，终端通信口eth0带宽为10,000mbps，检测阈值1,000mbps
  网卡协商信息：
  ----------------------------------------
  网卡: eth0            速度: 10,000 Mbps  模式: 全双工      (角色: tercom,mgmt)
  网卡: eth1            速度: 10,000 Mbps  模式: 全双工      (角色: vxlan)
  网卡: eth2            速度: 10,000 Mbps  模式: 全双工
  网卡: eth3            速度: 10,000 Mbps  模式: 全双工
  网卡: eth4            速度: 10,000 Mbps  模式: 全双工
  网卡: eth5            速度: 10,000 Mbps  模式: 全双工
  ----------------------------------------


  4.8 网络转发核独占检测 ×
  告警等级:中
  详细信息:网络转发核独占情况：未独占
  建议: 网络转发核独占性能较高，如果网络转发性能存在瓶颈或需要达到更高的网络转发性能，请在主机详情页启用网络转发核独占。 若KB无法解决，请联系 VN技术支持

  4.9 网卡中断核与网络转发核冲突检测 √
  详细信息: 不存在中断核与网络转发核冲突的网卡

  4.10 接管通用模式网卡开启LRO检测 √
  详细信息: 未检测到被接管通用模式开启LRO的网卡

  4.11 VXLAN、业务网口使用DPDK模式检测 √
  详细信息: 未使用DPDK模式的VXLAN、业务口：eth1

  -----------------------------------------------------------------------------------------------------------------------------------

  五、检查主机其他检测项
  5.1 D状态和Z状态进程检测 √
  详细信息: 未发现异常的D状态和Z状态进程

  5.2 VS缓存比检测 √
  详细信息: VS存储卷的缓存比为：不存在虚拟存储混闪卷，检测阈值10.00%

  5.3 内核异常日志检测 ×
  告警等级:中
  详细信息:内核存在以下异常日志：
  /sf/log/today/kernel.log
  2026-05-14 07:22:59.869618 err [kernel:] [    6.013761] integrity: Unable to open file: /etc/keys/x509_ima.der (-2)
  2026-05-14 07:22:59.869618 err [kernel:] [    6.013777] integrity: Unable to open file: /etc/keys/x509_evm.der (-2)
  2026-05-14 07:22:59.869765 err [kernel:] [    7.676099] piix4_smbus 0000:00:07.3: SMBus Host Controller not enabled!
  2026-05-14 07:22:59.871039 err [kernel:] [   39.628481] kvm_amd: CPU 3 isn't AMD or Hygon
  建议: 该检测项检测内核日志中emerg、alert、crit、err等级的日志，可以初步观察是否存在明显的异常，大部分情况下不需要处理。

  5.4 CMCI风暴日志检测 √
  详细信息: 不存在CMCI风暴日志

  5.5 API接口超时检测 √
  详细信息: API接口正常

  -----------------------------------------------------------------------------------------------------------------------------------

  六、检查虚拟存储检测项
  6.1 VS网口最近一天历史时延检测 √
  详细信息: 最近一天无高时延和丢包情况

  6.2 VS网口Down检测 √
  详细信息: 无网口Down情况

  6.3 VS网口中断核使用率检测 √
  详细信息: VS网口中断核最近一天使用率正常

  6.4 VS分层缓存击穿检测 √
  详细信息: 未出现缓存击穿日志

  6.5 VMP VS数据盘剩余空间检测 √
  详细信息: 不存在分片剩余空间不足问题

  6.6 VS客户端、服务端、分层时延检测 √
  详细信息: VS无时延高日志

  6.7 VS网口时延检测 √
  详细信息: VS存储网口时延情况：


  -----------------------------------------------------------------------------------------------------------------------------------

  主机检测异常项总结 （请优先关注告警等级为高的告警项）
  1. CPU sys使用率 ×
  告警等级:中
  详细信息:物理主机的CPU sys使用率为21.84%，检测阈值为15.00%
  建议: 如果物理主机的CPU sys使用率比较高，请检查是否存在进程异常占用，是否存在内存降频，时钟源不正确等问题，参考 https://support.sangfor.com.cn/cases/list?product_id=26&type=1&category_id=30186 、https://support.sangfor.com.cn//cases/list?product_id=26&category_id=29936&type=2 若KB无法解决，请联系 云BG中台技术支持

  2. 网络转发核独占检测 ×
  告警等级:中
  详细信息:网络转发核独占情况：未独占
  建议: 网络转发核独占性能较高，如果网络转发性能存在瓶颈或需要达到更高的网络转发性能，请在主机详情页启用网络转发核独占。 若KB无法解决，请联系 VN技术支持

  3. 内核异常日志检测 ×
  告警等级:中
  详细信息:内核存在以下异常日志：
  /sf/log/today/kernel.log
  2026-05-14 07:22:59.869618 err [kernel:] [    6.013761] integrity: Unable to open file: /etc/keys/x509_ima.der (-2)
  2026-05-14 07:22:59.869618 err [kernel:] [    6.013777] integrity: Unable to open file: /etc/keys/x509_evm.der (-2)
  2026-05-14 07:22:59.869765 err [kernel:] [    7.676099] piix4_smbus 0000:00:07.3: SMBus Host Controller not enabled!
  2026-05-14 07:22:59.871039 err [kernel:] [   39.628481] kvm_amd: CPU 3 isn't AMD or Hygon
  建议: 该检测项检测内核日志中emerg、alert、crit、err等级的日志，可以初步观察是否存在明显的异常，大部分情况下不需要处理。

  检测完成！结果已输出至文件 /sf/data/local/performance_tools/check_result/output.txt。
  HTML结果已输出至文件 /sf/data/local/performance_tools/check_result/checkhost_output.html。

使用排障插件，你可以轻松获得某个场景的检查结果以及排障指导。

日志收集​

acli工具提供强大的日志收集能力，能够收集 HCI 上任意日志并使用高效的压缩算法进行压缩。

展开查看
support/host-0050568eb9d8(acli) ~/tmp # acli log_collect --help
用法：acli log_collect  {命令} [命令参数]

可用命令：
  cancel               取消日志收集任务
  create               创建日志收集任务
  progress             查询日志收集任务

使用 "acli log_collect <命令> -h" 查看具体命令的帮助信息


support/host-0050568eb9d8(acli) ~/tmp # acli log_collect create --help
用法：acli log_collect create [命令参数]

描述：
  create                              创建日志收集任务

命令参数：
  -s|--save-filename=string          必要参数，收集文件命名（无需文件后缀），使用icare单号，示例：Q2025052718316
  -m|--modules=string                日志收集专项，使用英文逗号拼接指定的专项，示例：vm_suspend,network
                                     可供选择的专项，不设置则默认other，枚举值：
                                        vm_suspend（虚拟机挂起专项）    vm_start（虚拟机开机失败专项）
                                        host_offline（主机离线专项）     network（网络专项）
                                        storage（虚拟存储专项）          slowdisk（卡慢盘专项，单天收集时间约4min）
                                        performance（性能专项）            system（中台专项）
                                        other（默认收集专项，不收集上述n个场景日志）
  -d|--date-range=string             指定日期范围（使用英文逗号拼接起始日期，示例：2025-06-25,2025-06-27）指定某个日期（举例：2025-06-25），不设置则默认今天
  -i|--ips=string                    指定主机ip，使用英文逗号拼接指定的ip，举例：1.1.1.1,1.2.3.4，不设置则默认收集当前主机日志，设置all表示收集所有主机
  -p|--paths=string                  指定收集额外的目录或者文件，最终压缩成extra_tar.tar.gz压缩包，可以使用英文逗号拼接多个路径，比如：/sf/data/local/you,/sf/ls.txt
  -c|--config=string                 JSON配置文件路径，用于使用配置文件更高级的控制日志收集，举例：--config /sf/data/local/config.json
  -u|--remote-url=string             远程目标地址（使用前请检查网络连通性），示例：http://acli.sangfor.com.cn:5888/
  -H|--header=string                 HTTP请求头，对全局有效，格式：Header-Name: value
  -L|--url-header=string             URL特定请求头，优先级大于--header，格式：index:Header-Name:value，注意：index从0开始
  -U|--auth-username=string          认证用户名，注意：如果有多个目标地址请先将具有auth-username的地址先进行配置
  -P|--auth-password=string          认证密码，注意：必须和auth-username同时出现，如果有多个目标地址请先将具有auth-password的地址先进行配置
  -v|--vm-ids=string                 指定虚拟机id，使用英文逗号拼接指定的vmid

                                    说明：
                                    -s 为必要参数；后接ICare单号
                                    建议先探测hci是否可以ping通过日志服务地址;若可访问建议使用 -u 参数收集完可直接上传
                                    可选节点：
                                    国内节点：acli.sangfor.com.cn
                                    马来节点：acli.sea.sangfor.com
                                    德国节点：acli.eu.sangfor.com

                                    示例1：收集网络专项，1.1.1.1主机，2025-06-25,2025-06-28时间段日志
                                    acli log_collect create -s Q2025052777777 -m network -i 1.1.1.1 -d 2025-06-25,2025-06-28

                                    示例2：通过ping发现HCI可以ping通过acli.sangfor.com.cn；收集虚拟机挂起专项，所有主机今天的日志并在收集完成后自动上传至日志服务器
                                    acli log_collect create -s Q2025062888888 -m vm_suspend -i all -u http://acli.sangfor.com.cn:5888/

                                    示例3：未指定专项，收集所有主机当前日期的other日志（other为默认收集专项，不收集当前所有已提供场景的相关日志）
                                    acli log_collect create -s Q2025072999999 -i all

你可以使用 acli log_collect create 命令创建日志收集任务，并指定收集专项、主机、时间范围等参数，并可以轻松获得日志文件列表。

support/host-005056b237a6(acli) ~ # acli log_collect create -s Q202511111200 -m vm_suspend -i all
日志收集任务下发成功！

support/host-005056b237a6(acli) ~ # acli log_collect progress
状态：收集任务已完成！
压缩包路径（完成日志下载后请手动删除压缩包）：/sf/data/local/acli/tmp/data/log_collect/Q202511111200.zip
总进度：100% - 1/1（已收集完成/收集总数）
总耗时：00:04:03.0
10.131.136.168  收集完成  100%
日志收集记录：
  IP：10.131.136.168
    x /sf/log/14.tar.gz
    x /sf/log/14.tar.zst
    x /sf/log/14.zst
    √ /sf/log/14/
    x /sf/log/blackbox/20260514.tar.gz
    x /sf/log/blackbox/20260514.zst
    √ /sf/log/blackbox/20260514/
    x /sf/log/vn-blackbox/20260514.tar.gz
    x /sf/log/vn-blackbox/20260514.zst
    √ /sf/log/vn-blackbox/20260514/
    x /boot/boot/log/install.log
    √ /boot/firmware/current/package/meta-inf/kernel_version
    √ /boot/firmware/current/package/meta-inf/version
    √ /boot/firmware/history
    x /boot/firmware/nvidia-vgpu-mgr/sgax-install.md5sum
    √ /cfs/
    √ /etc/hosts
    √ /sf/cfg/
    √ /sf/data/local/dump/
    x /sf/data/local/kdump/*.kernel_core
    x /sf/data/local/sgax/md5file
    √ /sf/etc/

日志默认存放目录为：/sf/data/local/acli/tmp，同时深信服技术支持提供了统一的 日志上传平台 进行日志管理分析。

你可以随时上传并于 CTI 或 官方技术支持取得联系，以寻求最佳问题解决方式。

运维监控​

通过组合acli命令，设置定时或者阈值，则可以实现自动化与高级排障检查等能力。后续官方会将支持自由编排acli命令的开发框架与SDK包进行开源，届时，所有开发者与客户都可以根据自身的需求进行客制化开发。

技术特点​

  • ✅ 集群支持：主机级和集群级操作
  • ✅ 异步处理：长时间运行的任务支持后台执行
  • ✅ 安全可控：专用排障环境，命令执行可审计
  • ✅ 生态完善：丰富的社区文档和持续维护
  • ✅ 体验优化：智能补全、详细帮助、操作指引

适用人群​

  • ✅ 开发技术人员
  • ✅ 技术支持工程师
  • ✅ CTI/TAC 技术专家
  • ✅ 一线技术支持
  • ✅ 总代技术团队
  • ✅ 渠道合作伙伴
  • ✅ 客户运维人员
  • ✅ ......