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 Filtro para que el panel Registro solo muestre los mensajes que lo incluyan.

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 en tu instancia de Looker, consulta la página de documentación Crea 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 requerido para que un mensaje aparezca en el registro en varios servicios diferentes de Looker. 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á establecido 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 ocurre con la configuración de gravedad de info, verbose o debug. Para desactivar el registro de instrucciones de SQL, configura el nivel de gravedad de los servicios db:* y db:looker como warn, error o fatal.

Looker registra las instrucciones de SQL en una base de datos interna (en la que se almacenan los metadatos de los objetos de Looker creados por los usuarios) y en una base de datos externa (donde se almacenan los datos y metadatos del cliente).

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 del registro de depuración son mensajes de información detallada que muestran los procesos internos de la aplicación de Looker. Por lo general, este nivel de gravedad solo se usa para depurar código interno.

  • detallados: Son mensajes informativos detallados que muestran eventos que ocurren en Looker con un mayor nivel de detalle. Por lo general, este nivel de gravedad solo se usa para solucionar problemas.

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

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

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

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

Descripciones del servicio

En el menú desplegable Predeterminado, se 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 Predeterminada. El nivel de gravedad predeterminado del menú desplegable Default 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 que se generan a partir de consultas a la base de datos de Analytics o consultas a cualquier base de datos de clientes.

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

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

  • 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: Mensajes que se generan mediante conexiones SSH al servicio de Git La configuración predeterminada es el nivel warn, 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: Mensajes que genera el servicio de informes de errores.

  • render: Mensajes que genera el procesador, que renderiza archivos PDF y PNG.

  • scheduler: Mensajes que genera el proceso del programador.

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

Configura el formato de registro en las 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 excepciones y consultas en SQL, se generan como resultados de varias líneas. Esto puede causar problemas en los procesadores de registros que requieren entradas de una sola línea para la coincidencia de patrones.

Si tu instancia de Looker está alojada en el cliente y necesitas un resultado de una sola línea, puedes usar la opción de inicio --log-format=json para formatear 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"}