手动配置Agent(可选)
云监控服务为用户提供了一键配置AK/SK、RegionID、ProjectId的功能,您可以通过“一键配置”为区域下所有云服务器或裸金属服务器安装的Agent做临时AK/SK授权,并且以后在该区域新创建的资源都会自动获得此授权。如果“一键配置”不成功或其他原因导致无法配置Agent,您可以采用本章节提供的手工方式配置Agent。
在手动配置Agent时,需要通过AccessKey和SecretKey进行认证。明文存储AccessKey和SecretKey存在较大的安全风险,建议优先选择一键配置的方式,为该区域下的所有云服务器或裸金属服务器安装的Agent进行委托授权。委托方法请参阅通过一键配置为主机授予插件权限。
约束与限制
目前支持Linux操作系统和Windows操作系统。支持的系统请参见Agent支持的系统有哪些?。
前提条件
已成功安装Agent插件。
Linux系统
确认正在使用的Agent版本
- 使用root账号,登录ECS。
- 执行如下命令,确认使用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,手动配置Agent操作请参考请使用手动配置Agent(新版本Agent)。
- 返回“0”,表示未安装Agent。
- 使用root账号,登录ECS。
- 执行以下命令,修改telescope配置文件conf.json。
vi /usr/local/uniagent/extension/install/telescope/bin/conf.json
修改文件中的参数,具体参数解释请参见表1。图1 ECS修改conf.json配置文件
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。保持默认即可,如需修改,可通过登录云监控服务管理控制台,在主机监控列表中查看。
说明:配置实例ID时,需要遵循如下两条原则:
- 实例ID需保证全局唯一性,即同一个RegionID下Agent使用的InstanceId不能相同,否则系统可能会出现异常。
- InstanceId必须与实际的ECS或BMS资源ID一致,否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。
ProjectId
项目ID。默认为空值,表示指定的是当前主机的所属的项目ID。保持默认即可,如需配置,请参考以下获取方式:
- 登录云监控服务管理控制台。
- 将鼠标移动到右上角用户名区域,在基本信息弹窗中,选择“我的凭证”;
- 在项目列表中,查看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详见地区和终端节点。
ClientPort
Agent占用的起始端口号。
说明:默认为0,表示随机占用。1-1023为系统保留端口,建议不要配置。
PortNum
Agent占用的范围的个数。
说明:默认为200,若ClientPort配置5000,则表示在5000-5199端口中随机占用。
BmsFlag
BMS需配置此参数为true,ECS配置项中无需配置。
Windows操作系统中不需要配置。
- 重复步骤2,修改uniagent下的配置文件conf.json。
vi /usr/local/uniagent/conf/conf.json
- 配置完成后,登录云监控服务主机监控页面,当插件状态为运行中,说明Agent已安装成功并开始采集细粒度监控指标。
Agent插件配置完成后,因监控数据暂未上报,插件状态仍显示“未安装”,等待3-5分钟,刷新即可。
- 使用root账号,登录ECS。
- 执行以下命令,切换至Agent安装路径的bin下。
cd /usr/local/telescope/bin
- 修改配置文件conf.json。
- 执行以下命令,打开配置文件conf.json。
vi conf.json
- 修改文件中的参数,具体参数请参见表2。
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。保持默认即可,如需修改,可通过登录云监控服务管理控制台,在主机监控列表中查看。
说明:配置实例ID时,需要遵循如下两条原则:
- 实例ID需保证全局唯一性,即同一个RegionID下Agent使用的InstanceId不能相同,否则系统可能会出现异常。
- InstanceId必须与实际的ECS或BMS资源ID一致,否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。
ProjectId
项目ID。默认为空值,表示指定的是当前主机的所属的项目ID。保持默认即可,如需配置,请参考以下获取方式:
- 登录云监控服务管理控制台。
- 将鼠标移动到右上角用户名区域,在基本信息弹窗中,选择“我的凭证”;
- 在项目列表中,查看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详见地区和终端节点。
ClientPort
Agent占用的起始端口号。
说明:默认为0,表示随机占用。1-1023为系统保留端口,建议不要配置。
PortNum
Agent占用的范围的个数。
说明:默认为200,若ClientPort配置5000,则表示在5000-5199端口中随机占用。
BmsFlag
BMS需配置此参数为true,ECS配置项中无需配置。
Windows操作系统中不需要配置。
- 执行以下命令,打开配置文件conf.json。
- 修改云监控服务指标采集模块的配置文件conf_ces.json。
- 执行以下命令,打开公共配置文件conf_ces.json。
vi conf_ces.json
- 修改文件中的参数,修改完成后保存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取值详见地区和终端节点。
- 执行以下命令,打开公共配置文件conf_ces.json。
- 配置完成后,登录云监控服务主机监控页面,当插件状态为运行中,说明Agent已安装成功并开始采集细粒度监控指标。
Agent插件配置完成后,因监控数据暂未上报,插件状态仍显示“未安装”,等待3-5分钟,刷新即可。
Windows系统
确认正在使用的Agent版本
- 使用Administrator用户,登录ECS。
- 查看安装路径,确认使用Agent的版本。
- 老版本Agent安装路径为“C:\Program Files\telescope”,手动配置Agent操作请参考手动配置Agent(老版本Agent)。
- 新版本Agent安装路径为“C:\Program Files\uniagent\extension\install\telescope”,手动配置Agent操作请参考手动配置Agent(新版本Agent)。
- 使用Administrator用户,登录ECS。
- 打开C:\Program Files\uniagent\extension\install\telescope\bin文件夹下的conf.json文件。
- 配置如下参数,参数说明请参见表4。
{ "InstanceId":"", "ProjectId": "", "AccessKey": "XXXXXXXXXXXXXXXXXXXX", "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "RegionId": "cn-north-1", "ClientPort": 0, "PortNum": 200 }表4 公共配置参数 参数
说明
InstanceId
实例ID,默认为空值,表示指定的是当前主机的实例ID。保持默认即可,如需修改,可通过登录云监控服务管理控制台,在主机监控列表中查看。
说明:配置实例ID时,需要遵循如下两条原则:
- 实例ID需保证全局唯一性,即同一个RegionID下Agent使用的InstanceId不能相同,否则系统可能会出现异常。
- InstanceId必须与实际的ECS或BMS资源ID一致,否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。
ProjectId
项目ID。默认为空值,表示指定的是当前主机的所属的项目ID。保持默认即可,如需配置,请参考以下获取方式:
- 登录云监控服务管理控制台。
- 将鼠标移动到右上角用户名区域,在基本信息弹窗中,选择“我的凭证”;
- 在项目列表中,查看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详见地区和终端节点。
ClientPort
Agent占用的起始端口号。
说明:默认为0,表示随机占用。1-1023为系统保留端口,建议不要配置。
PortNum
Agent占用的范围的个数。
说明:默认为200,若ClientPort配置5000,则表示在5000-5199端口中随机占用。
- 打开“C:\Program Files\uniagent\conf”文件夹下的conf.json文件,重复步骤3,修改配置文件。
- 配置完成后,登录云监控服务主机监控页面,当插件状态为运行中,说明Agent已安装成功并开始采集细粒度监控指标。
Agent插件配置完成后,因监控数据暂未上报,插件状态仍显示“未安装”,等待3-5分钟,刷新即可。
- 使用Administrator用户,登录ECS。
- 打开“C:\Program Files\telescope”文件夹下的conf.json文件。
- 配置如下参数,参数说明请参见表5。
{ "InstanceId":"", "ProjectId": "", "AccessKey": "XXXXXXXXXXXXXXXXXXXX", "SecretKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "RegionId": "cn-north-1", "ClientPort": 0, "PortNum": 200 }表5 公共配置参数 参数
说明
InstanceId
实例ID,默认为空值,表示指定的是当前主机的实例ID。保持默认即可,如需修改,可通过登录云监控服务管理控制台,在主机监控列表中查看。
说明:配置实例ID时,需要遵循如下两条原则:
- 实例ID需保证全局唯一性,即同一个RegionID下Agent使用的InstanceId不能相同,否则系统可能会出现异常。
- InstanceId必须与实际的ECS或BMS资源ID一致,否则云监控服务界面将看不到对应ECS或BMS资源操作系统监控的数据。
ProjectId
项目ID。默认为空值,表示指定的是当前主机的所属的项目ID。保持默认即可,如需配置,请参考以下获取方式:
- 登录云监控服务管理控制台。
- 将鼠标移动到右上角用户名区域,在基本信息弹窗中,选择“我的凭证”;
- 在项目列表中,查看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详见地区和终端节点。
ClientPort
Agent占用的起始端口号。
说明:默认为0,表示随机占用。1-1023为系统保留端口,建议不要配置。
PortNum
Agent占用的范围的个数。
说明:默认为200,若ClientPort配置5000,则表示在5000-5199端口中随机占用。
- 打开“C:\Program Files\telescope”下的conf_ces.json文件,修改云监控服务指标采集模块的配置文件。
- 修改文件中的参数,修改完成后保存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取值详见地区和终端节点。
- 配置完成后,登录云监控服务主机监控页面,当插件状态为运行中,说明Agent已安装成功并开始采集细粒度监控指标。
Agent插件配置完成后,因监控数据暂未上报,插件状态仍显示“未安装”,等待3-5分钟,刷新即可。