Guide
Map and Route Alerts
Turn an incoming payload into a usable OpsBell alert with the right summary, severity, scope, and destination.
Before you start
- Open a source that already has a real sample attached.
- Decide whether the source should always go to one system or function, or should look that up from the payload.
Do this
- Open the source and go to
Mapping. - Map the fields responders need most: summary, body, severity, status, dedupe key, external id, environment, and source URL.
- Map labels if you want searchable tags carried across from the source.
- Choose the binding mode in
Routing:Match from payloadwhen the payload contains system or function keys.Always route to one systemwhen the source is dedicated to one service.Always route to one functionwhen the source always represents one flow.Leave unboundwhen you want to ingest first and classify later.
- If you use payload lookup, set the system and function key paths and any fallback paths you need.
- Review severity and status mapping overrides if the sender uses non-standard values.
- Save the source and send a test event.
Check it worked
- The alert summary is readable without opening raw payload data.
- The alert lands on the correct system or function.
- Repeated alerts dedupe the way you expect.
- The environment and labels match the incoming event.
If it does not work
- If the alert lands in the wrong place, fix binding mode and key paths before you change ownership or paging.
- If duplicates keep opening, check the dedupe key and external id mapping.
- If severities look wrong, add explicit severity map entries instead of relying on guesswork.
