OdooWiki OCA HUB
Extra Tools License: AGPL-3

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.0

Lets 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

mailweb

Menus it adds

MonitoringScriptsGroups
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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation 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.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.

info

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.