Diferencias

Muestra las diferencias entre dos versiones de la página.

--- a:system_configuration:logs [2025/05/29 14:20]
creado, vcortes
+++ a:system_configuration:logs [2026/09/14 04:50] (actual)
editor externo, 127.0.0.1
@@ Línea 1: / Línea 1: @@
 ====== Búsqueda de logs ======
+Una búsqueda de logs es el proceso de revisar y analizar los registros (logs) generados en el sistema para obtener información sobre eventos que han ocurrido.
+  - Desde tu **Panel de control** selecciona **Logs.**
+  - **Fecha inicio:** Indica a partir de qué fecha deseas realizar la búsqueda.
+  - **Fecha final:** Indica hasta qué fecha se realizará la búsqueda.
+  - **Buscar endpoints APIv2:** Esta opción te permite hacer la búsqueda de los endpoints que tienes disponibles. Solo la ve el administrador de la escuela; el operador no cuenta con esta opción aunque tenga asignado el permiso de búsqueda de logs.
+  - **Tipo de evento:** Despliega esta opción para seleccionar dónde se realizará la búsqueda: en ambos entornos, web y aplicación ("Todos"); únicamente en la aplicación móvil ("Solo aplicación móvil"); o solo en el modo de prueba ("Solo modo de prueba").
+  - Para hacer la búsqueda da clic en **Aceptar.**
+    * Puedes hacer uso de ciertos filtros para obtener información mucho más detallada.
+      * **Usuario:** Comienza a escribir el apellido del usuario para buscar las acciones que ha realizado. El sistema te arrojará las coincidencias para que selecciones al usuario.{{:a:system_configuration:buscar_usuario_logs.png?direct&400|}}
+      * **ID de transacción:** Puedes agregar el ID que generó la acción que estás buscando.
+      * **Dirección IP:** Agrega la dirección IP de la que quieres consultar las acciones.
+      * **Navegador:** Indica el nombre del navegador en el que se realizó la acción que estás buscando.
+      * **Filtros SQL:** Puedes agregar el nombre de la tabla en la que se guarda la acción que quieres buscar, por ejemplo: \\ UPDATE _g_students.
+      * **Excluir SQL selects:** Se muestran solo resultado de acciones que hicieron alguna modificación en la base de datos.
+      * **Filtro de parámetros:** Puedes agregar los parámetros sobre lo que vas a buscar.
+      * **URL:** Puedes seleccionar las URL´s de navegación de acuerdo a la acción que necesites buscar.
+        * **IMPORTANTE:** Si has aplicado alguno de estos filtros es necesario volver a dar clic en **Aceptar** para buscar.
+  - Aparecerá una barra de progreso con el avance de la búsqueda.
+<notes>La opción para descargar el resultado en formato JSON solo la ve el administrador principal de la plataforma (la cuenta ADMIN001); ningún administrador ni operador de la escuela la tiene disponible.</notes>
+===== Resultados de búsqueda =====
+Se mostrará una tabla con los resultados de la búsqueda en la que podrás observar la siguiente información:
+    * **Tipo:** Indica si la acción fue en la web o en la aplicación Algebraix. Si la acción se hizo en **Modo de prueba** se muestra además un ícono que lo indica.
+    * **URL:** Indica la URL de la acción.
+    * **Fecha:** Muestra la fecha y la hora de la acción.
+    * **Usuario:** Muestra el usuario que llevó a cabo la acción.
+    * **IP:** Indica la IP desde donde se hizo la acción.
+    * **Navegador:** Muestra el navegador desde el cuál se hizo la acción.
+    * **OS:** Muestra el sistema operativo utilizado.
+    * **Agent/transaction ID:** Muestra el ID que generó la acción realizada.
+    * **Expandir:** Al dar clic en esta opción se muestran los **Parámetros** que se enviaron con la acción y las consultas **SQL** que generó contra la base de datos.
+    * Esta información la puedes descargar a Excel dando clic en el ícono {{icon>far fa-file-excel text-green action-item__icon}}
+<notes>Cuando la acción buscada corresponde a la captura de calificaciones, al dar clic en **Expandir** se muestra además una tabla con el detalle de esa captura (instancia de clase, definición de clase, estudiante, periodo, sub-ciclo, ciclo, tema/criterio y el valor capturado).</notes>
+<notes>El administrador principal de la plataforma (la cuenta ADMIN001) ve, además de lo anterior, un enlace para **Eliminar URI** (quita esa fila de la tabla de resultados sin afectar el log) y, tras expandir el detalle, un enlace **Ejecutar SQL** que vuelve a correr las consultas capturadas. Ningún administrador ni operador de la escuela ve estos dos controles.</notes>
+===== Permisos para el operador =====
+Para que el operador pueda realizar estas configuraciones, es necesario asignarle el siguiente permiso al momento de agregarlo o modificar su perfil:
+    * Desde "Permisos globales" > **Configuración general.**
+      * **Búsqueda de logs:** Permite hacer la búsqueda de las acciones realizadas por el resto de los usuarios.
+<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:system_configuration:logs" make -C pipeline revisar</notes>