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 #
- Email Address Masking: Local-parts in operational logs are masked (for example,
a***@example.invalid) rather than printed in plaintext. - Secret Redaction: Passwords, App Passwords, HMAC keys, Bearer tokens, and
SecretRefvalues are never logged.mta-outexplicitly redactsrelay_passwordas<redacted>inDebugoutput. - Zero Mail Body Logging (
ADR-0025):smtp-in,imapd,pop3d, andmail-workernever 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-in451Temporary Error: Checkpostgresfsync=on/synchronous_commit=on,MAIL_BLOB_ROOTdisk availability, ormta-outgRPC connectivity (MTA_OUT_SUBMISSION_GRPC_ADDR).smtp-in550 5.7.1Inbound Reject: Normal DMARCp=rejectenforcement when an unaligned sender fails SPF and DKIM checks.imapd/pop3dNO [UNAVAILABLE]: IndicatesidentitydgRPC timeout (3sdefault) or rate-limit protection (intentionally mapped to genericUnavailablewithout leaking lockout state).mta-out535Relay Auth Failure: VerifyMTA_OUT_RELAY_USERNAMEandMTA_OUT_RELAY_PASSWORD_FILEpermissions (0600).