This module allows the administrator to log user operations performed on data
models such as create
, read
, write
and delete
.
Table of contents
Configuration
Rules
Go to Settings / Technical / Audit / Rules
to subscribe rules. A rule defines
which operations to log for a given data model.
Cleanup
A scheduled action exists to delete logs older than 6 months (180 days)
automatically 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.
Security / Policy
You need to be aware that logging can contain sensitive data. With raw HTTP logs,
there not much to do about that, but for ORM logging, the module blacklists all
fields called password
. If you really need to audit that (having plain passwords
laying around is a policy violation basically everywhere), rename your field or
create a related field used for input.
Usage
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:
Known issues / Roadmap
- Log only operations triggered by some users. Currently it logs all users.
- Logging 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
Contributors
- Sebastien Alix <sebastien.alix@camptocamp.com>
- Holger Brunn <hbrunn@therp.nl>
- Holden Rehg <holdenrehg@gmail.com>
- Bhavesh Odedra <bodedra@opensourceintegrators.com>
- Hardik Suthar <hsuthar@opensourceintegrators.com>
Other credits
- Icon: built with different icons from the Oxygen theme (LGPL)
Maintainers
This module is maintained by the OCA.
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.