文档首页/ 云监控服务 CES/ 故障排除/ 主机监控/ Agent异常/ 业务端口被Agent占用该如何处理？
更新时间：2026-11-10 GMT+08:00
查看PDF
分享

业务端口被Agent占用该如何处理？

云监控服务的Agent插件会使用HTTP请求上报数据，使用过程中会随机占用动态端口，范围取自/proc/sys/net/ipv4/ip_local_port_range。若发现使用的业务端口与Agent使用的端口冲突，可以修改/proc/sys/net/ipv4/ip_local_port_range，并重启Agent解决此问题。

前提条件

在重启Agent时，需要先确认当前主机安装的Agent版本为新版本还是老版本，确认方式请参见确认云监控插件版本。

Linux

  1. 使用root用户登录ECS或BMS。
  2. 执行如下命令，打开sysctl.conf文件。 
    vim /etc/sysctl.conf
  3. （永久修改）在sysctl.conf文件添加新的端口配置。 
    net.ipv4.ip_local_port_range=49152 65536
  4. 执行如下命令，使修改生效。 
    sysctl -p /etc/sysctl.conf
    • 永久性修改，重启ECS或BMS后依旧生效。
    • 若要临时修改（重启ECS或BMS后失效），请执行# echo 49152 65536 > /proc/sys/net/ipv4/ip_local_port_range。
  5. 执行以下命令，重启Agent。
    老版本Agent： 
    /usr/local/telescope/telescoped restart
    新版本Agent： 
    service ces-uniagent stop
service ces-uniagent start
/usr/local/uniagent/extension/install/telescope/telescoped restart

Windows

  1. 使用Administrator用户登录ECS。
  2. 打开WindowsPowerShell并执行以下命令，修改IPv4 TCP动态端口范围（即系统作为客户端发起连接时自动分配的临时源端口范围）。 
    netsh int ipv4 set dynamicportrange tcp start=49152 num=16384
  3. 进入Agent安装路径下，先双击执行shutdown.bat脚本，停止Agent，再执行start.bat脚本，启动Agent。
    • 老版本Agent默认安装路径为“C:\Program Files\telescope”。
    • 新版本Agent默认安装路径为：“C:\Program Files\uniagent\extension\install\telescope”。
父主题： Agent异常

相关文档