This addon adds profiling controls to queue job functions and wraps queue job execution in an Odoo profiler session when enabled.
When profiling is enabled for a job function and the executing user matches one of the configured profiling users (or no users are set), the queue job runner records SQL and async stack traces via odoo.tools.profiler.Profiler and saves the results into ir_profile.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Lets administrators turn on performance profiling for specific queue job functions, so that when those jobs run, Odoo records a detailed performance profile that can be opened from the job record.
This module adds profiling controls to the background job system. On each job function (the definition of a type of background job), a new "Profiler" section lets you enable profiling, choose which users are allowed to trigger it, and set a date until which profiling stays active. Enabling profiling requires an end date, otherwise Odoo refuses to save.
When a job of that function runs and profiling is active, the job is executed inside a profiler session and the result is saved as a profile record. Profiling only happens if the current date is before the "profiling until" date and, if any profiling users are listed, only for those users.
On a job record, a "View profiler" button appears in the button box when a profile exists for that job; clicking it opens the saved profile. The button is hidden when no profile is available.
The module extends the queue.job and queue.job.function models and adds fields to their existing forms. It does not create new menus; the new options appear inside the existing job and job function screens.
Depends on
Models and fields (2)
- queue.job · extends an existing modeljob_is_profiled (Profiled)
- queue.job.function · extends an existing modelprofiling_until (Profiling until), profiling_enabled (Profiling enabled), profiling_user_ids (Profiling users)
Text generated by AI (DeepSeek) from reading the Odoo 18.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 18.0
Confirmed on 2026-11-03 in branch 18.0 of OCA/queue.
terminal Installation and usage
OCA documentation · Odoo 18.0Usage
Source · Odoo 18.0- Open the Queue Job Functions menu.
- Open the job function you want to profile.
- In the Profiler group, enable Profiling and set the Profiling users (optional) and Profiling until.
- Run the job with the selected user (the queue job runner usually executes as the superuser).
- Inspect the generated entries in
ir_profileto review the captured profiling data.
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.