Skip to main content

OpenObserve Webhook

The OpenObserve webhook integration lets OpenObserve push alerts into NudgeBee. Each alert becomes a NudgeBee event that can be triaged, correlated with cluster telemetry, and used to trigger automations.

Step 1: Create the Webhook in NudgeBee​

  1. Navigate to Admin > Integrations > Webhooks.
  2. Select Openobserve Webhook and click Add Openobserve Webhook Account.
  3. Fill in the form:
    • Name of OpenObserve Webhook * (Required) — a descriptive name, e.g. openobserve-prod.
    • Select Account * (Required) — the NudgeBee account that should receive these events.
  4. Click Save.

NudgeBee generates a unique webhook URL for the integration, in the same form used by the other inbound webhooks:

https://<your-nudgebee-domain>/api/webhooks/openobserve_webhook?token=<generated-token>
  1. Copy the webhook URL. You will paste it into OpenObserve in the next step.
caution

The token query parameter authenticates the sender. Treat the full URL as a secret — anyone holding it can create events in your tenant. If it leaks, delete the integration and create a new one to rotate the token.

The OpenObserve Webhook tile in the Webhooks tab of the integrations catalog

The OpenObserve Webhook form, which takes only a name and an account

Step 2: Point OpenObserve at the URL​

Create a OpenObserve alert destination in OpenObserve and set its destination to the URL from Step 1:

  • Method: POST
  • Content-Type: application/json
  • URL: the NudgeBee webhook URL, token included

Then attach it to the alert rules whose notifications you want in NudgeBee. Send a test notification if OpenObserve offers one.

Reference: OpenObserve alert destination documentation

Step 3: Verify​

  1. Trigger a test notification from OpenObserve, or wait for a real alert to fire.
  2. In NudgeBee, open Troubleshoot > Events. The event should appear within a few seconds.
  3. Open it and confirm the alert name and severity carried across, and that the impacted workload is linked where the payload identifies one.

Troubleshooting​

SymptomLikely CauseFix
No event appearsOpenObserve cannot reach the NudgeBee URLConfirm the NudgeBee endpoint is reachable from OpenObserve's notification sender. Check egress rules on both sides.
401 or 403 from the endpointThe token parameter is missing or wrongRe-copy the full URL from the integration — the token is part of the query string, and is easy to drop when pasting.
Event appears with no workload linkedThe payload carries no identifier NudgeBee can matchInclude the resource, host or service name in the alert payload so it can be matched to a workload.
Duplicate events for one alertTwo notification rules point at the same URLConsolidate them in OpenObserve, or use separate integrations per environment.
Alerts never resolve in NudgeBeeOnly firing notifications are being sentConfigure OpenObserve to send resolution notifications to the same destination.