Guide
Use Diagnostics and Replay
Validate mapping changes safely before you rely on a source during a real incident.
Before you start
- Open the source you want to validate.
- Save your latest mapping and routing changes first.
Do this
- Open the source and review
Diagnosticsto see how Beacon is parsing the payload and provider profile. - Check for missing field paths, unmapped severity values, or binding errors before you replay.
- Open
Replayand run the saved sample back through the source. - Inspect the replay result and confirm the generated alert summary, scope, environment, and dedupe behavior.
- If the result is wrong, return to
MappingorRouting, fix the paths, and replay again. - Use replay until the output matches what you want operators to see during a live event.
Check it worked
- Replay produces the alert you expected.
- Diagnostics no longer show the field or binding issues you were chasing.
- You can explain how the source will behave before sending it live.
If it does not work
- If replay fails immediately, make sure the source still has a valid sample attached.
- If field mapping looks partially correct, fix one field at a time and replay after each change.
- If the provider profile is wrong, correct that first because diagnostics will be misleading otherwise.
