Skip to main content

How Audit Logging Works

Written by Arpit Khemka
Updated over 2 weeks ago

Every administrative action is automatically recorded for compliance and troubleshooting.

What is the audit log?

The audit log is an immutable record of every administrative action taken in the 3MotionAI admin portal. It captures who did what, when, and what changed. This is essential for security compliance, troubleshooting issues, and maintaining an accountability trail. Audit logs cannot be modified or deleted.

How to get started

The audit log populates automatically. You do not need to configure anything:

  • Every mutation (create, update, delete) across all modules is automatically logged.

  • Use the search bar to find specific events by action name, entity type, or user.

  • Apply date range filters to narrow down events to a specific time period.

  • Export logs as CSV or JSON for external compliance tools or archival.

Key concepts

Understanding audit log entries:

  • Action types: Each log entry has an action like ORG_CREATED, USER_INVITED, LICENSE_ASSIGNED, CONFIG_SAVED, etc.

  • Entity tracking: Entries include the entity type (Organization, User, License, etc.) and entity ID for traceability.

  • Change details: Expandable rows show the old and new values for each change, making it easy to see exactly what was modified.

  • User attribution: Every action is linked to the user who performed it, including their name and email.

Common questions

Answers to frequently asked questions:

  • Can I delete audit entries? No, audit logs are immutable and cannot be modified or deleted. This is by design for compliance.

  • How long are audit logs retained? Logs are retained for the lifetime of your account. There is no automatic purging.

  • Can I get real-time notifications for specific actions? Set up webhooks to receive real-time event notifications for any action type.

  • Are system-initiated actions logged? Yes, automated actions like license expiration and scheduled digests are also logged.

Did this answer your question?