# Ansible Automation Platform AWX Integration

[Ansible Automation Platform](https://www.redhat.com/en/technologies/management/ansible) is a comprehensive toolset for automating IT tasks, such as configuration management, application deployment, and orchestration. It provides a scalable framework for automating workflows across diverse systems and environments, simplifying complex processes and enhancing operational efficiency. Here's a guide on enabling ilert's multi-channel alerting for the Ansible Automation Platform.

## In ilert: Create an Ansible Automation Platform alert source&#x20;

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 **Ansible Automation Platform** in the search field, click the Ansible Automation Platform 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%2FTSWq5qvOn8gAYSUbR5us%2F1-il.png?alt=media&#x26;token=f08eb085-5ca5-4972-8b9d-8345fc371278" alt=""><figcaption></figcaption></figure>

## In Ansible Automation Platform: Create a Notification Template

1. On the sidebar, click on **Notifications**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FKiy0eaVbTI4VM7DVi9ut%2F1.png?alt=media&#x26;token=67af5fe3-d506-4961-a287-af827cda940a" alt="" width="563"><figcaption></figcaption></figure>

2. On the next page, click **Add** to add a new notification template.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FKuLQJHjyJiAh1Ujq9MpU%2F2.png?alt=media&#x26;token=ebacfb7a-50c8-4a38-a9e5-15b83948e393" alt="" width="563"><figcaption></figcaption></figure>

3. Enter a **Name** and change the **Type** to 'Webhook.'

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FatE0gwuzGKisxrlpn8if%2F3.png?alt=media&#x26;token=afe060b2-1403-449b-a6da-5cfeceff78a9" alt="" width="563"><figcaption></figcaption></figure>

4. Scroll down to the **Type Details** and enter the previously created alert source URL into the **Target URL** field.
5. Change the **HTTP Method** to 'POST'.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FyT6N0E1i42Vw88DSPlfv%2F4.png?alt=media&#x26;token=c7d1a2ab-b2f8-45e7-a4ea-5e06dfa4b75c" alt="" width="563"><figcaption></figcaption></figure>

6. Optional: You can send a test notification by clicking the **Test** button.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FBHSy0g5bKmmRFLpKCHVV%2F5.png?alt=media&#x26;token=8df195b5-d019-424d-b0d5-a114d62f8661" alt="" width="563"><figcaption></figcaption></figure>

7. Navigate back to your projects and click on one of the desired projects.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F0eruv0fS1rVJbzZeUvPO%2F6.png?alt=media&#x26;token=df7d2f22-5609-4dd4-8776-b242c18d9a08" alt="" width="563"><figcaption></figcaption></figure>

8. On the navigation bar, click on **Notifications** and enable 'Failure' for the just-created notification template.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F4bw2HlaWW10LVnNMjK5x%2F7.png?alt=media&#x26;token=52d561a6-807c-4808-bbf7-5c48a38cc155" alt="" width="563"><figcaption></figcaption></figure>

## FAQ

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

Unfortunately, the Ansible Automation Platform notification template is not compatible with ilert's resolve event.
