====== 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>