Configuración del administrador: Registro

Panel de registro

En el panel Registro, se muestran los 500 mensajes de registro del sistema más recientes que generó tu instancia de Looker. Para ver la página Registro, en la sección Servidor del menú Administrador, selecciona Registro.

Puedes limitar la información que se muestra en el panel Registro. Para ello, ingresa texto en el campo Filtrar para que el panel de registro muestre solo los mensajes que incluyan ese texto.

Para actualizar el registro y mostrar los 500 mensajes más recientes, selecciona Actualizar registro.

Para ajustar el nivel de gravedad de los mensajes de registro que se mostrarán para los servicios de Looker, ajusta los niveles de registro.

Para crear informes sobre el uso de tu instancia de Looker, consulta la página de documentación Cómo crear informes de uso de Looker con exploraciones de actividad del sistema.

Niveles de registro

La sección Niveles de registro te permite establecer el nivel de gravedad mínimo necesario para que un mensaje aparezca en el registro, para varios servicios de Looker diferentes. Esto te permite ocultar la información de registro que no te interesa.

El nivel de gravedad predeterminado para los servicios db:* y db:looker está configurado en info, lo que significa que Looker registra las instrucciones de SQL que contienen o filtran información personal (por ejemplo, nombres de clientes). Esto es así para las configuraciones de gravedad de info, verbose o debug. Para desactivar el registro de instrucciones SQL, establece el nivel de gravedad de los servicios db:* y db:looker en warn, error o fatal.

Looker registra las instrucciones SQL en una base de datos interna (donde se almacenan los metadatos de los objetos de Looker que crean los usuarios) y en una base de datos externa (donde se almacenan los datos y metadatos de los clientes).

Descripciones de gravedad

A continuación, se enumeran los niveles de gravedad de los mensajes de registro, del menos grave al más grave:

  • debug: Las entradas de registro de depuración son mensajes de información detallados que muestran los procesos de aplicación internos de Looker. Por lo general, este nivel de gravedad solo se usa para depurar código interno.

  • Detallados: Son mensajes informativos detallados que muestran los eventos que ocurren en Looker a un nivel más detallado. Por lo general, este nivel de gravedad solo se usa para solucionar problemas.

  • info: Son mensajes informativos estándar que muestran eventos normales que ocurren en Looker.

  • advertir: Estos mensajes indican situaciones potencialmente dañinas.

  • error: Estos mensajes indican eventos de error que probablemente no sean lo suficientemente graves para hacer que Looker deje de ejecutarse.

  • fatal: Estos mensajes indican eventos de errores muy graves que probablemente harán que Looker deje de ejecutarse.

Descripciones de los servicios

El menú desplegable Predeterminado establece el nivel de gravedad predeterminado para todos los servicios de Looker. Todos los servicios configurados como predeterminados usarán el nivel de gravedad del menú desplegable Predeterminado. El nivel de gravedad predeterminado para el menú desplegable Predeterminado es info.

También puedes establecer niveles de gravedad de forma individual para los siguientes servicios:

  • pdt: Mensajes asociados con el proceso de tabla derivada persistente.

  • db:*: Mensajes generados por consultas a la base de datos de Analytics o a cualquier base de datos de clientes.

  • db:looker: Mensajes que se generan a partir de consultas a la base de datos del backend de Looker.

  • http: Mensajes que se generan a partir de solicitudes HTTP que recibe o procesa el servidor web de frontend.

  • http_core: Mensajes que se generan a partir de solicitudes HTTP al servidor web principal que entrega los componentes internos de la aplicación.

  • jsch: Son los mensajes que generan las conexiones SSH al servicio de Git. La configuración predeterminada es el nivel de advertencia, que no muestra información. Cambia al nivel de información para solucionar problemas de conexión SSH.

  • logger: Mensajes que se generan cuando realizas cambios en el nivel de registro

  • org.apache.active: Mensajes que genera ActiveMQ. ActiveMQ es un servicio de mensajería que Looker usa para comunicar tareas entre subsistemas. Lo usan el programador, la regeneración de PDT y otras tareas de larga duración.

  • raven: Son mensajes que genera el servicio de Error Reporting.

  • render: Mensajes generados por el procesador, que renderizan los archivos PDF y PNG

  • scheduler: Mensajes que genera el proceso del programador.

Después de modificar el nivel de registro de un servicio, selecciona Establecer niveles (Set Levels) para guardar los cambios.

Configura el formato de registro en instancias alojadas por el cliente

De forma predeterminada, los mensajes del sistema se muestran en texto con el siguiente formato:

2019-09-25 15:14:12.301 -0700 [INFO|007d0|main] :: Starting Looker : Version 6.21.0-localdev-ea88a4
...
2019-10-01 14:37:53.424 -0700 [INFO|0002a|http] :: Request from 0:0:0:0:0:0:0:1  GET /folders/1, {}
...
2019-10-01 14:37:53.425 -0700 [INFO|0002a|db:looker] :: (0.000180s) SELECT count(*) AS "COUNT" FROM "USER" LIMIT 1

Algunos mensajes del sistema, como las excepciones y las consultas en SQL, se generan como resultados de varias líneas. Esto puede causar problemas para los procesadores de registros que requieren entradas de una sola línea para la coincidencia de patrones.

Si tu instancia de Looker está alojada por el cliente y necesitas un resultado de una sola línea, puedes usar la opción de inicio --log-format=json para dar formato a las entradas de registro en estructuras JSON de una sola línea. En el siguiente ejemplo, se muestran los mismos eventos que en el ejemplo anterior, pero en formato JSON:

{"t":"2019-09-25 15:14:56.513 -0700","s":"INFO","rid":"007d0","c":"main","msg":"Starting Looker : Version 6.21.0-localdev-ea88a4"}
...
{"t":"2019-10-01T14:35:37.577 -07:00","s":"INFO","rid":"0002c","c":"http","ip":"0:0:0:0:0:0:0:1","verb":"GET","path":"/folders/1","params":{}}
...
{"t":"2019-10-01T14:35:37.581 -07:00","s":"INFO","rid":"0002c","c":"db:looker","duration":"0.000344","sql":"SELECT count(*) AS \"COUNT\" FROM \"USER\" LIMIT 1"}