@@ -17,26 +17,26 @@ REST Log
1717 :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
1818 :alt: License: LGPL-3
1919.. |badge3 | image :: https://img.shields.io/badge/github-OCA%2Frest--framework-lightgray.png?logo=github
20- :target: https://github.com/OCA/rest-framework/tree/16 .0/rest_log
20+ :target: https://github.com/OCA/rest-framework/tree/18 .0/rest_log
2121 :alt: OCA/rest-framework
2222.. |badge4 | image :: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
23- :target: https://translation.odoo-community.org/projects/rest-framework-16 -0/rest-framework-16 -0-rest_log
23+ :target: https://translation.odoo-community.org/projects/rest-framework-18 -0/rest-framework-18 -0-rest_log
2424 :alt: Translate me on Weblate
2525.. |badge5 | image :: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
26- :target: https://runboat.odoo-community.org/builds?repo=OCA/rest-framework&target_branch=16 .0
26+ :target: https://runboat.odoo-community.org/builds?repo=OCA/rest-framework&target_branch=18 .0
2727 :alt: Try me on Runboat
2828
2929|badge1 | |badge2 | |badge3 | |badge4 | |badge5 |
3030
3131When exposing REST services is often useful to see what's happening
3232especially in case of errors.
3333
34- This module add DB logging for REST requests.
35- It also inject in the response the URL of the log entry created.
34+ This module add DB logging for REST requests. It also inject in the
35+ response the URL of the log entry created.
3636
37- NOTE: this feature was implemented initially inside shopfloor app.
38- Up to version 13.0.1.2.1 of this module,
39- if shopfloor is installed, log records will be copied from its table.
37+ NOTE: this feature was implemented initially inside shopfloor app. Up to
38+ version 13.0.1.2.1 of this module, if shopfloor is installed, log
39+ records will be copied from its table.
4040
4141**Table of contents **
4242
@@ -47,44 +47,48 @@ Configuration
4747=============
4848
4949Logs retention
50- ~~~~~~~~~~~~~~
50+ --------------
5151
52- Logs are kept in database for every REST requests made by a client application.
53- They can be used for debugging and monitoring of the activity.
52+ Logs are kept in database for every REST requests made by a client
53+ application. They can be used for debugging and monitoring of the
54+ activity.
5455
55- The Logs menu is shown only with Developer tools (``?debug=1 ``) activated.
56+ The Logs menu is shown only with Developer tools (``?debug=1 ``)
57+ activated.
5658
57- By default, REST logs are kept 30 days.
58- You can change the duration of the retention by changing the System Parameter
59+ By default, REST logs are kept 30 days. You can change the duration of
60+ the retention by changing the System Parameter
5961``rest.log.retention.days ``.
6062
6163If the value is set to 0, the logs are not stored at all.
6264
63- Logged data is: request URL and method, parameters, headers, result or error.
64-
65+ Logged data is: request URL and method, parameters, headers, result or
66+ error.
6567
6668Logs activation
67- ~~~~~~~~~~~~~~~
69+ ---------------
6870
6971You have 2 ways to activate logging:
7072
71- * on the service component set ` _log_calls_in_db = True `
72- * via configuration
73+ - on the service component set \ _ log_calls_in_db = True
74+ - via configuration
7375
7476In the 1st case, calls will be always be logged.
7577
76- In the 2nd case you can set ``rest.log.active `` param as::
78+ In the 2nd case you can set ``rest.log.active `` param as:
79+
80+ ::
7781
78- `collection_name` # enable for all endpoints of the collection
79- `collection_name.usage` # enable for specific endpoints
80- `collection_name.usage.endpoint` # enable for specific endpoints
81- `collection_name*:state` # enable only for specific state (success, failed)
82+ `collection_name` # enable for all endpoints of the collection
83+ `collection_name.usage` # enable for specific endpoints
84+ `collection_name.usage.endpoint` # enable for specific endpoints
85+ `collection_name*:state` # enable only for specific state (success, failed)
8286
8387Changelog
8488=========
8589
869013.0.1.0.0
87- ~~~~~~~~~~
91+ ----------
8892
8993First official version.
9094
@@ -94,36 +98,36 @@ Bug Tracker
9498Bugs are tracked on `GitHub Issues <https://github.com/OCA/rest-framework/issues >`_.
9599In case of trouble, please check there if your issue has already been reported.
96100If you spotted it first, help us to smash it by providing a detailed and welcomed
97- `feedback <https://github.com/OCA/rest-framework/issues/new?body=module:%20rest_log%0Aversion:%2016 .0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior** >`_.
101+ `feedback <https://github.com/OCA/rest-framework/issues/new?body=module:%20rest_log%0Aversion:%2018 .0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior** >`_.
98102
99103Do not contact contributors directly about support or help with technical issues.
100104
101105Credits
102106=======
103107
104108Authors
105- ~~~~~~~
109+ -------
106110
107111* Camptocamp
108112* ACSONE
109113
110114Contributors
111- ~~~~~~~~~~~~
115+ ------------
112116
113- * Guewen Baconnier <
[email protected] >
114- 117+ - Guewen Baconnier <
[email protected] >
118+ 115119
116120Other credits
117- ~~~~~~~~~~~~~
121+ -------------
118122
119123**Financial support **
120124
121- * Cosanum
122- * Camptocamp R&D
123- * ACSONE R&D
125+ - Cosanum
126+ - Camptocamp R&D
127+ - ACSONE R&D
124128
125129Maintainers
126- ~~~~~~~~~~~
130+ -----------
127131
128132This module is maintained by the OCA.
129133
@@ -143,6 +147,6 @@ Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
143147
144148|maintainer-simahawk |
145149
146- This module is part of the `OCA/rest-framework <https://github.com/OCA/rest-framework/tree/16 .0/rest_log >`_ project on GitHub.
150+ This module is part of the `OCA/rest-framework <https://github.com/OCA/rest-framework/tree/18 .0/rest_log >`_ project on GitHub.
147151
148152You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
0 commit comments