本文档为天翼云物理机监控Agent与云助手升级标准化操作手册，适用于Linux架构物理机实例的监控升级与云助手运维，可规避关机重装镜像的操作成本，提供云助手批量远程升级与离线手动安装两种方案。仅支持Linux系统，兼容x86_64、arm64架构。操作以资源池能力预检为分支；支持云助手及连通内网镜像站连通的资源池，可批量远程升级；无云助手能力的资源池，可根据内网镜像站连通性选择内网脚本或离线安装方式。
一、前置约束条件
物理机实例所属资源池内网可访问天翼云镜像站（内网访问地址：http://internal.mirrors.ctyun.cn）；
该资源池需要支持云助手服务，且物理机实例需部署云助手ca-agent，镜像未预装云助手时需先手动安装；
仅支持Linux操作系统的物理机，自动识别x86_64/amd64、arm64/aarch64架构；
脚本自动识别昇腾NPU，区分通用机型与昇腾NPU专用监控程序。
二、资源池整体能力预检（流程分支判断）
2.1 校验资源池云助手能力与镜像站连通性
登录天翼云控制台-物理机服务：
场景一：资源池支持云助手（控制台左侧边栏可见运维工具模块） 可使用云助手批量升级方案，继续执行后续「云助手状态检查、镜像站连通校验、脚本升级」流程。
场景二：资源池无云助手能力（控制台左侧边栏无运维工具模块） 无法使用云助手远程下发脚本，需进一步校验天翼云内网镜像站连通性：
无法使用云助手远程下发脚本，需进一步校验天翼云镜像站内网连通性（校验方法参照“四、镜像站内网连通性校验”）
天翼云镜像站内网访问可通：可登录机器手动执行 5.1 章节的脚本，用于升级物理机监控Agent；
天翼云镜像站内网访问不通：参考手动安装监控Agent进行手动安装。
三、云助手前置检查与手动安装
本节仅适用于：资源池已支持云助手的场景
3.1 校验单实例云助手运行状态
登录物理机实例，root账号执行校验命令：
# 查看云助手进程
ps -ef | grep ca-agent
# 查看云助手服务运行状态
systemctl status ca-agent.service判断标准：输出 active (running) 代表云助手正常就绪，可直接使用控制台下发脚本； 若提示无服务、进程不存在，则执行3.2手动安装云助手。
3.2 手动安装云助手
curl http://169.254.169.254:20300/api/ebm/caAgent/latest/download -o ca-agent-install.tar.gz
tar -zxvf ca-agent-install.tar.gz
cd ca-agent-install
bash -x install_linux.sh
# 安装完成校验
systemctl status ca-agent.service四、镜像站内网连通性校验
资源池支持云助手的前提下，下发脚本前验证安装包可正常下载，确认网络无拦截：
curl -I http://internal.mirrors.ctyun.cn/ctyun-tools/telegraf/monitor-agent1.3.6-baremetal.zip正常返回HTTP 200状态码代表网络正常，可执行监控升级脚本。
五、云助手下发监控Agent升级完整脚本
5.1 升级Shell脚本源码
#!/bin/bash
set -euo pipefail
# ====================== 配置区 ======================
AGENT_ZIP_URL="http://internal.mirrors.ctyun.cn/ctyun-tools/telegraf/monitor-agent1.3.6-baremetal.zip"
WORK_DIR="/opt/ctyun_monitor"
ZIP_FILE="${WORK_DIR}/monitor-agent1.3.6-baremetal.zip"
TAR_NAME="telegraf-monitor.tar.gz"
# ====================================================
echo "===== 天翼云物理机监控Agent自动升级脚本 ====="
# 1. 创建工作目录
mkdir -p ${WORK_DIR}
cd ${WORK_DIR}
# 2. 下载安装包
echo "[1/6] 下载监控Agent安装包..."
if command -v wget &> /dev/null; then
wget -q -O ${ZIP_FILE} ${AGENT_ZIP_URL}
elif command -v curl &> /dev/null; then
curl -sSL -o ${ZIP_FILE} ${AGENT_ZIP_URL}
else
echo "错误：系统未安装wget/curl，请先安装下载工具"
exit 1
fi
# 3. 解压zip，再解压内部tar包
echo "[2/6] 解压安装包..."
unzip -o ${ZIP_FILE}
tar -zxvf ${TAR_NAME}
cd bare_metal/linux
# 4. 判断CPU架构
echo "[3/6] 检测系统CPU架构..."
ARCH=$(arch)
echo "当前架构: ${ARCH}"
if [[ "${ARCH}" == "x86_64" || "${ARCH}" == "amd64" ]]; then
ARCH_DIR="amd64"
elif [[ "${ARCH}" == "arm64" || "${ARCH}" == "aarch64" ]]; then
ARCH_DIR="arm64"
else
echo "不支持的CPU架构: ${ARCH}"
exit 1
fi
# 5. 判断是否存在昇腾NPU
echo "[4/6] 检测是否存在昇腾NPU设备..."
HAS_NPU=0
if ls /dev/davinci* &> /dev/null; then
HAS_NPU=1
echo "检测到昇腾NPU设备，安装NPU专用监控Agent"
else
echo "未检测到昇腾NPU设备，安装通用GPU/物理机Agent"
fi
# 6. 复制对应二进制与配置文件并执行安装
echo "[5/6] 拷贝对应架构监控程序与配置"
if [ ${HAS_NPU} -eq 1 ]; then
cp ./${ARCH_DIR}/telegraf_npu telegraf
cp ./${ARCH_DIR}/size_npu.txt size.txt
cp ./conf/telegraf.npu.conf telegraf.conf
# 赋予执行权限并安装
chmod +x update_agent_npu.sh
echo "[6/6] 执行NPU版Agent安装脚本..."
./update_agent_npu.sh abc 1
else
cp ./${ARCH_DIR}/telegraf .
cp ./${ARCH_DIR}/size.txt .
cp ./conf/telegraf.conf .
# 赋予执行权限并安装
chmod +x update_agent.sh
echo "[6/6] 执行通用版Agent安装脚本..."
./update_agent.sh abc 1
fi
echo ""
echo "====================================="
echo "监控Agent安装流程执行完成！"
echo "提示：安装过程少量报错可忽略，等待1分钟生效"
echo "====================================="5.2 控制台云助手下发操作步骤
登录天翼云控制台，进入物理机列表页面；
左侧导航栏选择【运维工具】功能入口；
选择【云助手】，创建一个命令，内容为 5.1 章节完整脚本，类型为
Shell;对于刚新建的命令，点击【执行命令】，筛选出要执行指令的实例并勾选，可批量执行；
执行身份选择
root，超时时间建议设置120秒，点击【执行命令】下发任务；在执行记录页面查看输出，日志末尾输出
监控Agent安装流程执行完成！即代表升级成功。
六、故障排查说明
云助手执行无返回/超时
核查ca-agent服务运行状态。
脚本下载安装包失败
联系资源池运维确认天翼云镜像站（内网访问地址：http://internal.mirrors.ctyun.cn）访问权限与网络连通性。
如该资源池不通内网镜像站，则参考手动安装监控Agent部署文档进行手动安装。
七、整体操作流程汇总
资源池能力预检：判断资源池是否支持云助手，区分「云助手批量升级」和「纯手动安装」两条分支；
实例云助手校验：支持云助手的资源池，检查单实例ca-agent状态，缺失则手动部署云助手；
网络预检：校验内网镜像站连通性，确保安装包可正常下载；
批量下发升级：通过控制台云助手远程执行监控Agent自动升级脚本；
结果验证：查看执行日志，等待3分钟监控采集正常上报，完成升级。
