更新时间:2025-06-30 GMT+08:00
分享

手动配置Agent(可选)

用户成功安装Agent插件后,修复插件配置为用户提供了一键配置AK/SK、RegionID、ProjectId的功能。如果“修复插件配置”不成功或其他原因导致无法配置Agent,您可以采用本章节提供的手工方式配置Agent。

约束与限制

目前支持Linux操作系统和Windows操作系统。支持的系统请参见Agent支持的系统有哪些?

前提条件

已成功安装Agent插件

Linux系统

确认正在使用的Agent版本

  1. 使用root账号,登录ECS。
  2. 执行如下命令,确认使用Agent的版本。
    if [[ -f /usr/local/uniagent/extension/install/telescope/bin/telescope ]]; then /usr/local/uniagent/extension/install/telescope/bin/telescope -v; elif [[ -f /usr/local/telescope/bin/telescope ]]; then echo "old agent"; else echo 0; fi
  1. 使用root账号,登录ECS。
  2. 修改bin目录下的配置文件conf.json。
    1. 执行以下命令,打开配置文件conf.json。
      vi /usr/local/uniagent/extension/install/telescope/bin/conf.json
    2. 修改文件中的参数,具体参数请参见表1

      认证用的AccessKey和SecretKey明文存储有很大的安全风险, 建议对该区域下所有云服务器或裸金属服务器安装的Agent做委托授权,委托方法请参考如何配置委托?

      {
          "InstanceId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
          "ProjectId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "AccessKey": "XXXXXXXXXXXXXXXXXXXX",
          "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "RegionId": "ap-southeast-1",
          "ClientPort": 0,
          "PortNum": 200
      }
      表1 公共配置参数

      参数

      说明

      InstanceId

      ECS ID,可通过登录管理控制台,在弹性云服务器ECS列表中查看。

      说明:

      InstanceId可不用配置,保持"InstanceId":"",即可,若需要配置,需要遵循如下两条原则:

      • 该资源ID需保证全局唯一性,即同一个RegionID下Agent使用的InstanceId不能相同,否则系统可能会出现异常。
      • InstanceId必须与实际的ECS或BMS资源ID一致,否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。

      ProjectId

      ProjectId可不用配置,保持"ProjectId": "",即可。若需要配置,请参考以下获取方式。

      项目ID,获取方式如下:

      1. 登录管理控制台,单击右上角“用户名”,选择“我的凭证”;
      2. 在项目列表中,查看ECS或BMS资源对应的所属区域的项目ID。

      AccessKey/SecretKey

      访问密钥,获取方式如下:

      登录管理控制台,单击右上角“用户名”,选择“我的凭证 > 访问密钥”;

      • 如已有访问密钥,查看创建时下载保存的credentials.csv文件中,获取文件中记录的Key值即可;
      • 如未创建,则通过“新增访问密钥”可创建新的访问密钥,妥善保存credentials.csv文件,并获取文件中记录的Key值。
        须知:
        • 为了安全考虑,建议该用户为IAM用户,并且权限仅为CES Administrator和LTS Administrator,请参见创建用户组并授权创建IAM用户并登录
        • 配置的AccessKey必须在“我的凭证 > 访问密钥”列表中,否则将鉴权失败,云监控服务界面看不到操作系统监控数据。

      RegionId

      区域ID,例如:ECS或BMS资源所属区域为“华北-北京一”,则RegionID为“cn-north-1”,其他区域的RegionID详见https://developer.huaweicloud.com/endpoint

      ClientPort

      Agent占用的起始端口号。

      说明:

      默认为0,表示随机占用。1-1023为系统保留端口,建议不要配置。

      PortNum

      Agent占用的范围的个数。

      说明:

      默认为200,若ClientPort配置5000,则表示在5000-5199端口中随机占用。

      BmsFlag

      BMS需配置此参数为true,ECS配置项中无需配置。

      Windows操作系统中无需要配置。

  1. 使用root账号,登录ECS。
  2. 执行以下命令,切换至Agent安装路径的bin下。
    
          
    cd /usr/local/uniagent/extension/install/telescope/bin
  3. 修改配置文件conf.json。
    1. 执行以下命令,打开配置文件conf.json。
      vi conf.json
    2. 修改文件中的参数,具体参数请参见表2
      ECS配置参数
      {
          "InstanceId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
          "ProjectId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "AccessKey": "XXXXXXXXXXXXXXXXXXXX",
          "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "RegionId": "cn-north-1",
          "ClientPort": 0,
          "PortNum": 200
      }

      BMS配置参数

      {
          "InstanceId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
          "ProjectId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "AccessKey": "XXXXXXXXXXXXXXXXXXXX",
          "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "RegionId": "cn-north-1",
          "ClientPort": 0,
          "PortNum": 200,
          "BmsFlag": true
      }
      表2 公共配置参数

      参数

      说明

      InstanceId

      ECS ID,可通过登录管理控制台,在弹性云服务器ECS列表中查看。

      说明:

      InstanceId可不用配置,保持"InstanceId":"",即可,若需要配置,需要遵循如下两条原则:

      • 该资源ID需保证全局唯一性,即同一个RegionID下Agent使用的InstanceId不能相同,否则系统可能会出现异常。
      • InstanceId必须与实际的ECS或BMS资源ID一致,否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。

      ProjectId

      ProjectId可不用配置,保持"ProjectId": "",即可。若需要配置,请参考以下获取方式。

      项目ID,获取方式如下:

      1. 登录管理控制台,单击右上角“用户名”,选择“我的凭证”;
      2. 在项目列表中,查看ECS或BMS资源对应的所属区域的项目ID。

      AccessKey/SecretKey

      访问密钥,获取方式如下:

      登录管理控制台,单击右上角“用户名”,选择“我的凭证 > 访问密钥”;

      • 如已有访问密钥,查看创建时下载保存的credentials.csv文件中,获取文件中记录的Key值即可;
      • 如未创建,则通过“新增访问密钥”可创建新的访问密钥,妥善保存credentials.csv文件,并获取文件中记录的Key值。
        须知:
        • 为了安全考虑,建议该用户为IAM用户,并且权限仅为CES Administrator和LTS Administrator,请参见创建用户组并授权创建IAM用户并登录
        • 配置的AccessKey必须在“我的凭证 > 访问密钥”列表中,否则将鉴权失败,云监控服务界面看不到操作系统监控数据。

      RegionId

      区域ID,例如:ECS或BMS资源所属区域为“华北-北京一”,则RegionID为“cn-north-1”,其他区域的RegionID详见https://developer.huaweicloud.com/endpoint

      ClientPort

      Agent占用的起始端口号。

      说明:

      默认为0,表示随机占用。1-1023为系统保留端口,建议不要配置。

      PortNum

      Agent占用的范围的个数。

      说明:

      默认为200,若ClientPort配置5000,则表示在5000-5199端口中随机占用。

      BmsFlag

      BMS需配置此参数为true,ECS配置项中无需配置。

      Windows操作系统中无需要配置。

  4. 修改云监控服务指标采集模块的配置文件conf_ces.json。
    1. 执行以下命令,打开公共配置文件conf_ces.json。
      vi conf_ces.json
    2. 修改文件中的参数,修改完成后保存conf_ces.json文件。具体参数请参见表3
      {
        "Endpoint": "https://ces.cn-north-1.myhuaweicloud.com"
      }
      表3 指标采集模块参数配置

      参数

      说明

      Endpoint

      ECS或BMS资源所属区域的云监控服务Endpoint URL,例如:ECS或BMS资源所属区域为“华北-北京一”,则URL中使用“ces.cn-north-1.myhuaweicloud.com”,其他区域的Endpoint取值详见https://developer.huaweicloud.com/endpoint

  5. 配置完成后,登录云监控服务管理控制台,单击左侧导航栏的“主机监控”,当插件状态为运行中,说明Agent已安装成功并开始采集细粒度监控指标。

    Agent插件配置完成后,因监控数据暂未上报,插件状态仍显示“未安装”,等待3-5分钟,刷新即可。

Windows系统

确认正在使用的Agent版本

  1. 使用管理员账号,登录ECS。
  2. 查看安装路径,确认使用Agent的版本。
  1. 使用管理员账号,登录ECS。
  2. 打开C:\Program Files\uniagent\extension\install\telescope\bin文件夹下的conf.json文件。
  3. 配置如下参数,参数说明请参见表4

    认证用的AccessKey和SecretKey明文存储有很大的安全风险, 建议对该区域下所有云服务器或裸金属服务器安装的Agent做委托授权,委托方法请参考如何配置委托?

    {
        "InstanceId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "ProjectId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "AccessKey": "XXXXXXXXXXXXXXXXXXXX",
        "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "RegionId": "ap-southeast-1",
        "ClientPort": 0,
        "PortNum": 200
    }
    表4 公共配置参数

    参数

    说明

    InstanceId

    ECS ID,可通过登录管理控制台,在弹性云服务器ECS列表中查看。

    说明:

    InstanceId可不用配置,保持"InstanceId":"",即可,若需要配置,需要遵循如下两条原则:

    • 该资源ID需保证全局唯一性,即同一个RegionID下Agent使用的InstanceId不能相同,否则系统可能会出现异常。
    • InstanceId必须与实际的ECS或BMS资源ID一致,否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。

    ProjectId

    ProjectId可不用配置,保持"ProjectId": "",即可。若需要配置,请参考以下获取方式。

    项目ID,获取方式如下:

    1. 登录管理控制台,单击右上角“用户名”,选择“我的凭证”;
    2. 在项目列表中,查看ECS或BMS资源对应的所属区域的项目ID。

    AccessKey/SecretKey

    访问密钥,获取方式如下:

    登录管理控制台,单击右上角“用户名”,选择“我的凭证 > 访问密钥”;

    • 如已有访问密钥,查看创建时下载保存的credentials.csv文件中,获取文件中记录的Key值即可;
    • 如未创建,则通过“新增访问密钥”可创建新的访问密钥,妥善保存credentials.csv文件,并获取文件中记录的Key值。
      须知:
      • 为了安全考虑,建议该用户为IAM用户,并且权限仅为CES Administrator和LTS Administrator,请参见创建用户组并授权创建IAM用户并登录
      • 配置的AccessKey必须在“我的凭证 > 访问密钥”列表中,否则将鉴权失败,云监控服务界面看不到操作系统监控数据。

    RegionId

    区域ID,例如:ECS或BMS资源所属区域为“华北-北京一”,则RegionID为“cn-north-1”,其他区域的RegionID详见https://developer.huaweicloud.com/endpoint

    ClientPort

    Agent占用的起始端口号。

    说明:

    默认为0,表示随机占用。1-1023为系统保留端口,建议不要配置。

    PortNum

    Agent占用的范围的个数。

    说明:

    默认为200,若ClientPort配置5000,则表示在5000-5199端口中随机占用。

  4. 配置完成后,登录云监控服务管理控制台,单击左侧导航栏的“主机监控”,当插件状态为运行中,说明Agent已安装成功并开始采集细粒度监控指标。

    Agent插件配置完成后,因监控数据暂未上报,插件状态仍显示“未安装”,等待3-5分钟,刷新即可。

  1. 使用管理员账号,登录ECS。
  2. 打开telescope_windows_amd64\bin文件夹下的conf.json文件。
  3. 配置如下参数,参数说明请参见表5
    {
        "InstanceId":"",
        "ProjectId": "",
        "AccessKey": "",
        "SecretKey": "",
        "RegionId": "cn-north-1",
        "ClientPort": 0,
        "PortNum": 200
    }

    表5 公共配置参数

    参数

    说明

    InstanceId

    ECS ID,可通过登录管理控制台,在弹性云服务器ECS列表中查看。

    说明:

    InstanceId可不用配置,保持"InstanceId":"",即可,若需要配置,需要遵循如下两条原则:

    • 该资源ID需保证全局唯一性,即同一个RegionID下Agent使用的InstanceId不能相同,否则系统可能会出现异常。
    • InstanceId必须与实际的ECS或BMS资源ID一致,否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。

    ProjectId

    ProjectId可不用配置,保持"ProjectId": "",即可。若需要配置,请参考以下获取方式。

    项目ID,获取方式如下:

    1. 登录管理控制台,单击右上角“用户名”,选择“我的凭证”;
    2. 在项目列表中,查看ECS或BMS资源对应的所属区域的项目ID。

    AccessKey/SecretKey

    访问密钥,获取方式如下:

    登录管理控制台,单击右上角“用户名”,选择“我的凭证 > 访问密钥”;

    • 如已有访问密钥,查看创建时下载保存的credentials.csv文件中,获取文件中记录的Key值即可;
    • 如未创建,则通过“新增访问密钥”可创建新的访问密钥,妥善保存credentials.csv文件,并获取文件中记录的Key值。
      须知:
      • 为了安全考虑,建议该用户为IAM用户,并且权限仅为CES Administrator和LTS Administrator,请参见创建用户组并授权创建IAM用户并登录
      • 配置的AccessKey必须在“我的凭证 > 访问密钥”列表中,否则将鉴权失败,云监控服务界面看不到操作系统监控数据。

    RegionId

    区域ID,例如:ECS或BMS资源所属区域为“华北-北京一”,则RegionID为“cn-north-1”,其他区域的RegionID详见https://developer.huaweicloud.com/endpoint

    ClientPort

    Agent占用的起始端口号。

    说明:

    默认为0,表示随机占用。1-1023为系统保留端口,建议不要配置。

    PortNum

    Agent占用的范围的个数。

    说明:

    默认为200,若ClientPort配置5000,则表示在5000-5199端口中随机占用。

  4. 配置完成后,登录云监控服务管理控制台,单击左侧导航栏的“主机监控”,当插件状态为运行中,说明Agent已安装成功并开始采集细粒度监控指标。

    Agent插件配置完成后,因监控数据暂未上报,插件状态仍显示“未安装”,等待3-5分钟,刷新即可。

相关文档