Skip to main content

Audit Log

Project description

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

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.

https://raw.githubusercontent.com/OCA/server-tools/12.0/auditlog/static/description/rule.png

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:

https://raw.githubusercontent.com/OCA/server-tools/12.0/auditlog/static/description/autovacuum.png

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:

https://raw.githubusercontent.com/OCA/server-tools/12.0/auditlog/static/description/logs.png

Get the details:

https://raw.githubusercontent.com/OCA/server-tools/12.0/auditlog/static/description/log.png

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 smashing 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

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

File details

Details for the file odoo12_addon_auditlog-12.0.2.0.0.99.dev1-py3-none-any.whl.

File metadata

File hashes

Hashes for odoo12_addon_auditlog-12.0.2.0.0.99.dev1-py3-none-any.whl
Algorithm Hash digest
SHA256 5d3536b7a602795d8284dc20025044f40bbf32b10199a0bd9ff363da174bb34f
MD5 34359e618498850051dd47a7b4e53948
BLAKE2b-256 da21e77d79dff02242040c91d8e9d22b0346c91d835dc118509eda67cb0eb56a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page