# ClusterControl Integration

[**ClusterControl**](https://docs.severalnines.com/docs/clustercontrol/) by [**Severalnines**](https://severalnines.com/) is a comprehensive database operations orchestration platform designed to manage the entire lifecycle of open-source and proprietary databases in various environments, including on-premises, cloud, and hybrid setups. With this integration, you can send alerts from ClusterControl to ilert and notify engineers about critical issues via phone calls, SMS, push, and other types of notifications.&#x20;

## In ilert: Create a ClusterControl alert source <a href="#create-alarm-source" id="create-alarm-source"></a>

1. 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 **ClusterControl** in the search field, click the ClusterControl tile, and then **Next**.&#x20;

   <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. Give your alert source a name, optionally assign teams, and click **Next**.
4. Select an **escalation policy** by creating a new one or assigning an existing one.

   <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. Select your [Alert grouping](https://docs.ilert.com/alerting/configure-alerting/alert-sources#alert-grouping) preference and click **Continue setup**. You may click **Do not group alerts** for now and change it later.&#x20;

   <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. The next page shows additional settings, such as customer alert templates or notification priority. Click **Finish setup** for now.
7. On the final page, an API key and/or webhook URL will be generated. You will need it later.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F3DqtnkUAqTgpwv35X6XW%2Fil-1.png?alt=media&#x26;token=7a3d0034-1ade-4ea7-9e71-cbbf4b152814" alt=""><figcaption></figcaption></figure>

## In ClusterControl: Create a Webhook

1. On the sidebar, click on **Settings** **->** **Notification services**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FrJixjFkZ4vAVdOsWyVkU%2F1-1.png?alt=media&#x26;token=33ddd7bb-5282-4012-9dbb-341deb875091" alt="" width="563"><figcaption></figcaption></figure>

2. Now click **Add new integration**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FTt0r5vhVgIQCabM2nhU3%2F1-2.png?alt=media&#x26;token=e0a6774c-c7c9-48b3-bb66-1c38ef30c93d" alt="" width="563"><figcaption></figcaption></figure>

3. Select **Webhook** and click on **Continue**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FssHKPir2ROAcB54riq7O%2F1-3.png?alt=media&#x26;token=20ffc35e-c283-4d54-ac16-93e539a74dee" alt="" width="563"><figcaption></figcaption></figure>

4. Choose an **Integration name** and enter the previous in ilert created alert source Url into the **Url** field.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fjo0NpphjXWuKAdoN57LP%2F1-4.png?alt=media&#x26;token=dc361921-6170-4b06-884f-a910cbc6c027" alt="" width="563"><figcaption></figcaption></figure>

5. In the last step, choose the desired **Clusters** and **Event Triggers** from which you want to receive a notification.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F5mrihnr4lCb8mwlckz6n%2F1-5.png?alt=media&#x26;token=dd77d160-63ad-4f79-a027-d90d76fd9715" alt="" width="563"><figcaption></figcaption></figure>

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

**Are alerts in ilert automatically resolved?**

Yes, as soon as an event's status is set to ENDED in ClusterControl, the corresponding alert in ilert will be resolved.
