v2.7 Engineering Guide

Disk, I/O and Spool Monitoring

Protect queue integrity by monitoring capacity, inode use, write latency and abnormal spool growth.

Operational objective

What this guide helps you control

Protect queue integrity by monitoring capacity, inode use, write latency and abnormal spool growth. The purpose is to convert raw system activity into evidence that supports safe operational decisions.

Signals to collect

  • Traffic volume, acceptance rate and delivery latency.
  • Queue depth, queue age and provider-specific backlog.
  • SMTP response families and exact enhanced status codes.
  • Authentication, DNS, TLS and identity health.
  • Host resources, service state and configuration changes.

Implementation workflow

  1. Define the operational question before selecting metrics.
  2. Establish a normal baseline by provider, stream and source identity.
  3. Collect counters and event evidence with synchronized timestamps.
  4. Create thresholds that require persistence, not one noisy sample.
  5. Attach ownership, runbook links and recovery conditions to alerts.
  6. Review false positives and revise thresholds after incidents.

Production design

# Example monitoring dimensions
provider       = microsoft | gmail | yahoo | other
stream         = transactional | marketing | warmup
source_ip      = stable sending identity
response_class = 2xx | 4xx | 5xx
queue_age_band = <5m | 5-30m | 30-120m | >120m
Avoid unsafe labels: Do not place full recipients, message IDs or queue IDs into metric labels. Preserve that detail in controlled logs instead.

Validation checklist

  • Metric timestamps match the MTA and log hosts.
  • Dashboard totals reconcile with accounting or queue data.
  • Provider groupings are version-controlled and reviewed.
  • Alerts include the affected scope and supporting evidence.
  • Retention is sufficient for weekly and monthly comparisons.

Common mistakes

Common failures include alerting on queue depth without queue age, combining all providers into one rate, treating every 4xx reply as reputation damage, and changing delivery settings before identifying the affected traffic stream.

Related resources

Monitoring Labs · Troubleshooting runbooks · Operational templates

Search Trushilla Documentation