# Integration with Pingdom

### Overview

The integration between MangoApps and Pingdom via webhook URL allows for seamless and automated communication of business-critical alerts and notifications from Pingdom into MangoApps, serving several key purposes. It ensures real-time centralized alerting by instantly delivering and consolidating alerts within MangoApps, enhances collaboration and reduces response time by informing teams directly within MangoApps, and helps build a searchable knowledge base that aids in onboarding future team members. 

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

This integration supports Pingdom editions: Starter, Standard, and Advanced.

***

### Role Prerequisites for Setting Up This Integration

To set up this integration, three key roles are required:

* **Pingdom Administrator**: The user responsible for setting up the monitoring and MangoApps webhook URL to receive notifications.
* **MangoApps Administrator**: The user who will enable the integration at the domain level.
* **MangoApps Team Admin**: The user who will configure the integration.

***

### Instructions to Setup Pingdom

Login as a Pingdom Admin, then navigate to settings to set up the MangoApps webhook URL.

<figure><img src="/files/EjS7ZVJYWmxO76itiVxf" alt="" width="563"><figcaption></figcaption></figure>

To monitor uptime for Network, Web, or Email, select **Uptime**.&#x20;

<figure><img src="/files/ftpNX9ANfKVi49fY2obU" alt="" width="563"><figcaption></figcaption></figure>

Define the monitoring metrics under **Add Uptime Check** by providing a name to the metrics you plan to monitor. Set the check interval to define the probing frequency.&#x20;

<figure><img src="/files/MShFA6sRnKYv7bzqq7xS" alt="" width="375"><figcaption></figcaption></figure>

Specify the web URL to be monitored and select the servers to run the monitoring test.

<figure><img src="/files/si5RxilPhrNrVGCqXSIe" alt="" width="375"><figcaption></figcaption></figure>

Ensure the webhook integration is selected to allow Pingdom to send notifications to MangoApps. Run a test to confirm that URL monitoring is set correctly. Then, create a check to complete the uptime metrics setup, ensuring notifications are sent to MangoApps.

<figure><img src="/files/xZfGy4OxHdFD17mnQKby" alt="" width="375"><figcaption></figcaption></figure>

After successfully setting up the uptime check metrics, the Pingdom dashboard will display the configured settings.

<figure><img src="/files/OrgPeQj5qV533phnTBpD" alt="" width="563"><figcaption></figcaption></figure>

***

### **Configuration for Domain Admin of MangoApps**

Open the admin portal, navigate to the Integrations section, and toggle **Pingdom** to **ON**.

<figure><img src="/files/1zQEBCKhltnKGzEuTyQf" alt="" width="563"><figcaption></figcaption></figure>

***

#### **Set Up Widget**

The network administrator needs to set up the Pingdom widget for the HOME page by adding it from the widget gallery. Configure the widget by adding a header image and setting visibility for a specific user segment or for everyone.

<figure><img src="/files/Jh9U0HlXa1IxzZnWiyYi" alt="" width="563"><figcaption></figcaption></figure>

***

### **Configuration for Teams Admin of MangoApps**

To enable the Integration within a workspace, the team admin should navigate to the relevant workspace on MangoApps and enable the integration by clicking on **Admin Tools > Configure Integrations > Pingdom Settings**.

<figure><img src="/files/colMI0e3Cs40rUEdeTCh" alt="" width="563"><figcaption></figcaption></figure>

Copy the webhook URL to complete the configuration on Pingdom’s end.

<figure><img src="/files/IaApluFaR4muYLWzMHZQ" alt="" width="375"><figcaption></figcaption></figure>

***

### End User Experience

Your MangoApps domain team members will start receiving uptime check notifications as soon as the site goes down. Notifications on feeds will include:

* **Alert**: Unique ID generated with each Pingdom notification event, including a user-defined customized message.
* **Host**: The system being monitored.
* **Status**: Indicates when the host is “Down”.
* **Description**: User-defined customized message.
* **Reported On**: Date-time when the event occurred and was reported to MangoApps.

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXdKmD7cu4W_tE92M3trNUxqbf5KtQo301i81k06gPNaRT_5to1IUtwJ46sEExDFcSraAcWlxmeNu5XG5zV9MquZ8Ce66f8etJ_wVz2uQ_xnkNKjRla-RkqnegygT_-UZY6LdNWCYGvXZFfz9TCxhE-IFiU8?key=5_1o-xEwDKH9GKYBhZYdTA" alt="" width="375"><figcaption></figcaption></figure>

Admins can set up a widget at the user segment level so that logged-in users in the segment will see the widget with alerts and updates.&#x20;

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXdKmD7cu4W_tE92M3trNUxqbf5KtQo301i81k06gPNaRT_5to1IUtwJ46sEExDFcSraAcWlxmeNu5XG5zV9MquZ8Ce66f8etJ_wVz2uQ_xnkNKjRla-RkqnegygT_-UZY6LdNWCYGvXZFfz9TCxhE-IFiU8?key=5_1o-xEwDKH9GKYBhZYdTA" alt="" width="375"><figcaption></figcaption></figure>

MangoApps users can search for Pingdom notifications using a search term from the feed reply.

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

***

### Testing Considerations

A team admin or network admin can test the integration by having the Pingdom Admin run a test when setting up the uptime check metrics.

***

### Security Considerations

The MangoApps Team Admin should securely share the webhook URL with the Pingdom Admin.

***

### Rollout Recommendations

Once the MangoApps Pingdom integration is complete, team members can view news feeds for all notifications from Pingdom in the MangoApps teams where the integration is enabled. Ensure that all necessary IT/SRE team members are part of the team where this integration is set up.


---

# 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://guides.mangoapps.com/integrations-guide/workspace/integration-with-pingdom.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.