手動配置Agent（Linux，可選）
更新時間 2025-09-26 16:12:22
最近更新時間: 2025-09-26 16:12:22
分享文章
本文主要介紹 手動配置Agent（Linux，可選）
操作場景
用戶成功安裝Agent插件后，推薦您采用“修復插件配置”方式配置Agent。如果修復插件配置不成功或其他原因，你可以采用本章節提供的手工方式配置Agent。
本章節以ECS為例介紹如何修改DNS和添加安全組，BMS操作步驟類似。
前提條件
已成功安裝Agent插件。
操作步驟
使用root帳號，登錄ECS。
執行以下命令，切換至Agent安裝路徑的bin下。
cd /usr/local/uniagent/extension/install/telescope/bin修改配置文件conf.json。
a. 執行以下命令，打開配置文件conf.json。
vi conf.jsonb. 修改文件中的參數，具體參數請參見下表。
ECS配置參數
{
"InstanceId":" XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX ",
"ProjectId": " XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ",
"AccessKey": " XXXXXXXXXXXXXXXXXXXX ",
"SecretKey": " XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ",
"RegionId": "cn-hz1"
}BMS配置參數
{
"InstanceId":" XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX ",
"ProjectId": " XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ",
"AccessKey": " XXXXXXXXXXXXXXXXXXXX ",
"SecretKey": " XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ",
"RegionId": "cn-hz1"
}表 公共配置參數
| 參數 | 說明 |
|---|---|
| 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。 配置的AccessKey必須在“我的憑證 > 管理訪問密鑰”列表中，否則將鑒權失敗，云監控服務界面看不到操作系統監控數據。 |
| RegionId | 區域ID，例如：ECS或BMS資源所屬區域為“杭州”，則RegionID為“cn-hz1”。 |
| ClientPort | Agent占用的起始端口號。說明默認為0，表示隨機占用。1-1023為系統保留端口，建議不要配置。 |
| PortNum | Agent占用的范圍的個數。說明默認為200，若ClientPort配置5000，則表示在5000-5199端口中隨機占用。 |
| BmsFlag | BMS需配置此參數為true，ECS配置項中無需配置。Windows操作系統中無需要配置。 |
修改云監控服務指標采集模塊的配置文件conf_ces.json。
a. 執行以下命令，打開公共配置文件conf_ces.json。
vi conf_ces.json
b. 修改文件中的參數，修改完成后保存conf_ces.json文件。具體參數請參見表下表。
{
"Endpoint": "//ces. xx-xx-xx.xxx .com"
}表 指標采集模塊參數配置
| 參數 | 說明 |
|---|---|
| Endpoint | ECS或BMS資源所屬區域的云監控服務Endpoint URL，例如：ECS或BMS資源所屬區域為“杭州”，則URL中使用“ces.cn-hz1.daliqc.cn”。 |
說明
Agent插件配置完成后，因監控數據暫未上報，插件狀態仍顯示“未安裝”，等待3-5分鐘，刷新即可。
當插件狀態為“運行中”并且監控狀態開啟時，說明Agent已安裝成功并開始采集細粒度監控指標。
