# HI GIO's Monitoring Alert - Email notification channel

## <mark style="color:green;">**Overview**</mark> <a href="#overview" id="overview"></a>

This function is designed to enable users to create rules for receiving notifications if the statuses of VMs exceed or fall below specific thresholds. The resources that can be monitored and notified are:&#x20;

*- CPU Usage.*&#x20;

*- Memory Usage.*&#x20;

*- Free Disk Space.*&#x20;

## <mark style="color:green;">**Procedure**</mark> <a href="#procedure" id="procedure"></a>

{% tabs %}
{% tab title="I. Creating Alert Contact Destination" %}
The recipients will receive notifications when the alert is triggered. &#x20;

* Log in to HI GIO cloud > **Monitor**
* Select **Manage**, and Select **NEW** below the *Alert Contact Destination* section.

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

* A new Alert Contact Destination will open. Fill up contact information to this window> **SAVE**

<figure><img src="/files/61HNAbiGjPZ1RanrxF4L" alt=""><figcaption></figcaption></figure>

\*\* Please add <no-reply-iam@higiocloud.vn> to the email whitelist.

{% hint style="warning" %}

#### *<mark style="color:blue;">Requirement fields explanation:</mark>* <a href="#requirement-fields-explanation" id="requirement-fields-explanation"></a>

**Name**: The name of the contact destination.&#x20;

**Integration**: The channel where users can receive alerts. In this version, there is only 1 channel available: Email.&#x20;

**Email Address:** &#x20;

* The email address of the persons who will receive the alert email.&#x20;
* We can add multiple email addresses but only add 1 email at a time. After inputting a correct email address and pressing the Enter key, the email address will be added to the text area below, and then we can add another one.&#x20;

**Email Subject:** The alert email’s subject.&#x20;

**Send a single email to all recipients** check box:

* If checked, 1 email will be sent to all recipients. All recipients will be displayed in “To“ field.
* If not checked, each recipient will receive a separate email >> We don’t know who gets the notify email.
  {% endhint %}
  {% endtab %}

{% tab title="II. Creating Alert rule" %}
An alert rule is a configuration that defines conditions under which an alert should be triggered.&#x20;

* Log in to HI GIO cloud > **Monitor**
* Select **Manage**, and Select **NEW** below the *Alert Rules* section.

<figure><img src="/files/8Vz7LKEUiVK35J2L6mni" alt=""><figcaption></figcaption></figure>

* New Alert Rule window will open. Fill up the information in this window> **SAVE**

<div align="left"><figure><img src="/files/mvq8L16AYyCD4p4IhpBQ" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}

#### *Requirement fields explanation:* <a href="#requirement-fields-explanation-.1" id="requirement-fields-explanation-.1"></a>

**Name**: The name of the rule.&#x20;

**Item**: The resource that triggers the alert. For example, CPU.&#x20;

**Threshold**: Specify specific values or ranges that activate the alert. For example, 90% (meaning that if CPU usage exceeds 90%, the alert will be triggered).&#x20;

**oVDC**: Specify the oVDC.

**VM**: Specify the VM that triggers the alert. The select box will contain all VMs in the oVDC and **/.\*/** option indicates the selection of all VMs.&#x20;

**Pending Period:** &#x20;

* The duration for which an alert remains pending after being triggered. &#x20;
* During this pending period, Grafana allows time for conditions to potentially resolve on their own before considering the alert fully triggered or resolved. &#x20;
* This feature helps avoid unnecessary alert notifications for transient issues. &#x20;
* The default value is 3m.&#x20;

*For example,* Pending Period = 3m → means that if the CPU exceeds 90%, the system will wait 3 minutes. Within 03 minutes, if the CPU falls behind 90%, no alert will be fired. The alert will only be fired if the CPU exceeds 90% after a 3-minute.&#x20;

**Repeat Interval:** &#x20;

* It specifies how frequently the system checks whether the conditions for triggering the alert are still met after the initial alert firing.&#x20;
* If the conditions remain true during these intervals, the system continues to send notifications at the specified repeat interval until the alert condition is no longer met or resolved.&#x20;
* For example, Repeat Interval = 4h and the condition is CPU exceeds 90% → meaning that after an alert is first fired, the system will continue to fire the alert every 4 hours as long as the CPU still exceeds 90%.&#x20;

**Annotation** – Summary, Description: The alert email’s content.&#x20;

**Alert Contact Destination:** The destination where the alert will be sent. The select box contains all the created contact destinations.
{% endhint %}

* After it is completed, the alert rule will show as below:

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

We also can activate\deactivate the rules directly from this list.&#x20;

{% hint style="warning" %}
Update the VM field If you rename the VM’s name on the porta

**Alert Rule** will not automatically update the VM’s name on the VM field.
{% endhint %}
{% endtab %}

{% tab title="III. Notification Emails" %}
Every threshold reaches the defined in the alert rule. we will get the email notification - **Firing Instance**\\**Resolved Instances**.

<figure><img src="/files/xLN2uew1RjjZueco7lvT" alt=""><figcaption><p>Sample email - Firing Instance.</p></figcaption></figure>

&#x20;

<figure><img src="/files/OFWTvHxd6rFmVA9lHKyO" alt=""><figcaption><p>Sample email - Resolved Instances.</p></figcaption></figure>

{% endtab %}
{% endtabs %}


---

# 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.higiocloud.vn/management/1.-iam-portal/hi-gios-monitoring-alert-email-notification-channel.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.
