This module allows monitoring software to extract additional information about an Odoo installation. An administrator can configure monitoring snippets and group them together which allows external software to fetch the results using the token in the URL /monitoring/.
auto_awesome What this module does
AI-generated from the code · Odoo 15.0Lets administrators define custom health checks on their Odoo database and expose the results to external monitoring software through a secure URL. Checks can be grouped, run manually or on a schedule, and can trigger warning or critical alerts by email.
This module adds a new area under the Extra Tools menu called Monitoring, with two screens: Scripts and Groups.
- In Scripts you create individual checks. Each check has a name, a token (a unique code used in the URL), a check type (expect True, expect False, expect Lower or expect Higher), an optional warning and critical threshold, and a small piece of logic that produces a result. The check is evaluated and gets a state of OK, Warning or Critical.
- In Groups you bundle several checks together. A group also has its own token and shows an overall state: Critical if any active check is critical, Warning if any is warning, OK if all are fine, otherwise Unknown. A Validate button runs all checks in the group immediately.
External monitoring software can call the URL /monitoring/ followed by a group or script token to get a JSON answer with the status and details of the checks. No login is required for that URL.
A scheduled job named Monitoring exists but is disabled by default; when enabled it runs every 5 minutes and can send an email using a chosen mail template when a group is in Warning or Critical state. The module is restricted to system administrators and touches the monitoring and monitoring.script models.
Depends on
Menus it adds
Models and fields (2)
- monitoring · new modelname, state (_get_states), token, active, verbose, mail_sent, script_ids, mail_template_id
- monitoring.script · new modelname, state (_get_states), token, active, snippet, warning, critical, check_type (_get_types), monitoring_ids
Text generated by AI (DeepSeek) from reading the Odoo 15.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 1 confirmed, 8 with no information of 9 versions.
Sources · Odoo 15.0
Confirmed on 2026-11-03 in branch 15.0 of OCA/server-tools.
terminal Installation and usage
OCA documentation · Odoo 15.0Usage
Source · Odoo 15.0- Configure snippets under
Settings > Technical > Monitoring > Scripts - Configure monitoring groups under
Settings > Technical > Monitoring > Groups - Connect your monitoring software directly to the snippets or the monitoring group using the tokens and the endpoint
/monitoring/<token> - Alternativly create an email template for transmit errors via emails
No verified information in OCA: Installation, Configuration.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.