# Linux 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 the vMonitor Platform.

{% hint style="info" %}
**Chú ý:**

* Please note that you need to have a Metric Quota. If you do not have one, you need to purchase a Metric Quota [here](/vng-cloud-document/vmonitor/dashboards/metrics/lam-viec-voi-metric-quota.md).
  {% endhint %}

### Telegraf Agent with Service Account

1. **Creating a Service Account and Attaching policy: the vMonitorMetricPush to Push Metrics to vMonitor.**

To create a service account, visit [this link](https://hcm-3.console.vngcloud.vn/vmonitor).

* 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**. This policy, created by GreenNode, contains the exact permissions needed to push metrics to the system.
* After successfully creating the Service Account, save the **Client\_ID** and **Secret\_Key** for the next step.

2. **Replacing Client\_ID, Secret\_Key into the inline command and running on the server to install:**

Use the Client\_ID and Secret\_Key you copied above, replacing them in the corresponding **$IAM\_CLIENT\_ID** and **$IAM\_CLIENT\_SECRET** fields in the command below. Run this command on the server that needs to be monitored, making sure to execute it with **root user** privileges (if not, prepend sudo to the command).

```
VMONITOR_SITE=monitoring-agent.vngcloud.vn \
IAM_CLIENT_ID=$IAM_CLIENT_ID \
IAM_CLIENT_SECRET=$IAM_CLIENT_SECRET \
IAM_URL=https://iamapis.vngcloud.vn/accounts-api/v2/auth/token \
bash -c "$(curl -L https://raw.githubusercontent.com/vngcloud/vmonitor-metrics-agent/main/install.sh)"
```

3. **After running the command and completing the installation, you will see the server in the Infrastructure List/Host page.**

<figure><img src="/files/3hO00p01tHawOoXvd8CN" alt=""><figcaption></figcaption></figure>

### **Telegraf Agent with API\_KEY (deprecated**) <a href="#linuxos-telegrafagentvoiapi_key-deprecated-khongkhuyencaosudung-saptoisedunghotrovoiphuongthucnay" id="linuxos-telegrafagentvoiapi_key-deprecated-khongkhuyencaosudung-saptoisedunghotrovoiphuongthucnay"></a>

{% hint style="info" %}
**Notice:**

* We do not recommend using this method as our system will soon discontinue support for API Keys.
  {% endhint %}

* This is an older method supported by Telegraf with API\_Key, which will soon be deprecated.

* Visit the Integration/API Key page to create and obtain an API Key.Select **Create an API Key**, name the API Key, click **Create**, and then copy the API Key for use.

* Replace the copied API Key in the command below and run it on the server:

```
API_KEY=$API_KEY bash -c "$(curl -L https://raw.githubusercontent.com/vngcloud/vmonitor-metrics-agent/v1-stable/install.sh)"
```

* After running the command and completing the installation, you will see the server in the **Infrastructure List/Host** page.

<figure><img src="/files/J8XdKYEHXAXaZKYgipX8" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/tzD2e0HxdV1bRojjVTjh" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vngcloud.vn/vng-cloud-document/vmonitor/dashboards/metrics/lam-viec-voi-metric-agent/cai-dat-metric-agent-tren-server/linux-os.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.