back to search

OCA/server-tools · 19.0

Audit Log

auditlog

AGPL-3Toolsv19.0.1.0.1890updated 4 months ago

Odoo Community Association

Audit Log

Beta License: AGPL-3 OCA/server-tools Translate me on Weblate Try me on Runboat

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

Table of contents

Usage

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'.

image

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

image1

Get the details:

image2

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:

image3

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.

Known issues / Roadmap

  • log only operations triggered by some users (currently it logs all users)
  • log read operations does not work on all data models, need investigation

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • ABF OSIELL

Contributors

  • Sebastien Alix <<sebastien.alix@camptocamp.com>>
  • Holger Brunn <<hbrunn@therp.nl>>
  • Holden Rehg <<holdenrehg@gmail.com>>
  • Eric Lembregts <<eric@lembregts.eu>>
  • Pieter Paulussen <<pieter.paulussen@me.com>>
  • Alan Ramos <<alan.ramos@jarsa.com.mx>>
  • Stefan Rijnhart <<stefan@opener.amsterdam>>
  • Bhavesh Odedra <<bodedra@opensourceintegrators.com>>
  • Hardik Suthar <<hsuthar@opensourceintegrators.com>>
  • Kitti U. <<kittiu@ecosoft.co.th>>
  • Bogdan Valentin Gabor <<valentin.gabor@bt-group.com>>
  • Dennis Sluijk <d.sluijk@onestein.nl>
  • Adam Heinz <<adam.heinz@metricwise.com>>

Other credits

  • Icon: built with different icons from the Oxygen theme (LGPL)

Maintainers

This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/server-tools project on GitHub.

You are welcome to contribute. To learn how please visit <https://odoo-community.org/page/Contribute>.