You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

81 lines
2.6 KiB

  1. .. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
  2. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  3. :alt: License: AGPL-3
  4. =================================
  5. Audit Log - Track user operations
  6. =================================
  7. This module allows the administrator to log user operations performed on data
  8. models such as ``create``, ``read``, ``write`` and ``delete``.
  9. Usage
  10. =====
  11. Go to `Settings / Technical / Audit / Rules` to subscribe rules. A rule defines
  12. which operations to log for a given data model.
  13. .. image:: /auditlog/static/description/rule.png
  14. Then, check logs in the `Settings / Technical / Audit / Logs` menu. You can
  15. group them by user sessions, date, data model or HTTP requests:
  16. .. image:: /auditlog/static/description/logs.png
  17. Get the details:
  18. .. image:: /auditlog/static/description/log.png
  19. A scheduled action exists to delete logs older than 6 months (180 days)
  20. automatically but is not enabled by default.
  21. To activate it and/or change the delay, go to the
  22. `Configuration / Technical / Automation / Scheduled Actions` menu and edit the
  23. `Auto-vacuum audit logs` entry:
  24. .. image:: /auditlog/static/description/autovacuum.png
  25. During installation, a one-time script will migrate any existing data from the
  26. `audittrail` module (rules and logs).
  27. Known issues / Roadmap
  28. ======================
  29. * log only operations triggered by some users (currently it logs all users)
  30. Bug Tracker
  31. ===========
  32. Bugs are tracked on `GitHub Issues <https://github.com/OCA/server-tools/issues>`_.
  33. In case of trouble, please check there if your issue has already been reported.
  34. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback
  35. `here <https://github.com/OCA/server-tools/issues/new?body=module:%20auditlog%0Aversion:%208.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  36. Credits
  37. =======
  38. Contributors
  39. ------------
  40. * Sebastien Alix <sebastien.alix@osiell.com>
  41. * Holger Brunn <hbrunn@therp.nl>
  42. * Holden Rehg <holdenrehg@gmail.com>
  43. Images
  44. ------
  45. * Icon: built with different icons from the `Oxygen theme <https://en.wikipedia.org/wiki/Oxygen_Project>`_ (LGPL)
  46. Maintainer
  47. ----------
  48. .. image:: http://odoo-community.org/logo.png
  49. :alt: Odoo Community Association
  50. :target: http://odoo-community.org
  51. This module is maintained by the OCA.
  52. 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.
  53. To contribute to this module, please visit http://odoo-community.org.