Outbound Monitoring and Recovery

Why You Would Use This

Monitoring helps you answer:

• Are deliveries healthy right now?
• Which endpoints are failing?
• Is this transient or persistent?
• Which messages need manual recovery?

Console Workflow

1. Start on Dashboard for high-level health.
2. Open Analytics and filter by endpoint/time window.
3. Open Messages and filter by status (pending_retry, failed_permanent).
4. Inspect message detail for response status and timing.
5. Use Replay Message from message details for manual recovery in the console.
6. Re-check metrics and logs to verify recovery.

API Workflow

API reference:

• Get logs
• Get metrics
• Get time-series metrics
• Get message
• Replay message

1) Fetch logs for diagnostics

curl "https://api.hookbridge.io/v1/logs?status=failed_permanent&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

2) Fetch metrics summary

curl "https://api.hookbridge.io/v1/metrics?window=24h" \
  -H "Authorization: Bearer YOUR_API_KEY"

3) Fetch time-series metrics

curl "https://api.hookbridge.io/v1/metrics/timeseries?window=24h&endpoint_id=YOUR_ENDPOINT_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

4) Inspect and recover a message

curl https://api.hookbridge.io/v1/messages/YOUR_MESSAGE_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.hookbridge.io/v1/messages/YOUR_MESSAGE_ID/replay \
  -H "Authorization: Bearer YOUR_API_KEY"

Recommended Runbook Pattern

• Alert on rising pending_retry and failed_permanent counts.
• Filter by endpoint to identify exactly which destination is failing.
• Replay one failed message from the message details page.
• If it succeeds, monitor status/metrics before taking further manual action.
• If it fails again, stop and fix the destination issue first.