Audit Log

Who this is for

Users with Settings manage permission who are authorized to review role, permission, and user administration changes.

What the log records

The append-only administrative audit log records an actor, action, entity type, entity ID, time, and selected details for audited administration changes. The Roles & Permissions page exposes the current audit view and can load older entries.

Important boundary

The primary mutation commits first. The audit writer then attempts to append the event and deliberately does not throw if that append fails. This prevents an audit-storage problem from blocking a completed business mutation, but it also means the log is not a transactional proof that every change has an audit row.

Review steps

1. Open Settings → Roles & Permissions and scroll to Audit.
2. Review the actor, action, entity, and timestamp alongside the relevant current role or user state.
3. Use the source record and operational context to investigate a change; do not rely on a truncated entity identifier alone.

Troubleshooting

• No entry appears: confirm the action is an audited administrative action and allow for best-effort audit behavior.
• Cannot access the log: Settings manage permission is required.