GCP VM监控代理在Debian 11环境安装失败报404错误

404报错的直接原因是旧版Stackdriver VM监控代理没有适配Debian 11 (bullseye)，官方软件仓库根本不存在google-cloud-monitoring-bullseye-all对应的发布文件，所以不管是Cloud Console一键部署还是手动执行脚本安装旧代理，都会触发这个源不存在的错误。旧版监控代理最高仅支持Debian 10 (buster)，Debian 11及更新版本官方已经停止为旧代理做适配。

• 清理残留的无效源配置，避免后续apt操作报源错误
  执行命令删除之前失败安装留下的错误源：

  sudo rm -f /etc/apt/sources.list.d/google-cloud-monitoring.list
  sudo apt autoclean
  sudo apt update
  

• 安装官方支持Debian 11的Ops Agent（统一运维代理）
  这个代理是Google现在主推的默认采集端，整合了旧版监控代理、日志代理的全部能力，原生适配Debian 11，不会出现源404的问题，执行以下命令安装：

  curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
  sudo bash add-google-cloud-ops-agent-repo.sh --also-install
  

• 验证安装结果
  安装完成后执行命令检查服务状态：

  sudo systemctl status google-cloud-ops-agent*
  

  终端返回服务状态为active (running)即为安装成功，等待2-5分钟后就能在Cloud Console的VM监控页面看到上报的CPU、内存、磁盘等监控指标。

• 不要手动把源配置里的bullseye字段改成buster强制安装旧版监控代理，会出现libc等核心依赖版本不匹配的问题，轻则代理无法启动，重则影响系统上其他业务运行
• 如果后续用Cloud Console安装代理，直接选择安装Ops Agent选项即可，不要再选旧版“Monitoring Agent”的安装入口，那个入口在Debian 11系统上还是会触发同样的404错误
• 安装前确认VM实例绑定的服务账号有Monitoring Metric Writer、Logs Writer权限，否则代理装完也没法正常上报数据到Cloud Monitoring。

内容的提问来源于stack exchange，提问作者Pritesh Mhatre