Observability & Debugging

NotiBoost provides full observability to debug and monitor notification flows.

Trace IDs

Each message has a unique trace_id to track the entire lifecycle.

Example: trc_abc123 - use this trace_id to query logs and delivery status.

Audit Logs

Audit logs record every step in the notification lifecycle.

Audit Events

  • event.received - Event has been received
  • rule.matched - Rule has matched
  • flow.triggered - Flow has been triggered
  • message.sent - Message has been sent
  • message.delivered - Message has been delivered
  • message.failed - Message delivery failed

Delivery Status

Track delivery status of each message.

Status Types

  • pending - Pending processing
  • sent - Sent
  • delivered - Delivered successfully
  • failed - Delivery failed
  • retrying - Retrying

Debugging

How to debug notification issues.

Debug Workflow

  1. Get trace_id from event response
  2. Query audit logs by trace_id
  3. Check rule matching
  4. View flow execution steps
  5. Check delivery status and error logs

Replay Events

Can replay events for testing and debugging.

Monitoring

Monitor notification system health.

Metrics

  • Delivery success rate
  • Average delivery time
  • Error rate by channel
  • Quota usage per channel

Alerts

Alerts when issues occur:

  • High failure rate
  • Quota running low
  • System errors