For the complete documentation index, see llms.txt. This page is also available as Markdown.

Uptime Kuma Integration

Send Uptime Kuma monitoring alerts into ilert to notify on‑call responders about downtime or service issues quickly.

Connecting Uptime Kuma to ilert allows uptime failures – such as service downtime or unreachable hosts – to generate technical alerts for on-call teams. Escalations are automated to reduce response time and improve overall availability.

In ilert: Create an Uptime Kuma alert source

  1. Go to Alerting → Alert sources and click Create new alert source.

  2. Search for Uptime Kuma, click its tile, and click Next.

  3. Give your alert source a name, optionally assign teams, and click Next.

  4. Choose who gets notified: select Use existing escalation policy and pick a policy, or Generate new escalation policy to start with a basic one that notifies you first. Click Next.

    The escalation step of the ilert alert source wizard, headed Who should be notified about alerts, with an escalation policy selected and a preview of its escalation rules below.
    Pick an existing escalation policy, or generate a basic one without leaving the wizard.
  5. Select Default grouping and click Continue setup. It groups events by the alert key the integration sets; the other grouping options are easier to judge once events are arriving.

  6. The next page shows more settings, such as notification priority and alert templates. Click Finish setup for now; you can change them later.

  7. On the final page, ilert shows the integration key and URL for this alert source. You will need them later in this guide.

In Uptime Kuma: Add ilert Webhook

  1. Select any monitor you want to send notifications from.

  1. Click on Edit

  1. Now click on Setup Notification

  1. Choose Webhook in the Notification Type field

  2. Add a Friendly Name for your the notification

  3. In Post URL add the previous created Uptime Kuma URL

  4. Choose application/json as Content Type

  1. Optional: click on Test to test the notification

  1. Click on Save to finish the Setup

FAQ

Will alerts in ilert be resolved automatically?

Yes, as soon as the monitor in Uptime Kuma sends an "OK" notification, the associated alert is automatically resolved in ilert.

Last updated

Was this helpful?