OdooWiki OCA HUB

Audit Log

auditlog folder_open OCA/server-tools open_in_new
Tools License: AGPL-3

This module allows the administrator to log user operations performed on data models such as create, read, write and delete.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Lets administrators record who created, read, changed, deleted or exported records of chosen models, and review those traces, including the web requests and user sessions behind them.

This module adds an Audit menu (visible to administrators) where you define rules that decide which data is tracked.

  • In Rules you pick a model (for example contacts or invoices), optionally limit the rule to certain users, and tick which operations to record: creates, reads, writes, deletes and exports. You can also exclude specific users and specific fields from being logged.
  • Each rule is either Draft or Confirmed. Confirming it activates the tracking and adds a "View logs" shortcut on records of that model; setting it back to Draft stops the tracking. Only one rule per model is allowed.
  • Two logging modes exist: Full log keeps the previous values of changed fields (and can also store all values when a record is deleted), while Fast log only stores the new values and is quicker.
  • The Logs screen lists each recorded operation with the user, the record, the operation type, the related web request and session, and the field-by-field old and new values. Log Lines gives a flat list of every field change, and a button shows the exported records of an export.
  • HTTP Requests and User sessions screens show the pages visited and the sessions behind the logged operations.
  • A scheduled job automatically deletes old logs, requests and sessions after a configurable number of days.

Access is controlled by Auditlog User and Auditlog Manager groups.

Depends on

base

Required by other modules

test_auditlog

Menus it adds

menu_action_auditlog_http_request_treemenu_action_auditlog_http_session_treeLog LinesLogsmenu_action_auditlog_rule_treeAudit
Models and fields (7)
  • auditlog.log · new modelname (Resource Name), method, res_id (Resource ID), res_ids (Resource IDs), user_id, line_ids (Fields updated), log_type (Type), model_id, model_name, model_model (Technical Model Name), http_request_id (HTTP Request), http_session_id (Session)
  • auditlog.rule · new modelname, state, log_read (Log Reads), log_type (Type), model_id, user_ids (Users), action_id, log_write (Log Writes), log_create (Log Creates), log_unlink (Log Deletes), model_name, model_model (Technical Model Name), capture_record (Log values on deletion), log_export_data (Log Exports), users_to_exclude_ids (Users to Exclude), fields_to_exclude_ids (Fields to Exclude)
  • auditlog.log.line · new modellog_id, field_id, new_value, old_value, field_name (Technical name), new_value_text (New value Text), old_value_text (Old value Text), field_description (Description)
  • auditlog.autovacuum · new model
  • auditlog.http.request · new modelname (Path), log_ids (Logs), user_id, root_url (Root URL), display_name (Name), user_context (Context), http_session_id (Session)
  • auditlog.http.session · new modelname (Session ID), user_id, display_name (Name), http_request_ids (HTTP Requests)
  • auditlog.log.line.view · new modelname, method, res_id, user_id, log_type (Type), model_id, model_name, model_model, http_request_id (HTTP Request), http_session_id (Session)

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 8 confirmed, 1 with no information of 9 versions.

Sources · Odoo 18.0

Confirmed on 2026-11-03 in branch 18.0 of OCA/server-tools.

terminal Installation and usage

OCA documentation · Odoo 19.0

Usage

Source · Odoo 19.0

Go to Settings / Technical / Audit / Rules to manage audit log rules. A rule defines which operations to log for a given data model. New rules need to be enabled by 'Subscribing'.

Then, check logs in the Settings / Technical / Audit / Logs menu. You can group them by user sessions, date, data model or HTTP requests:

Get the details:

A scheduled action exists to delete logs older than 6 months (180 days) periodically but is not enabled by default. To activate it and/or change the delay, go to the Configuration / Technical / Automation / Scheduled Actions menu and edit the Auto-vacuum audit logs entry:

In case you're having trouble with the amount of records to delete per run, you can pass the amount of records to delete for one model per run as the second parameter. The default is to delete all records in one go.

There are two permission groups that apply to auditlogging. The first is the Auditlog User group. This group has read-only access to the auditlogs of individual records through the View Logs action that is available on records of models that are being tracked. The second group is the Auditlog Manager group. This group has additional rights to manage the auditlog configuration rules. By default, users that are ERP Administrators are also Auditlog Managers.

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.