Log Inspection & Redaction #

Service logs are retrieved on demand through control-backend (GET /v1/platform/services/:id/logs) and rendered in the Admin Console with Cache-Control: no-store.

Privacy & Redaction Guarantees #

  1. Email Address Masking: Local-parts in operational logs are masked (for example, a***@example.invalid) rather than printed in plaintext.
  2. Secret Redaction: Passwords, App Passwords, HMAC keys, Bearer tokens, and SecretRef values are never logged. mta-out explicitly redacts relay_password as <redacted> in Debug output.
  3. Zero Mail Body Logging (ADR-0025): smtp-in, imapd, pop3d, and mail-worker never log message subjects, headers containing user prose, message bodies, or attachment contents.

Querying Service Logs #

From the UI (https://admin.<your-domain> -> Operations -> View Logs) or authenticated API:

bash
curl -sS "https://admin.<your-domain>/v1/platform/services/smtp-in/logs?tail=100" \
  -H "Authorization: Bearer <YOUR_PLATFORM_SESSION_TOKEN>"

Troubleshooting Key Log Signals #

  • smtp-in 451 Temporary Error: Check postgres fsync=on / synchronous_commit=on, MAIL_BLOB_ROOT disk availability, or mta-out gRPC connectivity (MTA_OUT_SUBMISSION_GRPC_ADDR).
  • smtp-in 550 5.7.1 Inbound Reject: Normal DMARC p=reject enforcement when an unaligned sender fails SPF and DKIM checks.
  • imapd / pop3d NO [UNAVAILABLE]: Indicates identityd gRPC timeout (3s default) or rate-limit protection (intentionally mapped to generic Unavailable without leaking lockout state).
  • mta-out 535 Relay Auth Failure: Verify MTA_OUT_RELAY_USERNAME and MTA_OUT_RELAY_PASSWORD_FILE permissions (0600).