Skip to main content
Use a Simple Observability webhook channel to send alerts and recoveries for alert rules, server heartbeats, scheduled jobs, and endpoints to Flashduty On-call. Each monitored object maps to one Flashduty alert: it is created when the object alerts, repeated notifications merge into it, and it is closed when the recovery notification arrives.

In Flashduty On-call

You can get the integration push URL in either of the following ways.

Use a dedicated integration

  1. In the Flashduty console, go to Channels and open a channel
  2. Select Configuration → Integrations → Private integration, then click Add integration
  3. Select Simple Observability and click Save
  4. Open the generated integration card and copy the Push URL

Use a shared integration

  1. In the Flashduty console, go to Integration Center → Alert Events
  2. Select Simple Observability and enter an integration name
  3. Configure the default route and select a channel. You can add more rules under Routing after creation
  4. Click Save and copy the generated Push URL

In Simple Observability

1

Add a webhook channel in Simple Observability

Where: Simple Observability › Channels › Add ChannelAfter saving the channel, click Test on it to verify the URL: the test request has event_type TEST, and Flashduty returns success without creating an alert. This is only a connectivity check.
2

Attach the channel to your alerts

In the notification settings of your alert rules, servers, scheduled jobs, and endpoints, select the webhook channel you just created. Recovery notifications use the same channel and need no separate setting; whether job success (SUCCESS) notifications are sent depends on the job’s notification settings, see the FAQ below.
3

Trigger and confirm the alert lifecycle

Trigger a real alert, for example by making an endpoint unreachable, and confirm that an active alert appears in Flashduty. Then restore the object and confirm that the alert recovers.After a few seconds, go back to Flashduty. If the integration shows a Latest event time, the setup works.
Simple Observability requires your endpoint to return a 2xx status code; otherwise it logs an error, and its documentation does not describe a retry policy. Use the full push URL, including integration_key.

Payload

The webhook POSTs JSON, which Flashduty parses directly without a template. event_type decides which kind of object the alert is about: How the other fields appear in Flashduty:

Alert key

Flashduty uses the object type plus the object ID as the Alert Key, for example endpoint:<data.endpoint.id>. The trigger and recovery notifications for one rule, server, endpoint, or job land on the same alert. Different objects produce different alerts, and objects of different types never affect each other even if their IDs match. Changing the name, severity, description, or time does not change the Alert Key. If the object ID is missing, Flashduty returns a parameter error, because the recovery cannot be reliably matched to its alert. An event_type or status outside the table above is rejected as well.
The Simple Observability documentation shows only the trigger example for each type and does not state that the recovery notification carries the same object ID. Flashduty matches trigger and recovery by the data structure shared within each type. If an alert does not close after recovery, contact us and include the recovery request body.

Status and severity

Rule and job alerts carry a null severity, so they are treated as Warning. A recovery notification (RESOLVED, SERVER_UP, ENDPOINT_UP, SUCCESS) closes the alert with the same Alert Key.

FAQ

That depends on your notification settings in Simple Observability. A JOB_ALERT with SUCCESS is treated as a recovery: if the job failed earlier, the original alert is closed. If you do not want success notifications, turn them off for the job in Simple Observability.
No. The test request has event_type set to TEST. Flashduty returns success without creating an alert.
A rule alert produces one Flashduty alert per rule ID. The matching hosts and values are shown on the alert detail page in Simple Observability, which you can reach through the dashboard_url label.

Troubleshooting

  • Simple Observability reports an error: confirm the webhook URL is the full push URL and includes integration_key
  • Flashduty returns a parameter error: the message names the missing object ID or the unsupported event_type or status
  • An alert does not recover: confirm the recovery is sent through the same webhook channel and that its object ID matches the trigger
For field details, see the Simple Observability documentation: Webhook.