Registro
El módulo «Registro» en Platform OneEntry permite a los administradores rastrear tanto las acciones de otros administradores en el sistema como la actividad de la API de contenido pública. El módulo consta de cuatro pestañas:
| Pestaña | Qué muestra |
|---|---|
| Registro de acciones de admin | Todas las acciones de los administradores en el sistema: creación, modificación, eliminación de entidades. |
| Tráfico de administradores | Sesiones de inicio de los administradores: cuándo ingresaron, cuándo salieron, desde qué dispositivo. |
| Estadísticas de la API de contenido | Contadores de llamadas a todos los endpoints públicos del sitio durante diferentes períodos. |
| Errores de la API de contenido | Todas las respuestas 4xx/5xx de la API pública con detalles de la solicitud y el stack trace. |
En la interfaz del módulo, las pestañas están etiquetadas como: Registro de Admin, Registro de Acceso a la Aplicación de Admin, Estadísticas de la API de Contenido, Errores de la API de Contenido.
Las pestañas de estadísticas y errores de la API de contenido están disponibles bajo permisos separados — ver Permisos para el registro.
Registro de acciones de admin
La pestaña principal que muestra todas las acciones de los administradores en el sistema.
Elementos de la interfaz
La pestaña consta de dos bloques:
- Filtros
- Lista de acciones
Filtros
Para filtrar acciones, están disponibles los siguientes campos:
- Desde — campo de texto para la fecha a partir de la cual se deben filtrar las acciones.
- Hasta — campo de texto para la fecha hasta la cual se deben filtrar las acciones.
Las fechas se pueden ingresar como una cadena en el formato de fecha de su región, así como seleccionar la fecha necesaria mediante un calendario que aparece al hacer clic en el campo de entrada de fecha.
- ID de Administrador — campo numérico para el identificador único del administrador.
- Acciones del usuario — lista desplegable de acciones del usuario:
- Creación
- Modificación
- Eliminación
- Estado — lista desplegable de estados de las acciones:
- Exitoso
- Error
- Nombre del módulo — lista desplegable de nombres de módulos:
- Administradores
- Conjuntos de atributos
- Respaldo
- Gestión de bloques
- Gestión de eventos
- Configuración general
- Carga de archivos
- Editor de archivos
- Gestión de formularios
- Localización
- Marcadores
- Menú
- Módulos
- Gestión de contenido
- Productos
- Gestión de pedidos
- Configuración básica
- Gestión de pagos
- Gestión del estado del producto
- USUARIO
- Gestión de proveedores de autenticación y usuarios
- Gestión de plantillas
- Gestión de plantillas de vista previa
- ID de Registro — campo numérico para el identificador único del registro.
Debajo del bloque de filtros hay dos botones:
- Eliminar datos — elimina los registros del registro de acciones de admin para el período especificado por los campos Desde / Hasta (ver Limpieza de registros manualmente).
- Restablecer — restablece los filtros aplicados.
Lista de acciones
La lista de acciones se presenta en forma de tabla con seis columnas:
- Acciones del usuario
- Estado
- Inicio de sesión del usuario
- Nombre del módulo
- ID de registro
- Fecha y hora
Para cada columna hay una opción para ordenar los datos haciendo clic en el encabezado de la columna. El primer clic ordenará en orden descendente, el segundo en orden ascendente, el tercero restablecerá la ordenación.
Auditoría de visibilidad del bloque
Cada cambio de visibilidad del bloque (toggle "mostrar/no mostrar" en la administración de bloques) se registra automáticamente en el Registro de acciones de admin. Se puede ver qué administrador y cuándo cambió el estado de un bloque específico.
En la lista de acciones, tal registro se refiere al módulo Gestión de bloques.
Tráfico de administradores (Registro de Acceso de Admin)
La pestaña «Tráfico de administradores» muestra cada inicio y cierre de sesión de un administrador en el sistema como un registro independiente. Se puede ver quién y cuándo ingresó al panel de administración, lo cual es útil para auditoría.
Campos de la tabla
La tabla consta de seis columnas:
| Columna | Qué significa |
|---|---|
| Inicio de sesión | nombre de usuario del administrador |
| IP | dirección IP desde la que ingresó el admin |
| Hora de inicio de sesión | fecha y hora del inicio de sesión |
| Hora de cierre de sesión | fecha y hora del cierre de sesión (para sesiones aún abiertas — Activa) |
| Duración | duración de la sesión (para activa — desde el inicio de sesión hasta el momento actual) |
| Razón | razón del cierre de sesión: Cierre de sesión (salió por su cuenta) o Revocado por Admin (otro admin cerró la sesión forzosamente); para sesiones abiertas — Activa |
Al igual que en el Registro de acciones de admin, cualquier columna se puede ordenar haciendo clic en su encabezado.
El vencimiento de la autorización y su renovación automática no se registran como un registro separado. Una sesión con autorización vencida se marca como cerrada no de inmediato, sino cuando deja de ser utilizada.
Filtros
- Desde / hasta — período (campos de entrada de fecha con calendario).
- ID de Administrador — campo numérico para filtrar por un administrador específico.
- Estado de la sesión — lista desplegable del estado de la sesión: Todos / Activa / Cerrada.
Botón «Eliminar datos»
Elimina los registros de sesiones para el período especificado por los campos Desde / Hasta. Al hacer clic, se abre un diálogo de confirmación:
Confirmar acción — ¿Eliminar todas las sesiones cerradas para el período especificado? Esta acción es irreversible. Las sesiones activas permanecerán.
Se eliminan solo las cerradas. Las sesiones activas (con autorización abierta) no se eliminan.
Estadísticas de la API de contenido
La pestaña «Estadísticas de la API de contenido» muestra contadores de llamadas a todos los endpoints públicos del sitio durante diferentes períodos — 1 hora, 24 horas, 7 días.
Qué muestra
- Lista de todos los endpoints públicos (
GET /api/content/...) — se genera automáticamente, no es necesario llenarlo manualmente. - Contador junto a cada endpoint — cuántas veces se ha llamado durante el período seleccionado.
Elementos de la interfaz
- Período — lista desplegable del período: Última Hora / Últimas 24 Horas / Últimos 7 Días (por defecto — Últimas 24 Horas).
- Actualizar — botón para forzar la actualización de datos.
Los datos se presentan en una tabla de cuatro columnas:
| Columna | Qué significa |
|---|---|
| Ruta | ruta del endpoint (/api/content/...) |
| Método | método HTTP (GET, POST, …) |
| Descripción | breve descripción del endpoint |
| Solicitudes | número de llamadas durante el período seleccionado |
En la parte superior de la página se muestra un banner informativo Auto-limpieza no aplicable: la estadística se lee en tiempo real y no se almacena en el proyecto, por lo que no es necesario limpiarla, y el período de retención de datos en la administración no se configura.
Si los datos de estadísticas no están disponibles temporalmente, aparece un aviso sobre la tabla que dice «Métrica temporalmente no disponible. Todos los endpoints se muestran con un conteo cero». A pesar del texto de advertencia, la tabla en este caso puede estar vacía — con el mensaje «No hay datos disponibles».
Las estadísticas se almacenan por un tiempo limitado, y el período de retención en la administración no se configura. Para análisis durante un período más largo, guarde los datos por su cuenta. Un banner informativo en la parte superior de la página advierte sobre esto.
Para qué sirve
A través de las estadísticas se puede ver qué endpoints de la API de contenido se utilizan y cuáles no se llaman. Una caída abrupta en el número de llamadas a un endpoint generalmente indica un problema en la aplicación cliente.
Los datos se actualizan no más de una vez por minuto: volver a hacer clic en Actualizar dentro de 60 segundos mostrará los mismos valores.
Errores de la API de contenido
La pestaña «Errores de la API de contenido» muestra todas las respuestas 4xx/5xx que ha devuelto la API pública durante un período. Los desarrolladores que integran la aplicación cliente con la API de contenido pueden ver los errores de sus solicitudes directamente en la administración.
Qué muestra
Cada registro es un error HTTP separado. La tabla consta de cinco columnas:
| Columna | Qué significa |
|---|---|
| Hora | marca de tiempo del error |
| Estado | estado HTTP (4xx / 5xx) |
| Método | método de la solicitud (GET, POST, …) |
| Ruta | ruta (/api/content/...) |
| Mensaje | texto del error |
Si no hubo errores durante el período seleccionado, en lugar de la tabla se muestra el mensaje «No se registraron errores para el período seleccionado».
Hacer clic en una fila de la tabla abre una ventana con los detalles del error:
- hora, estado HTTP, método y ruta de la solicitud;
- código y texto del error;
- stack trace — desplegado (hasta 8 KB);
- identificador de la solicitud y número de serie del app-token con el que llegó la solicitud;
- dirección IP y User-Agent del cliente;
- Consulta — parámetros de la cadena de consulta;
- vista previa del cuerpo de la solicitud (sin secretos — contraseñas, tokens, encabezados de autorización están enmascarados).
Filtros
- Desde / hasta — período (campos de entrada de fecha con calendario).
- Estado HTTP — lista desplegable de estados. Se puede seleccionar un grupo (4xx - Lado del cliente, 5xx - Lado del servidor) o un código específico: 400, 401, 403, 404, 422, 500, 502, 503.
- Ruta — campo de texto para filtrar por ruta (por ejemplo,
/api/content/blocks/*).
Botón «Eliminar datos»
Elimina los registros de errores para el período especificado por los campos Desde / Hasta. Si no se especifica el período, elimina todos los errores.
Seguridad — ocultar datos sensibles
Los datos sensibles en los registros de errores se ocultan automáticamente. Los campos password, token, authorization, api_key, x-app-token, cookie, set-cookie (sin distinción de mayúsculas) se reemplazan por ***. Los cuerpos grandes de las solicitudes se recortan a 2 KB.
Limpieza de registros manualmente
Los registros se limpian manualmente — en cada pestaña que almacena registros hay un botón «Eliminar datos»:
| Pestaña | Qué elimina |
|---|---|
| Registro de acciones de admin | registros de acciones de admin para el período seleccionado |
| Tráfico de administradores | solo cerradas sesiones para el período seleccionado |
| Errores de la API de contenido | registros de errores para el período seleccionado |
El período de eliminación se establece mediante los campos Desde / Hasta en los filtros de la pestaña. Si no se especifica el período, se eliminan todos los registros del tipo correspondiente. Antes de eliminar, siempre se muestra un diálogo de confirmación «Confirmar acción», la operación es irreversible.
El botón «Eliminar datos» en la pestaña «Tráfico de administradores» no elimina las sesiones activas de los administradores — incluso si se establece un período que cubre el momento actual, la sesión abierta de un colega en funcionamiento no se eliminará. Solo se eliminan las sesiones cerradas.
Los datos de estadísticas se leen en tiempo real y no se almacenan en el proyecto, por lo que no hay botón «Eliminar datos» en esta pestaña — esto se indica con el banner «Auto-limpieza no aplicable».
Permisos para el registro
Las pestañas Estadísticas de la API de contenido y Errores de la API de contenido están disponibles bajo permisos separados en el árbol de permisos (se abre en una pestaña nueva). Sin el permiso, la pestaña no se muestra.
| Pestaña | Permiso |
|---|---|
| Estadísticas de la API de contenido | journal.viewContentApiStats |
| Errores de la API de contenido | journal.viewContentApiErrors |
Las pestañas «Registro de acciones de admin» y «Tráfico de administradores» son visibles para todos los administradores que tienen acceso al módulo de registro.