Skip to main content

Monitoring, logging, and alerting

Overview​

Clearbox provides delivery logs, bounce reports, and simple metrics to help you spot problems quickly. This guide explains where to find those logs and metrics and how to set up alerts in plain language; contact Alfrolia support if you want us to help set up alerts for you.

Key logs and metrics​

  • Delivery logs: per-message SMTP responses and status (sent, deferred, bounced).
  • Bounce summaries: counts of hard vs. soft bounces and top reasons.
  • Complaint metrics: complaint rate over time, broken down by campaign.
  • Engagement metrics: opens, clicks, unsubscribes.
  • High complaint rate (>0.3% for marketing campaigns)
  • Sudden rise in hard bounces (e.g., >2x baseline)
  • Significant drop in delivery rate

Debugging flow​

  1. Identify affected campaigns/messages via message IDs and time ranges.
  2. Check SMTP responses and bounce codes for exact reasons.
  3. Inspect authentication results (SPF/DKIM/DMARC) in headers.
  4. Cross-check DNS records and recent DNS changes.

Tools & exports​

  • Export delivery logs for offline analysis and attach to support tickets.
  • Use aggregate dashboards for trends and per-sender breakdowns.

Best practices​

  • Keep a 30–90 day retention of delivery logs for investigations.
  • Add structured logging from your sending application (message IDs, user IDs, campaign IDs) to correlate events.

If you need custom monitoring integrations (PagerDuty, Slack alerts), contact Alfrolia support for API or webhook options.