Skip to main content
Use the NetBeez webhook integration to send network monitoring alerts and incidents to Flashduty On-call. NetBeez sends every alert and every incident as an open notification followed by a cleared notification: the open notification triggers a Flashduty alert, and the cleared notification recovers the same alert.

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 NetBeez 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 NetBeez 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

Configure NetBeez

1

Enable the webhook integration in NetBeez

Where: NetBeez › Settings › Integrations › WebhooksSign in to NetBeez as an administrator (webhooks require BeezKeeper 13.0 or later).The test function on that page only proves the URL is reachable: NetBeez sends sample data, and Flashduty treats only requests with an event type (event_type or event) as alerts. Other requests get a success response and create no alert.
2

Choose the notification types to send

Where: NetBeez › Settings › Integrations › Webhooks (notification settings)NetBeez sends every alert and every incident as a pair of “open” and “clear” notifications. Recovery needs no separate setting, but the matching type must be selected.
Alerts and incidents are separate notifications. If you select both for the same network problem, Flashduty creates two alerts. To respond by incident only, select only the incident notifications.
3

Cause a real failure and verify

Make a Target or Agent fail (for example, temporarily disable an Agent), confirm that Flashduty receives an active alert, then restore it and confirm the original alert is closed. The checklist item “Receive the first event” is then complete as well.

Payload fields

NetBeez POSTs application/json with a single data field: an object for a single notification, an array for an aggregate notification. Flashduty parses it directly, so no template is needed. The alert title is “object name: message”. The object name is the first non-empty of target, wifi_profile, agent and destination.

Alert key

  • Alert notifications use alert_dedup_id. NetBeez documents that the open and cleared notifications of one alert share it, so grouping by it is enough.
  • Incident notifications use the object type, the object ID and incident_ts. incident_ts is always the incident start time and is the same in the open and cleared notifications. NetBeez also suggests correlating incidents by incident_id, but the cleared example in its documentation carries a different incident_id from the open one, so Flashduty does not depend on it and keeps incident_id only as a label.
  • Alert and incident Alert Keys never overlap, and changing the object name, message or severity does not change the Alert Key.
If an alert notification has no alert_dedup_id, or an incident notification has no object ID or incident_ts, Flashduty returns a parameter error because the cleared notification could not be matched to its alert reliably.

Status and severity

NetBeez documents only that open alerts have a severity of at most 5 with names such as alert and critical, and does not publish a full table, so only 1 and 2 map to Critical. To change a severity, rewrite it with a rule under the channel’s Configuration.

FAQ

Flashduty processes the events in timestamp order, oldest first (alert_ts for alerts, event_ts for incidents), so the open event of an alert is handled before its cleared event and the alert ends up recovered.
The NetBeez test sends sample data. Flashduty treats only requests that contain event_type or event as alerts and returns success without creating an alert for anything else. If the sample is recognized as an alert, close it manually in Flashduty.
No. NetBeez retries on non-2xx responses, the Alert Key of an event does not change, and repeated deliveries merge into the same alert.

Troubleshooting

  • NetBeez fails to deliver: confirm the webhook URL is the full push URL and includes integration_key
  • Flashduty returns a parameter error: confirm the body has data, alerts carry alert_dedup_id, and incidents carry an object ID and incident_ts
  • An alert does not recover: confirm the matching type is selected in NetBeez so its cleared notification is sent (open and cleared notifications share one notification type)
For the field reference, see the NetBeez documentation NetBeez Webhook Payloads Reference.