CONFIGURATION

Step 1: Assign user groups

Go to Settings > Users & Companies > Groups > We can see 2 groups for Audit Log:

• Audit Log Manager: Users in this group can create audit rules and view audit logs.
• Audit Log User: Users in this group can view audit logs only.
  

Add the relevant users to each group accordingly.

Step 2 - Create an audit rule

Navigate to Audit Log application> Click New to create a new rule > Fill all the necessary information and Confirm

Key notes when setting up a rule:

• Apply on Fields tab: If specific fields are listed, only changes to those fields will trigger a log entry (Write operations only). If left empty, all field changes of the selected model will be logged.
• Create / Delete / Export operations are always logged on the entire record, regardless of the field list.
• Capture Traceback: Enable this option to record the full Python call stack at the time of the operation.
• Retention (Days): Set how long logs are kept. Enter 0 to keep logs forever.
• Only one audit rule can be created per model.

USAGE

Once a rule is active, every tracked change generates a log entry recording the modified fields

We can view the all the detailed changes in the Audit Logs view which shows a summary list with timestamp, model, record name, operation type, the user who performed it and the exact technical field name, description, old value, and new value side by side.

or view the full Python call stack to trace exactly where in the code the operation was triggered.