Configurações de administrador: registro

Painel de registro

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

É possível limitar as informações exibidas no painel "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 Como criar relatórios de uso do Looker com explorações de atividades do sistema.

Níveis de registro

Na seção Níveis de registro, é possível definir o nível mínimo de gravidade necessário para que uma mensagem apareça no registro em vários serviços diferentes do Looker. Isso permite ocultar as 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 a geração de registros 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 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 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: mensagens informativas padrão que mostram eventos regulares que ocorrem no Looker.

  • alertar: 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 vão interromper a execução do Looker.

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 default usarão o nível de gravidade no menu suspenso Padrão. O nível de gravidade padrão do menu suspenso Padrão é info.

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 ao banco de dados de análise ou por consultas ao banco de dados de qualquer 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 componentes 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.

  • 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. Ela é usada pelo programador, pela regeneração de PDT e por outras tarefas de longa duração.

  • raven: mensagens geradas pelo serviço do Error Reporting.

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

  • scheduler: mensagens que são 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 configurar o formato do 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ída 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"}