# Alibaba CloudMonitor Integration

[Alibaba CloudMonitor](https://www.alibabacloud.com/en/product/cloud-monitor) integration allows you to route monitoring alerts from Alibaba Cloud directly into ilert. By combining CloudMonitor’s metrics with ilert’s alerting, on‑call scheduling, and incident workflows, you ensure that the right people are notified immediately, context is preserved, and incidents close automatically when CloudMonitor reports recovery, reducing MTTR and eliminating noise.

### In ilert: create an Alibaba CloudMonitor alert source

1. In ilert, go to **Alert sources → Alert sources** and click **Create new alert source**.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FjX0cS4q7woTXKajZmc1W%2FScreenshot%202023-08-28%20at%2010.21.10.png?alt=media&#x26;token=8ef3666b-84eb-4b51-abee-f07303313941" alt=""><figcaption></figcaption></figure>
2. Search for **Alibaba CloudMonitor**, select the tile, and click **Next**.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FlXzQlJpaTFSR49AZk0xA%2FScreenshot%202023-08-28%20at%2010.24.23.png?alt=media&#x26;token=cffeacb4-57b9-47d4-827d-b0f6b1afd914" alt=""><figcaption></figcaption></figure>
3. Enter a **Name** for the alert source, optionally assign a **Team**, and click **Next**.
4. Select or create an **Escalation policy**, then click **Next**.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FNnuZqONaIhbOf6fn4OkZ%2FScreenshot%202023-08-28%20at%2011.37.47.png?alt=media&#x26;token=8a74f7b5-5bd2-4eea-97fa-1c1dbb041333" alt=""><figcaption></figcaption></figure>
5. Choose your [**Alert grouping** ](https://docs.ilert.com/alerting/configure-alerting/alert-sources/using-ilert-ai-for-alert-grouping)preference (you can modify this later) and click **Continue setup**.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FueugN4JgHn1c90ggFA6u%2FScreenshot%202023-08-28%20at%2011.38.24.png?alt=media&#x26;token=b8009daf-3ca8-4264-a6fa-e42ef7333205" alt=""><figcaption></figcaption></figure>
6. Adjust any additional settings, such as **Notification priority** or **Custom alert templates**, then click **Finish setup**.
7. Copy the generated **Webhook URL** (or API key). You will paste it into CloudMonitor later.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FUvddbxryQlkoqhHrQ3jQ%2Fil-1.png?alt=media&#x26;token=c8b25bf2-0b76-4a02-8676-e4052ff94c43" alt=""><figcaption></figcaption></figure>

### In Alibaba CloudMonitor: create an alert contact and alert contact group

1. In the CloudMonitor console, open **Alert contacts**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fi3R2DyY7q5pT8xnupJt9%2F1.png?alt=media&#x26;token=6ef4d1be-7666-429b-8eb6-6d89693b77a0" alt=""><figcaption></figcaption></figure>

2. Click **Create alert contact**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FMvvh03S2X1S8qwk528Wo%2F2.png?alt=media&#x26;token=eff48a6f-32f2-4014-97a7-946f4581af34" alt=""><figcaption></figcaption></figure>

3. Enter a **Name** and paste the ilert webhook URL into the **Webhook** field.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FXvxwFVJevL5JMNJBzSrp%2F3.png?alt=media&#x26;token=a0504d39-f352-4c42-97e8-10bf731d04ce" alt=""><figcaption></figcaption></figure>

4. Enable the contact (toggle the slider) and click **OK**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FnShxmhICd3ZJwLvu16hT%2F4.png?alt=media&#x26;token=683d9764-f881-4a41-bbd0-e99d69a01990" alt=""><figcaption></figcaption></figure>

5. Go to **Alert contact groups** and click **Create alert contact group**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FwTmjyoaoPvJXIxtFkec3%2F5.png?alt=media&#x26;token=7699708a-77ce-4bdc-ad12-3a6ca5082a76" alt=""><figcaption></figcaption></figure>

6. Provide a **Group name**, add the contact you just created, and click **Confirm**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FjjuehYoeDMDIYzjH3bVd%2F6.png?alt=media&#x26;token=903d26f4-2a30-4117-b24c-bae1ad085cdd" alt=""><figcaption></figcaption></figure>

7. Click **Confirm**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FBWHlC25gLopB9rqmF4Tv%2F7.png?alt=media&#x26;token=cb117eef-c936-4c4c-9690-abb286346f73" alt=""><figcaption></figcaption></figure>

### In Alibaba CloudMonitor: assign the alert contact group to an alert rule

1. On the sidebar, navigate to **Alert Rules**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FOw6ISH0Nbr6tmmKQWSkz%2F9.png?alt=media&#x26;token=932228a9-0b7c-4c87-8820-f7d9780b51e6" alt=""><figcaption></figcaption></figure>

2. Select or create an **Alert Rule**.
3. Head to the **Alert Contact Group** field and select the previously created Alert Contact Group.
4. Click **Confirm** to finish the setup.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FcVCwLYMlqWWQHB5rKl9o%2F10.png?alt=media&#x26;token=cb457a16-8d38-432f-9870-453f1bf30149" alt=""><figcaption></figcaption></figure>

### FAQ <a href="#faq" id="faq"></a>

**Q: Will alerts in ilert be resolved automatically?**

A: Yes, as soon as Alibaba CloudMonitor sends a notification with the `alertState` field set to `OK`, the corresponding alert in ilert will be resolved.
