Appearance
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 → Integrations → Observability & alerts → Honeycomb:
Preferred (keeps tokens out of proxy access logs):
POST https://exhale.kolstromsystems.com/webhooks/honeycombSend 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, andmessage.
Unknown tokens return 404. Disabled or expired-trial tenants return 403.
Customer setup
- Sign in as admin → Connections → Integrations → Honeycomb.
- Click Connect Honeycomb and copy the webhook URL.
- In Honeycomb, open a Trigger, add a Webhook recipient, and paste the Exhale URL.
- Include a trigger id or name and a status field.
- 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
| Field | Required | Notes |
|---|---|---|
id / trigger_id (or name) | Yes | Stable id for dedupe (source=honeycomb) |
status | No | TRIGGERED, OK, … |
name | No | Pulse title |
Lifecycle mapping
| Honeycomb status | Pulse status |
|---|---|
| TRIGGERED, ALARM, firing, breach | Received → triage |
| OK, CLEARED, resolved, passing | Resolved |
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"}'Related
Full detail (dedupe, fixtures, security): Honeycomb webhooks in the repository wiki. Planning track: Observability ingest v2.