¶ 1. Visión General.
Dentro de T6 tenemos el almacenamiento de los logs del sistema guardados en la base de datos. Para reducir el espacio asignado y facilitar su visualización, contamos con el parámetro Log Retention, que nos permite seleccionar la cantidad (en meses) de logs que se almacenarán en la tabla REP_LOG_SECURITY_TRAIL de la base de datos. Los logs almacenados en la tabla corresponden a login, logout, cambios en permisos, cambios en el sistema, creación, modificación y eliminación de objetos del explorer.
¶ 1.1. Requisitos Previos.
Como requisito previo para cambiar el período de retención de registros, se necesita un usuario con la feature de administrador Gestionar parámetros y configuraciones del sistema habilitada.
¶ 2. Uso.
Para utilizar la Retención de Registros, seguiremos los siguientes pasos:
- Ir al menú principal de la plataforma en Configuraciones y seleccionar la opción Parámetros;
- Se abrirá un panel lateral donde haremos clic en
; - Localizar el campo LLog Retention;
- Completar el campo con el período en meses durante el cual el sistema almacenará los logs en la base de datos;
Por defecto, el parámetro Log Retention estará en blanco, lo que hará que se almacenen en la base de datos todos los registros generados. Al completar el campo del parámetro, todos los logs almacenados que no estén dentro del período informado serán eliminados permanentemente.
- Para que el cambio entre en vigor, necesitaremos llamar a la API;
- La llamada de la API puede hacerse de dos formas:
- Directamente a través del navegador utilizando el endpoint:
- Ejemplo de entorno cloud:
qablue.tech6cloud.com/api/log/DeleteLogRetention; (en este caso, qablue es el nombre de su dominio.) - Ejemplo de entorno local:
(servidor de IIS)/(nombre de la aplicación en IIS)/api/log/DeleteLogRetention
- Ejemplo de entorno cloud:
La URL informada antes de la API dependerá de su dominio en cloud o, en caso de entorno local, de las configuraciones definidas en IIS (Internet Information Services).
- Haciendo la llamada de forma externa, utilizando, por ejemplo, Swagger. (Para más información sobre cómo utilizarlo, acceda a nuestro Centro de Ayuda: Swagger)
¶ 3. Q&A
Preguntas Frecuentes
1. ¿Qué es la retención de logs en T6?
Es un parámetro que permite definir por cuántos meses los logs del sistema permanecerán almacenados en la base de datos. Esto ayuda a reducir el espacio asignado y facilita la visualización.
2. ¿Qué tipos de logs se almacenan?
Los tipos de logs almacenados incluyen:
- login;
- logout;
- cambios en permisos;
- cambios en el sistema;
- creación;
- modificación;
- eliminación de objetos del explorer.
3. ¿Quién puede cambiar el período de retención de logs?
Para cambiar el período de retención de logs, se requiere que el usuario tenga habilitada la funcionalidad de administrador Gestionar parámetros y configuraciones del sistema.
4. ¿Cómo cambiar el período de retención de logs?
Para cambiar el período de retención de logs, siga estos pasos:
- En el menú principal de T6, acceda a Configuraciones;
- Seleccione Parámetros;
- En el panel lateral, haga clic en Sistema;
- Localice el campo Log Retention y defina el período en meses;
- Para que el cambio entre en vigor, es necesario llamar a la API
api/log/DeleteLogRetention.
5. ¿Qué sucede si dejo en blanco el parámetro Log Retention?
Si deja en blanco el parámetro Log Retention, por defecto todos los registros generados se almacenarán indefinidamente en la base de datos.
6. ¿Qué ocurre con los logs antiguos cuando defino un período de retención?
Si existen logs antiguos, después de definir un período de retención, todos los logs que no estén dentro del período informado serán eliminados permanentemente.
7. ¿Cuáles son las formas de llamar a la API para retención de logs?
La llamada a la API puede hacerse de dos formas:
Directamente por el navegador: dominio.tech6cloud.com/api/log/DeleteLogRetention
A través de herramientas externas, como Swagger.
8. ¿Puedo recuperar logs eliminados?
No, la eliminación es permanente cuando se aplica el período de retención de logs.