yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
c1d4f578e796abdf88145ac664bf12da18eefe2a
doc-exports/docs/ces/umn/ces_01_0032.html
qiujiandong1 c1d4f578e7 CES UMN 20250530 version 
Reviewed-by: Rumpler, Mihály <mihaly.rumpler@t-systems.com>
Co-authored-by: qiujiandong1 <qiujiandong1@huawei.com>
Co-committed-by: qiujiandong1 <qiujiandong1@huawei.com>
2025-11-18 06:22:57 +00:00

12 KiB
Raw Blame History

(Optional) Manually Configuring the Agent on a Windows Server

Scenarios

The Configure feature allows you to configure the AK/SK, region ID, and project ID in one-click mode. If the Agent fails to be configured by clicking Configure or due to other reasons, manually configure it by following the instructions provided in this topic.

Constraints

Some OSs are not supported. For details about which Windows OSs are supported, see What OSs Does the Agent Support?

Prerequisites

The Agent has been installed.

Checking the Version of the Agent In Use

  1. Log in to an ECS as an administrator.
  2. Check the installation path and the Agent version.
    • Earlier version: The Agent is installed in the directory where the Agent installation package is decompressed, for example, if the package is decompressed in D:\Agent, the installation path would be D:\Agent\telescope_windows_amd64.
    • New version: C:\Program Files\uniagent\extension\install\telescope

Procedure

  1. Log in to the ECS.
  2. Go to the bin directory in the Agent installation path.

    Earlier version: The Agent is installed in the directory of the decompressed Agent installation package, for example, if the package is decompressed in D:\Agent, the installation path would be D:\Agent\telescope_windows_amd64.

    New version: C:\Program Files\uniagent\extension\install\telescope

  3. Modify the conf.json file. For details about the parameters, see Table 1.

    To avoid major security risks from storing plaintext AKs and SKs, it is advised to delegate all ECS Agents in the region. For details, see How Do I Configure an Agency?

    {
    "InstanceId":"",
    "ProjectId": "",
    "AccessKey": "",
    "SecretKey": "",
    "RegionId": "eu-de",
    "ClientPort": 0,
    "PortNum": 200
}

    Table 1 Public parameters

    Parameter

    Description

    InstanceId

    Specifies the instance ID. This parameter is left blank by default, indicating that the instance ID of the current server is specified. Retain the default value. If you need to change the value, log in to the management console and view the instance ID in the ECS list.

    NOTE:

    When configuring the instance ID, comply with the following rules:

    • The instance ID must be unique at all sites, that is, in the same region, InstanceId used by the Agent cannot be the same, or errors may occur.
    • The InstanceId value must be consistent with the actual ECS ID, or you cannot see the OS monitoring data on Cloud Eye.

    ProjectId

    Specifies the project ID. This parameter is left blank by default, indicating that the project ID of the current server is specified. Retain the default value. If you need to configure it, obtain the project ID as follows:

    1. Log in to the Cloud Eye console, click the username in the upper right corner, and choose My Credentials.
    2. Under Projects, obtain the project ID for the region where the ECS is located.

    AccessKey/SecretKey

    To obtain the AK and SK, perform the following operations:

    Log in to Cloud Eye, click the username in the upper right corner, and choose My Credentials > Access Keys.

    • If you have obtained the access key, obtain the AccessKey value and the SecretKey value in the credentials.csv file saved when you create Access Keys.
    • If no access keys are available, click Create Access Key to create one. Save the credentials.csv file and obtain the AccessKey value and the SecretKey value in it.
      NOTICE:
      • For security purposes, it is recommended that the user be an IAM user with the CES Administrator permissions only.

    RegionId

    Specifies the region ID. For example, if the ECS is located in region EU DE, RegionId is eu-de.

    ClientPort

    Specifies the start port number used by the Agent.

    NOTE:

    The default value is 0, indicating that the Agent will randomly use any port. Ports 1 to 1023 are reserved. You are advised not to specify a port in this range for the Agent.

    PortNum

    Specifies the number of ports configured for the Agent.

    NOTE:

    The default value is 200. If ClientPort is 5000, the port range will be 5000 to 5199.
    • After you configure the Agent, its status is still displayed as Not installed because no monitoring data is reported yet. Wait 3 to 5 minutes and refresh the page.
    • If the Agent status is Running and monitoring is enabled, the Agent has been recognized by Cloud Eye and has started to report fine-grained metric data.