Audit logs
A customer-facing audit trail
What it is
An audit log is a record of who did what, and when, inside your product: logins, permission changes, data exports, settings edits. Enterprise customers need to see it themselves, search it, export it and stream it into their own security tools, such as Splunk or Datadog. It has to be complete, hard to tamper with and kept for as long as their contract says.
Security teams investigate incidents with it, and auditors ask for it. Your internal application logs don't count, because customers can't see them and they aren't complete.
What it takes
About 3–6 engineer-weeks to build in-house, or 1–3 using WorkOS Audit Logs, Retraced or Pangea.
Answer these first
- Product: Which actions must be logged on day one?
- Engineering: How many services would need to emit events?
- Engineering: Do events have a stable, versioned schema?
- Security: How long must logs be kept, and can anyone alter them?
- Sales: Do buyers want a UI, an export, or a SIEM stream?
- Support: Who explains a log entry when a customer asks?
This page works best with JavaScript on. Every answer also has its own address, like /what/scim.