Configurações de administrador: registro

Painel de registro

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

É possível limitar as informações exibidas no painel de registro. Para fazer isso, insira um texto no campo Filtro para que o painel de 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 que serão mostradas para os serviços do Looker, ajuste os níveis de registro.

Para criar relatórios sobre o uso na sua instância do Looker, consulte a página de documentação Criar relatórios de uso do Looker com Análises de atividade do sistema.

Níveis de registro

Na seção Níveis de registro, você pode definir o nível mínimo de gravidade necessário para que uma mensagem apareça no registro para vários serviços 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 um banco de dados externo (onde os dados e metadados do cliente são armazenados).

Descrições de gravidade

Os níveis de gravidade da mensagem 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 códigos internos.

  • detalhado: são mensagens informativas detalhadas que mostram eventos que ocorrem no Looker em um nível mais detalhado. 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.

  • aviso: essas mensagens indicam situações potencialmente perigosas.

  • error: 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 de serviços

O menu suspenso 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 vão usar o nível de gravidade no menu suspenso Padrão. O nível de gravidade padrão do menu suspenso Padrão é informações.

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

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

  • db*: mensagens geradas por consultas no banco de dados de análise ou em qualquer banco de dados de cliente.

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

  • http: mensagens geradas a partir de solicitações HTTP que o servidor da Web da interface está recebendo ou processando.

  • http_core: mensagens geradas a partir de solicitações HTTP para o servidor da Web principal que atende aos elementos internos do aplicativo.

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

  • Registrador: mensagens geradas quando você faz mudanças no nível do 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 PDT 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 de scheduler.

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

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

Por padrão, as mensagens do sistema são exibidas 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ídas de várias linhas. Isso pode causar problemas para processadores de registros 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 opção de inicialização --log-format=json para formatar 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"}