OdooWiki OCA HUB

REST Log

rest_log folder_open OCA/rest-framework open_in_new
Sin categoría Licencia: LGPL-3

Cuando se exponen servicios REST a menudo es útil ver qué está sucediendo, especialmente en caso de errores.

Este módulo añade registro en la base de datos para las peticiones REST. También inyecta en la respuesta la URL de la entrada de registro creada.

También puede habilitar la generación de perfiles para endpoints REST seleccionados. Cuando la generación de perfiles está activa, la ejecución de la petición se envuelve con el generador de perfiles de Odoo y los resultados se almacenan en ir_profile.

NOTA: esta funcionalidad se implementó inicialmente dentro de la aplicación shopfloor. Hasta la versión 13.0.1.2.1 de este módulo, si shopfloor está instalado, los registros de log se copiarán desde su tabla.

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Registra cada llamada a la API REST realizada a tu Odoo en un registro consultable, mostrando qué se solicitó, el resultado o el error, y un enlace de vuelta al registro relacionado. Los registros antiguos se limpian automáticamente.

Este módulo añade un registro de las llamadas a la API REST para que puedas ver qué pidieron los sistemas externos a Odoo y qué ocurrió.

  • Aparece un nuevo menú "Logs" bajo el menú REST API, con una lista y un formulario. Cada entrada muestra la colección, la URL y el método de la petición, el usuario, la fecha, el estado (Success o Failed), el nombre y el mensaje de la excepción, y una severidad (Functional, Warning o Severe).
  • En una entrada de registro puedes abrir las secciones Parameters, Result y Error para inspeccionar los datos exactos enviados y devueltos. Un botón "View collection" salta al registro sobre el que trataba la llamada, cuando hay uno vinculado.
  • Las llamadas fallidas se resaltan en rojo en la lista. Puedes filtrar por Today, Failed o por severidad, y agrupar por colección, usuario, URL de la petición, estado, excepción, severidad o fecha.
  • Cuando una llamada falla, la respuesta de error enviada al solicitante incluye un enlace a la entrada del registro, para que la persona que depura pueda abrirlo directamente.
  • Los valores sensibles como contraseñas, cookies y claves de API se sustituyen por "<redacted>" antes de almacenarse.
  • El registro está controlado por ajustes: se puede activar globalmente, o solo para determinadas colecciones, endpoints o estados. Una tarea programada diaria elimina los registros más antiguos que el periodo de retención (30 días por defecto).
  • El acceso está limitado al grupo "REST Log Manager", que es de solo lectura.

Depende de

base_rest

Lo necesitan otros módulos

shopfloor_rest_log
Modelos y campos (2)
  • rest.log · modelo nuevoerror, state, params, result, headers, severity, collection, request_url (Request URL), collection_id (Collection ID), exception_name (Exception), request_method, exception_message
  • base.rest.service · amplía un modelo existente

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 5 confirmadas, 4 sin información de 9 versiones.

Fuentes · Odoo 15.0

Confirmado el 2026-11-03 en la rama 15.0 de OCA/rest-framework.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Configuración

Fuente · Odoo 18.0

Retención de logs

Los logs se guardan en la base de datos para cada solicitud REST realizada por una aplicación cliente. Se pueden utilizar para depuración y monitoreo de la actividad.

El menú Logs solo se muestra con las Herramientas de desarrollador (?debug=1) activadas.

Por defecto, los logs REST se conservan 30 días. Puedes cambiar la duración de la retención cambiando el Parámetro del Sistema rest.log.retention.days.

Si el valor se establece en 0, los logs no se almacenan en absoluto.

Los datos registrados son: URL y método de la solicitud, parámetros, encabezados, resultado o error.

Activación de logs

Tienes 2 formas de activar el registro:

  • en el componente de servicio establece _log_calls_in_db = True
  • mediante configuración

En el 1er caso, las llamadas siempre se registrarán.

En el 2do caso puedes establecer el parámetro rest.log.active como:

collection_name # habilitar para todos los endpoints de la colección collection_name.usage # habilitar para endpoints específicos collection_name.usage.endpoint # habilitar para endpoints específicos collection_name*:state # habilitar solo para un estado específico (success, failed)

Profiling

El profiling se habilita por endpoint y por usuario mediante parámetros del sistema:

  • rest.log.profiling.conf: misma sintaxis de coincidencia que rest.log.active
  • rest.log.profiling.uid: lista separada por comas de ids de usuario autorizados a hacer profiling

Cuando ambos parámetros coinciden, la ejecución de la solicitud se envuelve en el profiler de Odoo y los resultados se almacenan en ir_profile.

base.profiling_enabled_until solo es necesario para ver la salida de speedscope en la UI. No es necesario para registrar perfiles.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Uso.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.