Odoo 19 · UTE Pecom-BMI · Auditoría

Registro de auditoría

Pensado para administradores y auditores: una regla indica qué datos vigilar y cada operación deja una entrada con fecha, usuario y valores. No reemplaza al historial de cada registro.

1

Qué resuelve y quién puede usarlo

Una bitácora central de quién hizo qué sobre los datos que se decida vigilar, con consulta reservada a administradores y auditores.

Esta función responde preguntas de control como las siguientes:

  • «¿Quién modificó el precio de este producto, y qué valor tenía previamente?»
  • «¿Quién eliminó este contacto?»
  • «¿Quién exportó la lista de clientes, y qué registros incluía?»
  • «¿Qué hizo esta persona ayer sobre los datos vigilados?»

Funciona con reglas. Cada regla vigila un tipo de dato (por ejemplo, Contacto o Producto) y se activa con un botón. Mientras la regla está activa, cada alta, modificación, eliminación, lectura o exportación de ese tipo de dato deja una entrada en el registro, con la fecha y hora, la persona, el registro afectado y, según la configuración, el valor de cada campo. No se vigila nada por sí solo: sin reglas activas, el registro está vacío.

Quién puede hacer qué:

PerfilQué puede hacer
Función Administrador (bloque Funciones de la ficha del usuario)Ve el menú Auditoría, crea, activa y desactiva reglas y consulta todas las entradas. Incluye los permisos de Gestor del Auditlog.
Gestor del AuditlogTiene todos los permisos sobre reglas y entradas, incluso modificar y eliminar entradas. El menú Auditoría solo se muestra a los administradores, de modo que sin esa función no hay camino de menú hacia las reglas.
Usuario del AuditlogSolo lectura. Consulta las entradas de un registro con la opción Ver registros del menú Acciones de ese registro (sección 4). No ve el menú Auditoría.
Resto de los usuariosNo ven ni consultan nada de la auditoría.

Los permisos del Auditlog se asignan en la ficha del usuario, pestaña Permisos de acceso, en el bloque Permisos del Auditlog (ver el Manual «Usuarios y permisos»). El menú Auditoría está dentro de Técnico, que solo aparece con el modo desarrollador activado (Manual «Encabezado superior»). Las entradas no se separan por empresa: quien puede consultar el registro ve las de todas las empresas.

Diferencia con el historial de cada registro (el chatter). Debajo de cada ficha, el historial (Manual «Chatter») anota mensajes, notas y los cambios de unos pocos campos que el sistema marca para seguimiento. La auditoría es otra herramienta:

Historial de la fichaRegistro de auditoría
Qué anotaMensajes y notas, y los cambios de los campos marcados para seguimiento.Los cambios de cualquier campo del tipo de dato vigilado (salvo los que se excluyan), y además altas, eliminaciones, lecturas y exportaciones.
Quién lo veQuien puede ver la ficha.Solo administradores y auditores.
Cómo se consultaFicha por ficha.Ficha por ficha o en listas generales, filtradas por persona, fecha o tipo de dato.
Si se elimina la fichaSu historial desaparece con ella.La entrada de eliminación se conserva.
Cuándo funcionaSiempre.Solo desde que se activa una regla para ese tipo de dato.
Ficha del usuario Gestor de auditoría con la pestaña Permisos de acceso abierta. En el bloque Permisos del Auditlog, el campo del mismo nombre está en Gestor del Auditlog y su lista desplegada ofrece No, Usuario del Auditlog y Gestor del Auditlog.
2

Crear una regla: qué se vigila

Elegir el tipo de dato, qué operaciones se anotan y con cuánto detalle.

Las reglas están en Ajustes > Técnico > Auditoría > Reglas. La lista muestra una fila por regla con su nombre, el tipo de dato, qué operaciones anota y el estado: las reglas en Borrador se ven en azul y las confirmadas en negrita. Con Nuevo se abre el formulario. Hay una sola regla por tipo de dato.

CampoQué se carga
Título (se ve «Description...» hasta que se escribe)Nombre libre y obligatorio, por ejemplo «Cambios en productos».
ModeloEl tipo de dato que se vigila. Se elige de una lista con los nombres que tienen las pantallas del sistema, como Contacto, Producto o Variante del producto. No se pueden crear opciones desde acá. Una regla vigila todos los registros de ese tipo, no uno en particular.
TipoRegistro completo (viene elegido) o Registro rápido; se explican más abajo.
Log values on deletion (se ve en inglés)Solo se muestra con Registro completo y con la casilla de eliminaciones tildada. Si se tilda, al eliminar un registro se guardan además todos sus valores, para poder ver cómo era.
Usuarios a ExcluirPersonas cuyas operaciones no se anotan, por ejemplo la cuenta que usa una integración con otro sistema. Si queda vacío, se anotan las operaciones de todos.
Campos a ExcluirCampos del tipo de dato elegido cuyos cambios no se anotan, por ejemplo una imagen o un campo que cambia sin parar. Solo ofrece los campos del tipo de dato elegido.

En el grupo Logging (el título se ve en inglés) se marcan las operaciones que se anotan:

CasillaVieneQué anota
Creación de RegistroTildadaCada vez que se crea un registro.
Lectura de RegistroSin tildarCada vez que se abre o se consulta un registro. Es la operación más pesada: ver la sección 7.
Escritura de RegistroTildadaCada modificación de un registro existente.
Eliminación de RegistroTildadaCada vez que se elimina un registro.
Log Exports (se ve en inglés)TildadaCada vez que alguien exporta registros de ese tipo desde el botón de exportar de las listas.

El campo Tipo decide cuánto se guarda de cada operación:

Registro completoRegistro rápido
AltasUna línea por cada campo del registro, tenga o no valor.Solo los campos que se cargaron.
ModificacionesEl valor anterior y el posterior de cada campo modificado, incluidos los campos calculados que se actualizaron como consecuencia.Solo lo que se escribió. El valor anterior queda vacío, así que no se puede saber qué había.
EliminacionesUna entrada con el nombre del registro; con Log values on deletion tildada, también todos sus valores.Una entrada con el nombre del registro, sin valores.
VelocidadMás lento: lee los valores previos y posteriores de cada modificación.Más rápido.
Cuándo convieneCuando hay que saber qué valor había.En datos de mucho movimiento, cuando alcanza con saber quién y cuándo.

Dos reglas generales de lo que se anota. Una modificación que no cambia ningún valor no deja entrada. Y solo se examinan los campos que el sistema guarda; los campos que se calculan al mostrarlos no se auditan.

Lista Reglas con tres reglas: Cambios en contactos y Cambios en productos, en negrita y con el estado Confirmed, y Cambios en variantes de producto, en azul y en Borrador. Las columnas son Nombre, Modelo, Tipo, Lectura de Registro, Escritura de Registro, Eliminación de Registro, Creación de Registro, Log Exports y Estado.
Formulario de una regla nueva sin guardar, con el título Cambios en productos, el Modelo Producto y el Tipo Registro completo. Usuarios a Excluir tiene a Cuenta de integración y Campos a Excluir tiene Imagen (Producto). A la derecha, el grupo Logging muestra las cinco casillas; arriba están el botón Confirm y el estado Borrador marcado.
El costo de un producto se vigila en la varianteEl precio de venta se guarda en el producto, pero el Costo se guarda en cada variante del producto. Una regla sobre Producto anota los cambios del Precio de venta y no los del Costo; para vigilar el costo hace falta una regla sobre Variante del producto. En general, si un cambio no aparece en el registro, conviene revisar si el dato pertenece a otro tipo de dato.
3

Activar y desactivar una regla

El botón que pone la regla en marcha, lo que cambia en pantalla y cómo detenerla.

Una regla guardada no vigila nada hasta que se confirma. Con la regla abierta, el botón Confirm (se ve en inglés) del encabezado la activa y el estado pasa de Borrador a Confirmed (también en inglés). Al confirmar:

  • La regla vale para todas las personas, salvo las de Usuarios a Excluir, y se aplica a partir de ese momento. Puede demorar unos segundos en tomar efecto en todo el sistema.
  • El formulario queda en solo lectura: no se puede cambiar ningún dato de la regla.
  • En cada registro del tipo de dato vigilado aparece, en el menú Acciones, la opción Ver registros (sección 4).
  • No se anota nada hacia atrás: lo ocurrido con anterioridad a la confirmación no figura en el registro.

Para detenerla se usa el botón Set to Draft (se ve en inglés): la regla vuelve a Borrador, deja de anotar y desaparece la opción Ver registros. Las entradas ya guardadas se conservan. Eliminar la regla (Acciones > Eliminar) tiene el mismo efecto y tampoco borra las entradas.

Para modificar una regla activa: pasarla a borrador con Set to Draft, hacer los cambios y volver a presionar Confirm. Los cambios solo se aplican al confirmar. Un mismo tipo de dato admite una sola regla; si se intenta crear otra, el sistema avisa «There is already a rule defined on this model.» seguido de «You cannot define another: please edit the existing one.» (en inglés): hay que abrir la regla existente. Si se guarda una regla sin Modelo, el aviso es «No hay modelo definido para crear la línea.».

Regla Cambios en productos ya confirmada: el estado marcado es Confirmed y el encabezado muestra el botón Set to Draft. Modelo, Tipo, Usuarios a Excluir, Campos a Excluir y las casillas de Logging se ven sin poder editarse.
Ficha del producto Guantes de seguridad con el menú del engranaje (Acciones) desplegado. Entre sus opciones figura Ver registros, entre Obtener imágenes desde Barcode Lookup e Imprimir etiquetas.
4

Consultar las entradas

Tres lugares para buscar, y cómo responder las preguntas más comunes de una auditoría.

DóndeQué muestraQuién puede
Menú Acciones > Ver registros de un registro (en la ficha, o en la lista con ese registro marcado)Las entradas de ese registro, y de ningún otro.Usuario del Auditlog, Gestor y administradores.
Ajustes > Técnico > Auditoría > RegistrosUna fila por operación, de todos los tipos de dato vigilados.Administradores.
Ajustes > Técnico > Auditoría > Líneas de RegistroUna fila por cada campo modificado, con su valor anterior y posterior.Administradores.

La lista Registros. Se ordena de lo más reciente a lo más antiguo y muestra Creado en (fecha y hora), Nombre del Recurso (el nombre del registro afectado), Modelo, ID del Recurso (el número interno del registro), Método (qué operación fue) y Usuario. En el buscador se escribe un texto y se elige por cuál campo buscar entre Nombre del Recurso, Modelo, ID del Recurso y Usuario. En Agrupar por hay Usuario, Modelo, ID del Recurso, Fecha, Sesión de usuario y Solicitud HTTP. Al elegir Fecha se despliegan las opciones Año, Trimestre, Mes, Semana y Día. No hay filtros listos por fecha ni por operación: para acotar a un rango de fechas se usa Filtros > Filtro personalizado... con el campo Creado en.

La lista Líneas de Registro. Abre agrupada por Modelo. Muestra Creado en, Usuario, Nombre (el registro afectado), Descripción (el campo modificado), Valor viejo del Texto y Nuevo valor de Texto. Con el selector de columnas, al final del encabezado, se suman la sesión, la solicitud HTTP, el campo, su nombre técnico y los valores sin formato. Además de las agrupaciones de la lista anterior permite agrupar por Campo.

Cómo se responden las preguntas típicas:

PreguntaCómo se responde
¿Quién modificó el precio de este producto?Abrir el producto y elegir Acciones > Ver registros. Abrir las entradas con Método «write» y buscar la que incluya Precio de venta. Requiere una regla confirmada sobre Producto con anterioridad a la modificación. Para ver todos los productos a la vez, usar Líneas de Registro, agrupar por Modelo y por Campo y abrir el grupo del precio.
¿Quién eliminó este contacto?Un registro eliminado no tiene Ver registros. En Registros, buscar el nombre del contacto en Nombre del Recurso y mirar la entrada con Método «unlink».
¿Quién exportó la lista de clientes?En Registros, buscar el tipo de dato en Modelo y mirar las entradas con Método «export_data». Cada una indica quién, cuándo y, con el botón Exported Records, qué registros se exportaron. Requiere la casilla Log Exports.
¿Qué hizo esta persona ayer?En Registros, buscar a la persona en Usuario, agrupar por Fecha y elegir Día. Solo aparece lo ocurrido en tipos de dato con regla activa.
¿Quién abrió esta ficha?Solo se puede responder si la regla tiene tildada Lectura de Registro con anterioridad a esa consulta; con esa casilla, Ver registros muestra también las aperturas.
Lista Registros con ocho entradas de Auditor interno, Responsable comercial y Analista de precios, con cuatro operaciones en la columna Método: create, write, unlink y export_data. El menú del buscador está abierto y muestra Agrupar por con Usuario, Modelo, ID del Recurso, Fecha, Sesión de usuario y Solicitud HTTP.
Lista Líneas de Registro agrupada por Modelo y luego por Campo, con el grupo Producto abierto. Dentro, Precio de venta (Producto) reúne tres líneas, y Valor viejo del Texto y Nuevo valor de Texto muestran 2800.0 y 3150.0, 3150.0 y 3400.0, y 3400.0 y 2800.0.
5

Leer una entrada hasta el valor anterior y el posterior

Qué significa cada dato de una entrada y cómo se interpretan los valores según la operación.

Al abrir una entrada de la lista Registros, el grupo Registro reúne:

DatoQué es
Creado enFecha y hora de la operación, en la zona horaria de quien consulta.
UsuarioLa persona que hizo la operación.
MétodoLa operación, con una palabra en inglés tal como se ve en pantalla (tabla siguiente).
TipoRegistro completo o Registro rápido, según estaba la regla en ese momento.
Modelo, ID del Recurso, Nombre del RecursoEl tipo de dato, el número interno del registro afectado y su nombre en el momento de la operación. En las exportaciones, el nombre del recurso muestra el nombre interno del tipo de dato, y en lugar del número aparece Resource IDs (en inglés), con la lista de números de los registros exportados.
Qué se ve en «Método»Qué operación es
createAlta de un registro.
writeModificación de un registro existente.
unlinkEliminación.
readLectura: alguien abrió o consultó el registro.
export_dataExportación de registros desde una lista.

El grupo Campos actualizados lista los campos de la operación con Descripción (el nombre del campo tal como se ve en las pantallas), Nombre técnico, Valor viejo del Texto y Nuevo valor de Texto. Al abrir una línea se ve el cuadro Abrir: Campos actualizados, que suma Valor Viejo y Nuevo Valor sin formato. Los campos que apuntan a otro registro (un cliente, una categoría) se ven como un número interno seguido del nombre; en los campos que apuntan a varios registros, como las etiquetas, el valor sin formato muestra solo números y el texto muestra los nombres. Las casillas se ven con «True» cuando están tildadas y en blanco cuando no.

Cómo leer cada tipo de entrada:

OperaciónQué se ve en los campos actualizados
createEl valor inicial de cada campo; el valor viejo queda vacío. Con Registro completo hay una línea por cada campo, también los vacíos.
writeSolo los campos modificados, con el valor anterior y el posterior. Con Registro completo pueden aparecer campos que la persona no tocó, porque se calculan a partir de otros (por ejemplo, un total). Con Registro rápido el valor viejo está vacío.
unlinkSin campos, salvo que la regla tenga Log values on deletion: en ese caso, todos los valores que tenía el registro, en el valor viejo.
readLos valores que se leyeron, en el valor viejo; el valor posterior queda vacío. Hay una entrada por cada registro leído.
export_dataSin campos. El botón Exported Records (se ve en inglés) abre la lista de los registros exportados. No se guarda qué columnas se exportaron.
Entrada de Analista de precios sobre [GUA-SEG] Guantes de seguridad, con Método write y Tipo Registro completo. En Campos actualizados figura la fila Precio de venta, con 2800.0 en Valor viejo del Texto y 3150.0 en Nuevo valor de Texto; Sesión y Solicitud HTTP, en Contexto HTTP, están vacías.
Entrada de Auditor interno con Método export_data sobre Contacto. Arriba está el botón Exported Records; a la derecha, Resource IDs muestra [25, 26, 27] y la lista Campos actualizados no tiene filas.
6

Sesión y solicitud, y lo que no se registra

Qué dato de la conexión acompaña a cada entrada y cuáles son los límites de la auditoría.

Cuando la operación se hizo desde el navegador, la entrada queda vinculada a dos datos que se ven en el grupo Contexto HTTP:

  • Sesión: la conexión de esa persona al sistema, identificada por un código de sesión. Todas las operaciones de una misma conexión comparten la misma sesión: agrupar por Sesión de usuario muestra todo lo que se hizo en una sola conexión. Las sesiones se listan en Ajustes > Técnico > Auditoría > Sesiones de usuario, con el usuario, la fecha y el código.
  • Solicitud HTTP: el pedido concreto que hizo el navegador al sistema y que produjo la operación. Se lista en Ajustes > Técnico > Auditoría > Solicitudes HTTP. Guarda la dirección del sistema (URL Root), la Ruta interna de la operación, la fecha, la persona, la sesión y el Contexto, que es la configuración de esa persona en ese momento (idioma, zona horaria y datos internos).

Las operaciones que no vienen del navegador, como las que hace un proceso automático del sistema, no tienen sesión ni solicitud: el grupo Contexto HTTP queda vacío.

Lo que NO se registra, para no esperar de la auditoría más de lo que da:

Qué no queda anotadoDetalle
Lo ocurrido sin una regla activaTipos de dato sin regla confirmada, y todo lo anterior a la confirmación. Una regla en Borrador no anota.
Operaciones de personas excluidas y campos excluidosLas de Usuarios a Excluir y las de Campos a Excluir. Tampoco se anotan nunca la fecha ni el usuario de creación y de última modificación del registro, que ya constan en la propia entrada.
Datos calculados que no se guardanPor ejemplo, el costo visto desde Producto (ver el recuadro de la sección 2).
Modificaciones sin cambiosUn guardado que no altera ningún valor no deja entrada.
Lecturas, si no se tildó Lectura de RegistroY aun con la casilla tildada, hay tipos de dato en los que la lectura no se anota.
Qué columnas se exportaronSolo se guarda quién exportó y qué registros.
Dirección de red y dispositivoNo se guarda la dirección IP ni el navegador o equipo de la persona. Tampoco se guardan, como entradas, los ingresos al sistema ni los intentos fallidos. Una sesión figura solo si esa conexión hizo alguna operación sobre un tipo de dato vigilado; por eso, tras un ingreso, Solicitudes HTTP y Sesiones de usuario pueden mostrar un pedido «/web/login» de Public user sin ninguna entrada asociada.
Cambios hechos fuera del sistemaLos que se aplican directamente sobre la base de datos, sin pasar por las pantallas ni los procesos del sistema.

Un último límite, importante para un auditor: las entradas no están protegidas contra su modificación. Quien tenga el permiso de Gestor del Auditlog o la función de Administrador puede editar o eliminar entradas. La auditoría documenta lo ocurrido, pero no es a prueba de manipulaciones por quien administra el sistema.

Ficha de una solicitud HTTP con URL Root, Ruta, Creado en, Contexto y Sesión; los valores de URL Root, Contexto y Sesión se muestran difuminados. Debajo, la lista Registros trae la entrada write sobre un Contacto que produjo esa solicitud.
7

Cuánto tiempo se guarda, cómo se depura y qué impacto tiene

Una limpieza automática que viene apagada, y el efecto de auditar de más sobre el tamaño y la velocidad del sistema.

Cuánto tiempo se guarda. Las entradas no vencen solas: se conservan sin límite mientras no se active la limpieza automática, que viene apagada. Se activa en Ajustes > Técnico > Automatización > Acciones planificadas (con el modo desarrollador): se abre la acción Auto-eliminar registros de auditoría y se enciende el interruptor Activo. Corre una vez por día (Ejecutar cada 1 día) y elimina, de forma definitiva, las entradas con más de 180 días (seis meses), junto con sus líneas, y también las solicitudes HTTP y las sesiones de esa antigüedad. El botón Ejecutar de forma manual la ejecuta en el momento.

Para conservar un plazo distinto, en la pestaña Código de esa acción hay una línea de código con un número entre paréntesis (180): es la cantidad de días y se reemplaza por otro. Si los registros tienen que guardarse por exigencia legal o de la organización, conviene fijar el plazo con quien corresponda y exportar lo necesario previo a activar la limpieza, porque lo eliminado no se recupera. La primera ejecución sobre un historial grande puede ser lenta, por lo que conviene lanzarla fuera del horario de trabajo.

Depurar a mano. En la lista Registros, quien tiene el permiso de Gestor del Auditlog o la función de Administrador puede marcar entradas y eliminarlas con Acciones > Eliminar.

Impacto en el tamaño y la velocidad. Auditar tiene un costo que crece con el uso:

Qué lo aumentaPor qué
Cantidad de operacionesCada operación vigilada escribe una entrada, más una línea por campo y, desde el navegador, una solicitud y una sesión. Una importación o una actualización masiva de miles de registros genera miles de entradas.
Lectura de RegistroEs la que más pesa: cada vez que se abre una ficha o se muestra una lista, se escribe una entrada por registro leído, con todos los campos mostrados. Conviene usarla solo por períodos cortos y en pocos tipos de dato.
Registro completoLee los valores previos y posteriores de cada modificación, por lo que guardar un registro vigilado tarda más, y las altas escriben una línea por cada campo.
Campos pesadosLas imágenes y otros archivos guardados en un campo pueden llenar el registro de datos voluminosos. Conviene excluirlos en Campos a Excluir.

Recomendaciones: vigilar solo los tipos de dato que importan, empezar con creaciones, modificaciones y eliminaciones, usar Registro rápido en los datos de mucho movimiento, excluir las cuentas de integración con otros sistemas y activar la limpieza automática. Una regla sobre un tipo de dato muy movido, como los mensajes o los asientos contables, puede hacer crecer el registro con rapidez.

Acción planificada Auto-eliminar registros de auditoría, con Ejecutar cada 1 día, el interruptor Activo apagado y Siguiente fecha de ejecución 12 nov, 1:57 p. m. En el encabezado está el botón Ejecutar de forma manual y, en la pestaña Código, la línea model.autovacuum(180).
8

Preguntas frecuentes y errores

Lo que más se consulta cuando no hay menú, no hay entradas o falta el valor anterior.

Qué pasaPor qué y qué hacer
No aparece el menú AuditoríaHace falta la función Administrador y el modo desarrollador, porque está dentro de Técnico. Los permisos del Auditlog solos no lo muestran.
No aparece Ver registros en AccionesLa regla de ese tipo de dato no está confirmada, o la persona no tiene al menos el permiso Usuario del Auditlog, o se abrió un registro de otro tipo (por ejemplo, una variante cuando la regla es sobre Producto).
La regla no registra nadaRevisar que el estado sea Confirmed y no Borrador; que la operación esté tildada en Logging; que la persona no esté en Usuarios a Excluir ni el campo en Campos a Excluir; y que la operación sea posterior a la confirmación.
Aparece una entrada, pero sin valor anteriorEs un alta, o la regla es de tipo Registro rápido, que no guarda lo que había.
Una entrada de eliminación no muestra ningún valorLa regla no tiene tildada Log values on deletion, o es de tipo Registro rápido. La eliminación igualmente figura, con el nombre del registro.
No se puede editar la reglaEstá confirmada. Se pasa a borrador con Set to Draft, se cambia y se vuelve a confirmar.
Se elimina la regla y siguen apareciendo entradasEs lo esperado: eliminar o pasar a borrador una regla detiene el registro, pero no borra lo ya guardado.
Avisa «There is already a rule defined on this model.»Ya existe una regla para ese tipo de dato (sección 3). Se edita la existente.
Avisa «No hay modelo definido para crear la línea.»Se guardó la regla sin elegir el Modelo.
En Método hay palabras en inglésSon las operaciones tal como las muestra el sistema: ver la tabla de la sección 5.
El registro crece muy rápido o el sistema se vuelve lentoRevisar si hay reglas con Lectura de Registro tildada o sobre tipos de dato muy movidos, y activar la limpieza (sección 7).