Skip to content

Honeycomb

Honeycomb trigger webhooks POST JSON to Exhale. Each tenant gets a unique HTTPS URL token. Exhale scrubs the payload, upserts a Pulse (source=honeycomb), and runs triage when the trigger status maps to TRIGGERED / ALARM / similar.

See Incoming integrations for how Honeycomb fits alongside PagerDuty, New Relic, and Manual webhook.

OpenAPI: POST /webhooks/honeycomb (header token) and POST /webhooks/honeycomb/{token}.


Endpoint

After Connect in Connections → IntegrationsObservability & alertsHoneycomb:

Preferred (keeps tokens out of proxy access logs):

POST https://exhale.kolstromsystems.com/webhooks/honeycomb

Send header X-Exhale-Webhook-Token: {token}.

Path form (also supported):

POST https://exhale.kolstromsystems.com/webhooks/honeycomb/{token}

Design partners may substitute https://exhale-staging.kolstromsystems.com as the host.

  • token — opaque URL segment; this token authenticates the delivery.
  • Response: 202 Accepted with pulse_id, status, created, and message.

Unknown tokens return 404. Disabled or expired-trial tenants return 403.


Customer setup

  1. Sign in as adminConnections → IntegrationsHoneycomb.
  2. Click Connect Honeycomb and copy the webhook URL.
  3. In Honeycomb, open a Trigger, add a Webhook recipient, and paste the Exhale URL.
  4. Include a trigger id or name and a status field.
  5. Send test alert creates a synthetic pulse and marks the integration configured.

Rotate webhook token invalidates the previous URL immediately — update Honeycomb after rotating.


Payload shape

FieldRequiredNotes
id / trigger_id (or name)YesStable id for dedupe (source=honeycomb)
statusNoTRIGGERED, OK, …
nameNoPulse title

Lifecycle mapping

Honeycomb statusPulse status
TRIGGERED, ALARM, firing, breachReceived → triage
OK, CLEARED, resolved, passingResolved

Example

bash
TOKEN="your-url-token"
curl -i -X POST "https://exhale.kolstromsystems.com/webhooks/honeycomb/${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"id":"hc-42","name":"Elevated p99","status":"TRIGGERED"}'

Full detail (dedupe, fixtures, security): Honeycomb webhooks in the repository wiki. Planning track: Observability ingest v2.

Exhale by Kolstrom Systems LLC