# 手动配置Agent（可选） 云监控服务为用户提供了一键配置AK/SK、RegionId、ProjectId的功能，您可以通过"[一键配置](https://support.huaweicloud.com/usermanual-ces/ces_01_0028.html#ces_01_0028__section510453283412)"为区域下所有云服务器或裸金属服务器安装的Agent做临时AK/SK授权，并且以后在该区域新创建的资源都会自动获得此授权。如果"一键配置"不成功或其他原因导致无法配置Agent，您可以采用本章节提供的手工方式配置Agent。 ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/caution_3.0-zh-cn.png) 在手动配置Agent时，需要通过AccessKey和SecretKey进行认证。明文存储AccessKey和SecretKey存在较大的安全风险，建议优先选择一键配置的方式，为该区域下的所有云服务器或裸金属服务器安装的Agent进行委托授权。委托方法请参阅[通过一键配置为主机授予插件权限](https://support.huaweicloud.com/usermanual-ces/ces_01_0028.html)。 #### 约束与限制 目前支持Linux操作系统和Windows操作系统。支持的系统请参见[Agent支持的系统有哪些？](https://support.huaweicloud.com/ces_faq/ces_faq_0024.html)。 #### 前提条件 已成功[安装Agent插件](https://support.huaweicloud.com/usermanual-ces/ces_01_0029.html)。 #### 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 ``` - 返回"old agent"，表示使用老版本Agent，手动配置Agent操作请参考[手动配置Agent（老版本Agent）]，老版本Agent需要修改**telescope** 的配置文件和云监控服务**指标采集模块**的配置文件。 - 返回版本号，表示使用新版本Agent，手动配置Agent操作请参考[手动配置Agent（新版本Agent）]，新版本Agent需要修改**uniagent** 和**telescope**的配置文件，确保配置的参数值一致。 - 返回"0"，表示未安装Agent，请参阅[安装Agent](https://support.huaweicloud.com/usermanual-ces/ces_01_0029.html)进行安装。 - [手动配置Agent（新版本Agent）] 1. 使用root账号，登录主机。 2. 执行以下命令，修改**telescope** 配置文件conf.json。 ``` vi /usr/local/uniagent/extension/install/telescope/bin/conf.json ``` 修改文件中的参数，具体参数解释请参见[表1]。 图1ECS修改conf.json配置文件 ![](https://support.huaweicloud.com/usermanual-ces/zh-cn_image_0000002666507928.png "点击放大") **ECS配置参数** ``` { "InstanceId":"", "ProjectId": "", "AccessKey": "XXXXXXXXXXXXXXXXXXXX", "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "RegionId": "cn-north-1", "ClientPort": 0, "PortNum": 200 } ``` **BMS配置参数** ``` { "InstanceId":"", "ProjectId": "", "AccessKey": "XXXXXXXXXXXXXXXXXXXX", "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "RegionId": "cn-north-1", "ClientPort": 0, "PortNum": 200, "BmsFlag": true } ``` 表1公共配置参数 | 参数 | 说明 | |:---|:---| | InstanceId | 实例ID，默认为空值，表示指定的是当前主机的实例ID。保持默认即可，如需修改，可通过登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)，在主机监控列表中查看。 说明： 配置实例ID时，需要遵循如下两条原则： - 实例ID需保证全局唯一性，即同一个RegionId下Agent使用的InstanceId不能相同，否则系统可能会出现异常。 - InstanceId必须与实际的ECS或BMS资源ID一致，否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。 | | ProjectId | 项目ID。默认为空值，表示指定的是当前主机所属的项目ID。保持默认即可，如需配置，请参考以下获取方式： 1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。 2. 将鼠标移动到右上角用户名区域，在基本信息弹窗中，选择"我的凭证"； 3. 在项目列表中，查看ECS或BMS资源对应的所属区域的项目ID。 | | AccessKey/SecretKey | 访问密钥，获取方式如下： 1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。 2. 将鼠标移动到右上角用户名区域，在基本信息弹窗中，选择"我的凭证"； 3. 在左侧导航栏选择"访问密钥"。 - 如已有访问密钥，查看创建时下载保存的credentials.csv文件中，获取文件中记录的Key值即可； - 如未创建，则通过"新增访问密钥"可创建新的访问密钥，妥善保存credentials.csv文件，并获取文件中记录的Key值。 须知： - 为了安全考虑，建议该用户为IAM用户，并且权限仅为CES Administrator和LTS Administrator，具体操作请参见[创建用户组并授权](https://support.huaweicloud.com/qs-iam/iam_01_0030.html)、[创建IAM用户并登录](https://support.huaweicloud.com/qs-iam/iam_01_0031.html)。 - 配置的AccessKey必须在"我的凭证 \> 访问密钥"列表中，否则将鉴权失败，云监控服务界面看不到操作系统监控数据。 | | RegionId | 区域ID，例如：ECS或BMS资源所属区域为"华北-北京一"，则RegionId为"cn-north-1"，其他区域的RegionId详见[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CES)。 | | ClientPort | Agent占用的起始端口号。 说明： 默认为0，表示随机占用。1-1023为系统保留端口，建议不要配置。 | | PortNum | Agent占用的范围的个数。 说明： 默认为200，若ClientPort配置5000，则表示在5000-5199端口中随机占用。 | | BmsFlag | BMS需配置此参数为true，ECS配置项中无需配置。 Windows操作系统中不需要配置。 | 3. 参考[表1]，修改**uniagent** 下的配置文件conf.json。 ``` vi /usr/local/uniagent/conf/conf.json ``` 4. 配置完成后，登录[云监控服务主机监控页面](https://console.huaweicloud.com/ces/?#/hostMonitor/list?namespace=SYS.ECS)，当插件状态为运行中，说明Agent已安装成功并开始采集细粒度监控指标。 ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/note_3.0-zh-cn.png) Agent插件配置完成后，因监控数据暂未上报，插件状态仍显示"未安装"，等待3-5分钟，刷新即可。 - [手动配置Agent（老版本Agent）] 1. 使用root账号，登录主机。 2. 执行以下命令，切换至Agent安装路径的bin下。 ``` cd /usr/local/telescope/bin ``` 3. 修改配置文件conf.json。 1. 执行以下命令，打开配置文件conf.json。 ``` vi conf.json ``` 2. 修改文件中的参数，具体参数请参见[表2]。 图2ECS修改conf.json配置文件 ![](https://support.huaweicloud.com/usermanual-ces/zh-cn_image_0000002696307761.png "点击放大") **ECS配置参数** ``` { "InstanceId":"", "ProjectId": "", "AccessKey": "XXXXXXXXXXXXXXXXXXXX", "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "RegionId": "cn-north-1", "ClientPort": 0, "PortNum": 200 } ``` **BMS配置参数** ``` { "InstanceId":"", "ProjectId": "", "AccessKey": "XXXXXXXXXXXXXXXXXXXX", "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "RegionId": "cn-north-1", "ClientPort": 0, "PortNum": 200, "BmsFlag": true } ``` 表2公共配置参数 | 参数 | 说明 | |:---|:---| | InstanceId | 实例ID，默认为空值，表示指定的是当前主机的实例ID。保持默认即可，如需修改，可通过登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)，在主机监控列表中查看。 说明： 配置实例ID时，需要遵循如下两条原则： - 实例ID需保证全局唯一性，即同一个RegionId下Agent使用的InstanceId不能相同，否则系统可能会出现异常。 - InstanceId必须与实际的ECS或BMS资源ID一致，否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。 | | ProjectId | 项目ID。默认为空值，表示指定的是当前主机所属的项目ID。保持默认即可，如需配置，请参考以下获取方式： 1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。 2. 将鼠标移动到右上角用户名区域，在基本信息弹窗中，选择"我的凭证"； 3. 在项目列表中，查看ECS或BMS资源对应的所属区域的项目ID。 | | AccessKey/SecretKey | 访问密钥，获取方式如下： 1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。 2. 将鼠标移动到右上角用户名区域，在基本信息弹窗中，选择"我的凭证"； 3. 在左侧导航栏选择"访问密钥"。 - 如已有访问密钥，查看创建时下载保存的credentials.csv文件中，获取文件中记录的Key值即可； - 如未创建，则通过"新增访问密钥"可创建新的访问密钥，妥善保存credentials.csv文件，并获取文件中记录的Key值。 须知： - 为了安全考虑，建议该用户为IAM用户，并且权限仅为CES Administrator和LTS Administrator，具体操作请参见[创建用户组并授权](https://support.huaweicloud.com/qs-iam/iam_01_0030.html)、[创建IAM用户并登录](https://support.huaweicloud.com/qs-iam/iam_01_0031.html)。 - 配置的AccessKey必须在"我的凭证 \> 访问密钥"列表中，否则将鉴权失败，云监控服务界面看不到操作系统监控数据。 | | RegionId | 区域ID，例如：ECS或BMS资源所属区域为"华北-北京一"，则RegionId为"cn-north-1"，其他区域的RegionId详见[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CES)。 | | 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://console.huaweicloud.com/apiexplorer/#/endpoint/CES)。 | 5. 配置完成后，登录[云监控服务主机监控页面](https://console.huaweicloud.com/ces/?#/hostMonitor/list?namespace=SYS.ECS)，当插件状态为运行中，说明Agent已安装成功并开始采集细粒度监控指标。 ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/note_3.0-zh-cn.png) Agent插件配置完成后，因监控数据暂未上报，插件状态仍显示"未安装"，等待3-5分钟，刷新即可。 #### Windows系统 **确认正在使用的Agent版本** 1. 使用Administrator用户，登录ECS。 2. 查看安装路径，确认使用Agent的版本。 - 老版本Agent安装路径为"C:\\Program Files\\telescope"，手动配置Agent操作请参考[手动配置Agent（老版本Agent）]，老版本Agent需要修改**telescope** 的配置文件和云监控服务**指标采集模块**的配置文件。 - 新版本Agent安装路径为"C:\\Program Files\\uniagent\\extension\\install\\telescope"，手动配置Agent操作请参考[手动配置Agent（新版本Agent）]，新版本Agent需要修改**uniagent** 和**telescope**的配置文件，确保配置的参数值一致。 - [手动配置Agent（新版本Agent）] 1. 使用Administrator用户，登录ECS。 2. 打开C:\\Program Files\\uniagent\\extension\\install\\telescope\\bin文件夹下的conf.json文件。 3. 配置如下参数，参数说明请参见[表4]。 图3ECS修改conf.json配置文件 ![](https://support.huaweicloud.com/usermanual-ces/zh-cn_image_0000002666507930.png "点击放大") ``` { "InstanceId":"", "ProjectId": "", "AccessKey": "XXXXXXXXXXXXXXXXXXXX", "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "RegionId": "cn-north-1", "ClientPort": 0, "PortNum": 200 } ``` 表4公共配置参数 | 参数 | 说明 | |:---|:---| | InstanceId | 实例ID，默认为空值，表示指定的是当前主机的实例ID。保持默认即可，如需修改，可通过登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)，在主机监控列表中查看。 说明： 配置实例ID时，需要遵循如下两条原则： - 实例ID需保证全局唯一性，即同一个RegionId下Agent使用的InstanceId不能相同，否则系统可能会出现异常。 - InstanceId必须与实际的ECS或BMS资源ID一致，否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。 | | ProjectId | 项目ID。默认为空值，表示指定的是当前主机所属的项目ID。保持默认即可，如需配置，请参考以下获取方式： 1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。 2. 将鼠标移动到右上角用户名区域，在基本信息弹窗中，选择"我的凭证"； 3. 在项目列表中，查看ECS或BMS资源对应的所属区域的项目ID。 | | AccessKey/SecretKey | 访问密钥，获取方式如下： 1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。 2. 将鼠标移动到右上角用户名区域，在基本信息弹窗中，选择"我的凭证"； 3. 在左侧导航栏选择"访问密钥"。 - 如已有访问密钥，查看创建时下载保存的credentials.csv文件中，获取文件中记录的Key值即可； - 如未创建，则通过"新增访问密钥"可创建新的访问密钥，妥善保存credentials.csv文件，并获取文件中记录的Key值。 须知： - 为了安全考虑，建议该用户为IAM用户，并且权限仅为CES Administrator和LTS Administrator，具体操作请参见[创建用户组并授权](https://support.huaweicloud.com/qs-iam/iam_01_0030.html)、[创建IAM用户并登录](https://support.huaweicloud.com/qs-iam/iam_01_0031.html)。 - 配置的AccessKey必须在"我的凭证 \> 访问密钥"列表中，否则将鉴权失败，云监控服务界面看不到操作系统监控数据。 | | RegionId | 区域ID，例如：ECS或BMS资源所属区域为"华北-北京一"，则RegionId为"cn-north-1"，其他区域的RegionId详见[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CES)。 | | ClientPort | Agent占用的起始端口号。 说明： 默认为0，表示随机占用。1-1023为系统保留端口，建议不要配置。 | | PortNum | Agent占用的范围的个数。 说明： 默认为200，若ClientPort配置5000，则表示在5000-5199端口中随机占用。 | 4. 打开"C:\\Program Files\\uniagent\\conf"文件夹下的conf.json文件，参考[表4]，修改配置文件。 5. 配置完成后，登录[云监控服务主机监控页面](https://console.huaweicloud.com/ces/?#/hostMonitor/list?namespace=SYS.ECS)，当插件状态为运行中，说明Agent已安装成功并开始采集细粒度监控指标。 ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/note_3.0-zh-cn.png) Agent插件配置完成后，因监控数据暂未上报，插件状态仍显示"未安装"，等待3-5分钟，刷新即可。 - [手动配置Agent（老版本Agent）] 1. 使用Administrator用户，登录ECS。 2. 打开"C:\\Program Files\\telescope"文件夹下的conf.json文件。 3. 配置如下参数，参数说明请参见[表5]。 图4ECS修改conf.json配置文件 ![](https://support.huaweicloud.com/usermanual-ces/zh-cn_image_0000002666348024.png "点击放大") ``` { "InstanceId":"", "ProjectId": "", "AccessKey": "XXXXXXXXXXXXXXXXXXXX", "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "RegionId": "cn-north-1", "ClientPort": 0, "PortNum": 200 } ``` 表5公共配置参数 | 参数 | 说明 | |:---|:---| | InstanceId | 实例ID，默认为空值，表示指定的是当前主机的实例ID。保持默认即可，如需修改，可通过登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)，在主机监控列表中查看。 说明： 配置实例ID时，需要遵循如下两条原则： - 实例ID需保证全局唯一性，即同一个RegionId下Agent使用的InstanceId不能相同，否则系统可能会出现异常。 - InstanceId必须与实际的ECS或BMS资源ID一致，否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。 | | ProjectId | 项目ID。默认为空值，表示指定的是当前主机所属的项目ID。保持默认即可，如需配置，请参考以下获取方式： 1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。 2. 将鼠标移动到右上角用户名区域，在基本信息弹窗中，选择"我的凭证"； 3. 在项目列表中，查看ECS或BMS资源对应的所属区域的项目ID。 | | AccessKey/SecretKey | 访问密钥，获取方式如下： 1. 登录[云监控服务管理控制台](https://console.huaweicloud.com/ces/?#/monitor/overview)。 2. 将鼠标移动到右上角用户名区域，在基本信息弹窗中，选择"我的凭证"； 3. 在左侧导航栏选择"访问密钥"。 - 如已有访问密钥，查看创建时下载保存的credentials.csv文件中，获取文件中记录的Key值即可； - 如未创建，则通过"新增访问密钥"可创建新的访问密钥，妥善保存credentials.csv文件，并获取文件中记录的Key值。 须知： - 为了安全考虑，建议该用户为IAM用户，并且权限仅为CES Administrator和LTS Administrator，具体操作请参见[创建用户组并授权](https://support.huaweicloud.com/qs-iam/iam_01_0030.html)、[创建IAM用户并登录](https://support.huaweicloud.com/qs-iam/iam_01_0031.html)。 - 配置的AccessKey必须在"我的凭证 \> 访问密钥"列表中，否则将鉴权失败，云监控服务界面看不到操作系统监控数据。 | | RegionId | 区域ID，例如：ECS或BMS资源所属区域为"华北-北京一"，则RegionId为"cn-north-1"，其他区域的RegionId详见[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CES)。 | | ClientPort | Agent占用的起始端口号。 说明： 默认为0，表示随机占用。1-1023为系统保留端口，建议不要配置。 | | PortNum | Agent占用的范围的个数。 说明： 默认为200，若ClientPort配置5000，则表示在5000-5199端口中随机占用。 | 4. 打开"C:\\Program Files\\telescope"下的conf_ces.json文件，修改云监控服务指标采集模块的配置文件。 5. 修改文件中的参数，修改完成后保存conf_ces.json文件。具体参数请参见[表6]。 ``` { "Endpoint": "https://ces.cn-north-1.myhuaweicloud.com" } ``` 表6指标采集模块参数配置 | 参数 | 说明 | |:---|:---| | Endpoint | ECS或BMS资源所属区域的云监控服务Endpoint URL，例如：ECS或BMS资源所属区域为"华北-北京一"，则URL中使用"ces.cn-north-1.myhuaweicloud.com"，其他区域的Endpoint取值详见[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/CES)。 | 6. 配置完成后，登录[云监控服务主机监控页面](https://console.huaweicloud.com/ces/?#/hostMonitor/list?namespace=SYS.ECS)，当插件状态为运行中，说明Agent已安装成功并开始采集细粒度监控指标。 ![](https://support.huaweicloud.com/usermanual-ces/public_sys-resources/note_3.0-zh-cn.png) Agent插件配置完成后，因监控数据暂未上报，插件状态仍显示"未安装"，等待3-5分钟，刷新即可。