BetterUptime

This guide outlines the steps to integrate StatusPal's monitoring service with BetterUptime's synthetic checks. This integration allows you to receive alerts in StatusPal via webhook

To automate the reporting and closing of incidents on your status page based on the status reported by BetterUptime synthetic checks, follow these steps.

Create your Webhook Integration in StatusPal

First, you need to create an endpoint URL within StatusPal. This URL will act as the bridge between BetterUptime and StatusPal, receiving notifications from BetterUptime about uptime check results via webhook.

• Navigate to Services: On your Status Page, create a new service or edit an existing service.

• Add Webhook: On Monitoring and incident automation section, check on Webhook and select BetterUptime.

• Finish and Save: Create or update the service, then copy the endpoint URL that will be created for you.

Create your Webhook Integration in BetterUptime

Next, you need to create a webhook integration.

• Navigate to Integrations: On the BetterUptime navigation bar, click on Integrations.

• Add a Webhook: Navigate to Exporting data option and choose Webhooks. Then choose do add a Monitor webhook.

• Configure Webhook: On the Webhooks configuration, you'll need to add the endpoint URL provided by StatusPal. This URL is specific to your StatusPal service configuration and is essential for the integration to work correctly. Paste this URL into the appropriate field.

• Payload Configuration: On the Advance settings section, you need to make sure the HTTP Method is set to POST. On the Request body section, please make sure the properties and their values are added and set as we shown here: "type": "incident" and "status": "$STATUS".

• Attention: If you have to configure the body to accommodate other uses, please make sure to keep the same structure as the default template where the data is read as data -> id, type, status...

{
  "data": {
    "id": "$INCIDENT_ID",
    "type": "incident",
    "status": "$STATUS",
    "attributes": {
      "name": "$NAME",
      "url": "$URL",
      "http_method": "$HTTP_METHOD",
      "cause": "$CAUSE",
      "started_at": "$STARTED_AT",
      "acknowledged_at": "$ACKNOWLEDGED_AT",
      "resolved_at": "$RESOLVED_AT",
      "response_content": "$RESPONSE_CONTENT",
      "response_url": "$RESPONSE_URL",
      "screenshot_url": "$SCREENSHOT_URL"
    }
  }
}

Create your Synthetic Monitor Test in BetterUptime

Next, you need to configure your synthetic monitor in BetterUptime and link it to the webhook you just created.

• Navigate to Synthetics: On the BetterUptime navigation bar, click on Monitors.

• Create Uptime Monitor: Click on Create monitor and create a new monitor for the synthetic you want to track. Configure the monitor according to your needs (e.g., check frequency, target URL).

• Add Escalation: On the settings configuration, make sure that on the On-call escalation section, the Critical alert is selected.

That's it! Once you have completed these steps, BetterUptime will send notifications about your uptime checks to StatusPal, allowing you to monitor and manage your service availability from a centralized platform.