Configurações de administrador: registro

Painel de registros

O painel Registro mostra as 500 mensagens de registro do sistema mais recentes geradas pela instância do Looker. Para acessar a página Registro, na seção Servidor do menu Admin, selecione Registro.

É possível limitar as informações mostradas no painel "Registro". Para fazer isso, insira texto no campo Filtrar para que o painel "Registro" mostre apenas as mensagens que incluem esse texto.

Para atualizar o registro e mostrar as 500 mensagens mais recentes, selecione Atualizar registro.

Para ajustar o nível de gravidade das mensagens de registro mostradas para os serviços do Looker, ajuste os níveis de registro.

Níveis de registro

A seção Níveis de registro permite definir o nível mínimo de gravidade necessário para que uma mensagem apareça no registro de vários serviços diferentes do Looker. Isso permite ocultar informações de registro que não são do seu interesse.

O nível de gravidade padrão para os serviços db:* e db:looker é definido como info, o que significa que as instruções SQL que contêm ou filtram informações pessoais (por exemplo, nomes de clientes) são registradas pelo Looker. Isso é válido para configurações de gravidade de info, verbose ou debug. Para desativar o registro de instruções SQL, defina o nível de gravidade dos serviços db:* e db:looker como warn, error ou fatal.

O Looker registra instruções SQL em um banco de dados interno (onde os metadados dos objetos do Looker criados pelos usuários são armazenados) e em bancos de dados externos (onde os dados e metadados do cliente são armazenados).

Descrições de gravidade

Os níveis de gravidade das mensagens de registro são listados a seguir, do menos grave ao mais grave:

  • debug: as entradas de registro de depuração são mensagens de informações detalhadas que mostram os processos internos do aplicativo do Looker. Esse nível de gravidade geralmente é usado apenas para depurar o código interno.

  • verbose: são mensagens informativas detalhadas que mostram eventos que ocorrem no Looker em um nível mais refinado. Esse nível de gravidade geralmente é usado apenas para solução de problemas.

  • info: são mensagens informativas padrão que mostram eventos regulares que ocorrem no Looker.

  • warn: essas mensagens indicam situações potencialmente prejudiciais.

  • erro: essas mensagens indicam eventos de erro que provavelmente não são graves o suficiente para fazer com que o Looker pare de ser executado.

  • fatal: essas mensagens indicam eventos de erro muito graves que provavelmente farão com que o Looker pare de ser executado.

Descrições do serviço

A lista suspensa Padrão define o nível de gravidade padrão para todos os serviços do Looker. Todos os serviços definidos como padrão usam o nível de gravidade na lista suspensa Padrão. O nível de gravidade padrão para a lista suspensa Padrão é info.

Também é possível definir níveis de gravidade individualmente para os seguintes serviços:

  • pdt: mensagens associadas ao processo de tabela derivada persistente.

  • db:*: mensagens geradas por consultas ao banco de dados de análise ou por consultas a qualquer banco de dados do cliente.

  • db:looker: mensagens geradas por consultas ao banco de dados de back-end do Looker.

  • http: mensagens geradas por solicitações HTTP que o servidor da Web de front-end está recebendo ou processando.

  • http_core: mensagens geradas por solicitações HTTP ao servidor da Web principal que atende aos elementos internos do aplicativo.

  • jsch: mensagens geradas por conexões SSH ao serviço Git. A configuração padrão é o nível warn, que não mostra informações. Mude para o nível info para resolver problemas de conexão SSH.

  • logger: mensagens geradas quando você faz alterações no nível de registro.

  • org.apache.active: mensagens geradas pelo ActiveMQ. O ActiveMQ é um serviço de mensagens que o Looker usa para comunicar tarefas entre subsistemas. Ele é usado pelo programador, pela regeneração de PDTs e por outras tarefas de longa duração.

  • raven: mensagens geradas pelo serviço de relatórios de erros.

  • render: mensagens geradas pelo renderizador, que renderiza PDFs e PNGs.

  • scheduler: mensagens geradas pelo processo do programador.

Depois de modificar o nível de registro de um serviço, selecione Definir níveis para salvar as alterações.

Como definir o formato de registro em instâncias hospedadas pelo cliente

Por padrão, as mensagens do sistema são mostradas em texto usando o seguinte 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

Algumas mensagens do sistema, como exceções e consultas SQL, são geradas como saída de várias linhas. Isso pode causar problemas para processadores de registro que exigem entradas de linha única para correspondência de padrões.

Se a instância do Looker for hospedada pelo cliente e você precisar de uma saída de linha única, use a --log-format=json opção de inicialização para formatar as entradas de registro em estruturas JSON de linha única. O exemplo a seguir mostra os mesmos eventos do exemplo anterior, mas no 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"}