Odoo Performance Tuner

Visão Geral

Esta habilidade ajuda a diagnosticar e resolver problemas de desempenho do Odoo — desde carregamentos lentos de páginas e gargalos no banco de dados até má configuração de workers e inchaço de memória. Ela abrange o ajuste de consultas PostgreSQL, configurações de workers do Odoo e ferramentas de profiling integradas.

Quando Usar Esta Habilidade

• Odoo está lento em produção (carregamentos lentos de páginas, timeouts).
• Recebendo erros MemoryError ou Worker timeout nos logs.
• Diagnosticando uma consulta lenta no banco de dados usando o profiler do Odoo.
• Ajustando odoo.conf para uma especificação de servidor específica.

Como Funciona

1. Ativar: Mencione @odoo-performance-tuner e descreva seu problema de desempenho.
2. Diagnosticar: Compartilhe linhas de log ou configurações relevantes e receba uma análise da causa raiz.
3. Corrigir: Obtenha alterações exatas de configuração com explicações.

Exemplos

Exemplo 1: Configuração Recomendada de Workers

# odoo.conf — tuned for a 4-core, 8GB RAM server

workers = 9                   # (CPU_cores × 2) + 1 — never set to 0 in production
max_cron_threads = 2          # background cron jobs; keep ≤ 2 to preserve user-facing capacity
limit_memory_soft = 1610612736  # 1.5 GB — worker is recycled gracefully after this
limit_memory_hard = 2147483648  # 2.0 GB — worker is killed immediately; prevents OOM crashes
limit_time_cpu = 600          # max CPU seconds per request
limit_time_real = 1200        # max wall-clock seconds per request
limit_request = 8192          # max requests before worker recycles (prevents memory leaks)

Exemplo 2: Encontrar Consultas Lentas com PostgreSQL

-- Step 1: Enable pg_stat_statements extension (run once as postgres superuser)
CREATE EXTENSION IF NOT EXISTS pg_stat_statements;

-- Step 2: Also add to postgresql.conf and reload:
-- shared_preload_libraries = 'pg_stat_statements'
-- log_min_duration_statement = 1000   -- log queries taking > 1 second

-- Step 3: Find the top 10 slowest average queries
SELECT
    LEFT(query, 100) AS query_snippet,
    round(mean_exec_time::numeric, 2) AS avg_ms,
    calls,
    round(total_exec_time::numeric, 2) AS total_ms
FROM pg_stat_statements
ORDER BY mean_exec_time DESC
LIMIT 10;

-- Step 4: Check for missing indexes causing full table scans
SELECT schemaname, tablename, attname, n_distinct, correlation
FROM pg_stats
WHERE tablename = 'sale_order_line'
  AND correlation < 0.5   -- low correlation = poor index efficiency
ORDER BY n_distinct DESC;

Exemplo 3: Usar o Profiler Integrado do Odoo

Prerequisites: Run Odoo with ?debug=1 in the URL to enable debug mode.

Menu: Settings → Technical → Profiling

Steps:
  1. Click "Enable Profiling" — set a duration (e.g., 60 seconds)
  2. Navigate to and reproduce the slow action
  3. Return to Settings → Technical → Profiling → View Results

What to look for:
  - Total SQL queries > 100 on a single page  → N+1 query problem
  - Single queries taking > 100ms             → missing DB index
  - Same query repeated many times            → missing cache, use @ormcache
  - Python time high but SQL low             → compute field inefficiency

Melhores Práticas

• ✅ Fazer: Usar mapped(), filtered() e sorted() em recordsets na memória — eles não disparam SQL adicional.
• ✅ Fazer: Adicionar índices B-tree do PostgreSQL em colunas usadas frequentemente em filtros de domínio (partner_id, state, date_order).
• ✅ Fazer: Habilitar o cache HTTP do Odoo para ativos estáticos e colocar um CDN (Cloudflare, AWS CloudFront) na frente do site.
• ✅ Fazer: Usar o decorador @tools.ormcache em métodos chamados repetidamente com os mesmos argumentos.
• ❌ Não Fazer: Configurar workers = 0 em produção — o modo single-threaded serializa todas as requisições e bloqueia todos os usuários em qualquer operação lenta.
• ❌ Não Fazer: Ignorar limit_memory_soft — workers que o excedem são reciclados entre as requisições; sem o limite, eles crescem ilimitadamente e travam.
• ❌ Não Fazer: Manipular diretamente prefetch_ids em recordsets — confie no pré-carregamento automático em lote do Odoo, que é ativado por padrão.

Limitações

• O ajuste do PostgreSQL (shared_buffers, work_mem, effective_cache_size) é altamente específico do servidor e não é coberto em profundidade aqui — use PGTune como uma linha de base inicial.
• O profiler integrado do Odoo captura apenas rastros de Python + SQL; o desempenho de renderização JavaScript requer as Ferramentas do Desenvolvedor do navegador.
• A hospedagem gerenciada Odoo.sh restringe o acesso direto ao PostgreSQL e a odoo.conf — algumas opções de ajuste não estão disponíveis.

…