Window OS

To push Metrics to vMonitor, you need to install the Metric Agent on your server. vMonitor uses the Telegraf Agent to push metrics to the system. Currently, the Telegraf Agent supports the IAM Service Account for authentication and authorization. Follow the steps below to set up the Telegraf Agent to push metrics to vMonitor.

Telegraf Agent with Service Account

Create a Service Account and attach the policy: vMonitorMetricPush to have sufficient permissions to push Metrics to vMonitor.

To create a service account, visit here.

Select "Create a Service Account", enter a name for the Service Account, and click Next Step to assign permissions to the Service Account.
Find and select the Policy: vMonitorMetricPush, then click "Create a Service Account" to create the Service Account. The Policy: vMonitorMetricPush, created by VNG Cloud, contains the exact permissions needed to push metrics to the system.
After successfully creating the Service Account, you need to save the Client_ID and Secret_Key for the next step.

2. Download the Agent Installer for Windows

Access this link to load agent installer forWindows : https://github.com/vngcloud/vmonitor-metrics-agent/releases/download/1.26.0-2.0.1/telegraf-nightly_windows_amd64.exe

3. Install the installer using the Client_ID and Secret_Key you copied above.

Run the agent installer you downloaded above. A
fter receiving the notification, select More Info.

Then select Run anyway to start installing the agent.

Chosse Next to continue

Enter the two pieces of information, Client_ID and Secret_Key, you copied above into the fields: IAM_CLIENT_ID and IAM_CLIENT_SECRET:

Keep the default settings and select Next to continue, or if you want to change the installation directory, make the necessary changes.

Select "Accept the license," then click Next to continue.

Keep the default settings and select Next to continue, or you can customize the shortcut menu name for the agent.

Select Install to begin the installation.

Select Yes to grant permissions for the agent to operate.

After the installation process is complete, select Finish.

4.After successful installation, you will see the server on the Infrastructure List/Host page.

Telegraf Agent với API_KEY (deprecated)

Notice:

We do not recommend using this method, as our system will soon stop supporting these API Keys.

Step 1: Create an API Key (if you have not created any API Key before).

Access the vMonitor Platform Product portal: https://hcm-3.console.vngcloud.vn/vmonitor/
Select Integration => then choose API Key.

Select Create an API Key to create a new one (if you have not created any API Key before).

Step 2: Download Agent Installer

Access the link to download the agent installer:: https://github.com/vngcloud/vmonitor-metrics-agent/releases/download/1.23.0-1.4.0/telegraf-nightly_windows_amd64.exe

Step 3: Install Agent

Run the agent installer.
After receiving the notification, select More Info.

Then select Run anyway to start installing the agent.

Select Next to continue.

Return to the vMonitor Platform portal, in the API Key section, select the copy icon to copy the API Key information.

Paste the API Key information into the credentials entry field.

You can customize the installation folder if needed.

Select Accept the license, then click Next to continue.

You can customize the shortcut menu name for the agent, then select Next to continue.

Select Install to begin the installation.

Select Yes to grant permissions for the agent to operate.

After the installation process is complete, select Finish.

Step 4: Verify Agent Operated

Access the vMonitor Platform portal, select Infrastructure list => choose Host, then check if the hostname of the VM has appeared in the list.