云主机内部监控agent

agent是安装在云主机内的代理，定时通过内部网络推送云主机监控数据到物理机。
Note:
  • 需预先安装agent，才能查看云主机内部监控数据。
  • 内部监控依赖三层网络的DHCP和User Data服务，云主机需启用DHCP和User Data服务，才能成功安装并使用agent。

安装方法

agent包含在云主机性能优化工具（GuestTools）中，不同操作系统的云主机，agent安装方法不同。

  • Linux云主机

    界面安装
    1. 在云主机详情页安装性能优化工具。
    2. 进入云主机控制台，执行以下安装命令：
      /bin/bash -c "$(curl -s -S http://169.254.169.254/vm-tools.sh)"
      如Figure 1所示：
      Figure 1. 安装agent


      Note:
      • 该安装命令中，169.254.169.254为User Data服务器的IP地址。
      • 安装或升级agent前，请确保已安装相应的Linux命令工具，如：tar、wget、curl。
      • agent支持自动升级，用户无感知。
    User Data安装
    1. 创建云主机时，进行系统配置。
    2. 在User Data框中输入以下命令：
      #cloud-config 
runcmd: 
- /bin/bash -c "$(curl -s http://169.254.169.254/cloud-tools.sh)"
      Note: Linux云主机导入User Data，云主机镜像需提前安装cloud-init。

  • Windows/Windows Virtio云主机

    1. 在云主机详情页安装性能优化工具。
    2. 进入控制台，根据提示按步骤安装GuestTools。
  • FreeBSD云主机
    1. 在云主机详情页安装性能优化工具。
    2. 进入云主机控制台，执行以下安装命令：
      curl http://169.254.169.254/vm-tools.sh -o vm-tools.sh && bash -x ./vm-tools.sh
      如Figure 2所示：
      Figure 2. 安装agent


      Note:
      • 该安装命令中，169.254.169.254为User Data服务器的IP地址。
      • 安装agent前，请确保已安装相应的Linux命令工具，如：bash、security/libgcrypt、curl。

安装要求

Table 1. 版本支持
支持操作系统 支持版本
CentOS
  • CentOS 6.8 64位
  • CentOS 6.9 64位
  • CentOS 6.10 64位
  • CentOS 7.2 64位
  • CentOS 7.3 64位
  • CentOS 7.4 64位
  • CentOS 7.5 64位
  • CentOS 7.6 64位
  • CentOS 8.0 64位
RHEL
  • Redhat Enterprise Linux Server 6.9 64位
  • Redhat Enterprise Linux Server 7.4 64位
  • Redhat Enterprise Linux Server 7.5 64位
  • Redhat Enterprise Linux Server 7.6 64位
Fedora
  • Fedora 30 64位
    Note: 不支持service命令，导致vm-tools.sh第54行执行报错，改为systemctl start可成功启动agent。
  • Fedora 31 64位
Debian
  • Debian 9.9 64位
  • Debian 10.0 64位
Ubuntu
  • Ubuntu 14.04 64位
  • Ubuntu 16.04 64位
  • Ubuntu 16.10 64位
  • Ubuntu 18.04 64位
银河麒麟
  • Kylin 4.0.2 64位
OpenSUSE
  • OpenSUSE 15.0 64位
SLES
  • SUSE Linux Enterprise Server 15 64位
  • SUSE Linux Enterprise Server 12 64位
FreeBSD
  • FreeBSD 11 64位
  • FreeBSD 12 64位
  • FreeBSD 13 64位
Windows
  • Windows Server 2003 R2 64位
  • Windows Server 2008 R2 64位
  • Windows Server 2012 64位
  • Windows Server 2016 64位
Table 2. 其他要求
条目 要求
环境依赖
  • rpm
  • systemd
端口占用
  • 9103
  • 9100
  • 25826
Note:
  • agent需由云主机操作系统的root账号进行安装。
  • 若默认端口被占用，安装后可能无法启动agent，此时可进入安装目录下的conf.yaml文件手动修改端口占用。
  • agent每10秒钟通过内部网络推送云主机监控数据到物理机上，数据并不会上传到外部网络。

支持操作

支持以下命令管理agent：
  • 停止服务：service zwatch-vm-agent stop
  • 启动服务：service zwatch-vm-agent start
  • 重启服务：service zwatch-vm-agent restart
  • 查询服务状态：service zwatch-vm-agent status

卸载方法

agent卸载方法区分Linux云主机与Windows云主机，方法分别如下：
  • Linux云主机
    1. 使用service zwatch-vm-agent stop命令停止agent。
    2. 使用rm -f /etc/systemd/system/zwatch-vm-agent.service命令删除service配置文件。
    3. 使用rm -rf /usr/local/zstack/zwatch-vm-agent命令删除agent安装目录。
  • Windows云主机
    1. 删除注册表相关条目。
      以管理员身份运行Windows命令提示符，执行以下命令删除系统中相关键值：
      reg delete HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSDTC /f
reg delete HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSDTC /f
reg delete HKEY_CLASSES_ROOT\CID /f
    2. 停止并重新安装msdtc服务。
      以管理员身份运行Windows命令提示符，执行以下命令停止并重新安装msdtc服务：
      net stop msdtc
msdtc -uninstall
msdtc -install
    3. 重新启动云主机。
    4. 卸载agent。
      以管理员身份运行Windows命令提示符，执行以下命令删除agent：
      msiexec /a "c:\Program Files\GuestTools\qemu-ga.msi" targetdir="c:\Program Files"
"c:\Program Files\QEMU Guest Agent\Qemu-ga\qemu-ga.exe" -s vss-uninstall