# PandoraFMS Integration

Connecting [Pandora FMS](https://pandorafms.com/en/) to ilert allows technical alerts – such as high CPU, disk full, or service downtime – to be forwarded to on-call staff. This enables fast diagnoses, structured escalation, and improved operational resilience across hybrid environments.

## In ilert: Create a PandoraFMS alert source

1. Go to **Alert sources** --> **Alert sources** and click on **Create new alert source**

   <figure><img src="/files/rmL9OoRxcWnDwcJZQm4Y" alt=""><figcaption></figcaption></figure>
2. Search for **PandoraFMS** in the search field, click on the PandoraFMS tile and click on **Next**.

   <figure><img src="/files/1WoRRYB5U40PbeMJ7Hit" 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="/files/y4Bakf2apGhBN56U8ZPR" alt=""><figcaption></figcaption></figure>
5. Select you [Alert grouping](/alerting/configure-alerting/alert-sources.md#alert-grouping) preference and click **Continue setup**. You may click **Do not group alerts** for now and change it later.

   <figure><img src="/files/nTlB0ZCIW1SP3dj6P9nO" alt=""><figcaption></figcaption></figure>
6. The next page show additional settings such as customer alert templates or notification prioritiy. Click on **Finish setup** for now.
7. On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.

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

## In PandoraFMS: Add ilert Webhook as Alert Command

1. Download our script pandorafms\_ilert.sh.\
   Download links:\
   [Pandora FMS modules library](https://pandorafms.com/library/)\
   [ilert Pandorafms](https://github.com/iLert/ilert-pandorafms)
2. Save this script into the following path :

   ```
   [SERVER_INSTALLATION_PATH]/pandora_server/util/ilert/
   ```
3. In the sidebar, go to **Alerts** -> **Commands** and click on the **Create** button.
4. Enter a **Name** for the command.
5. In the **Command** field enter: \\

   ```
   sh /usr/share/pandora_server/util/ilert/pandorafms_ilert.sh "_field1_" "_field2_" "_id_alert_" "_field3_" "_field4_" "_timestamp_" "_alert_text_severity_" "_agentname_" "_module_" "_data_"
   ```
6. In the **Description** field enter:\
   `_field1_ : ilert alert source API key.`\
   `_field2_ : Type of the created event. Can be "alert" or "resolved".`\
   `_field3_ : Title of the event.`\
   `_field4_ : Description of the event.`

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

7. Enter following field descriptions:\
   **1 field description**: `ilert API Key (click on the hide checkbox, to keep the Key secure)`\
   \`\`**2 field description**: `Event Type`\
   **2 field values**: `alert,Alert;resolved,Resolved`\
   **3 field description**: `Title`\
   **4 field description**: `Description`

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

8. Save the command by clicking on the **Create** button.
9. In the sidebar, go to **Alerts** -> **Actions** and click on the **Create** button.
10. Enter a **Name** for the action. Select a **Group** and select a the previous made **Command**.

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

11. For **ilert API Key** enter the API Key created in ilert on [this step](#in-ilert-create-pandorafms-alert-source).
12. Depending on the section **Triggering/Recovery** set the **Event Type** to Alert/Resolved
13. Enter a **Title** and a **Description**.

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

14. Save the Action by clicking on the **Create** button.
15. In the sidebar, go to **Alerts** -> **Templates** and click on the **Create** button.
16. Enter a **Name** for the Template, assign a **Group** and set a **Priority**.

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

17. On the next step, select our created action as **Default action**.
18. Set a **Condition type** and a **Value**(dependent on the type) for the event to get fired.

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

19. On the next step, enable **Alert recovery** to activate the automatical alert recovery in ilert.

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

20. Create the template.
21. In the sidebar, go to **Alerts** -> **List of Alerts** and click on the **Create** button.
22. Enter a **Agent**, the **Module**, the previous created **Action**, and the **Template**.

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

23. Click on **Add alert** to finish the integration.

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

## FAQ

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

Yes, as soon as a module has been recovered, the alert in ilert will be resolved automatically. Make sure to fill out the **Recovery** fields in **Alert Action** and enable **Alert recovery** in **Templates** in [PandoraFMS](#in-pandorafms-add-ilert-webhook-as-alert-command).


---

# 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.ilert.com/integrations/inbound-integrations/pandorafms.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.
