Configurações do administrador: registro

Painel de registros

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

É possível limitar as informações exibidas no painel "Registro". Para fazer isso, digite no campo Filtro para que o painel "Registro" mostre apenas mensagens que incluam 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 exibidas nos serviços do Looker, ajuste os níveis de registro.

Para criar relatórios sobre o uso da sua instância do Looker, consulte a página de documentação Como criar relatórios de uso do Looker com as explorações de atividades do sistema.

Níveis de registro

A seção Níveis de registro permite que você defina o nível mínimo de gravidade necessário para que uma mensagem apareça no registro, para 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 dos serviços db:* e db:looker é definido como info. Isso 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 é verdadeiro para as 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 as instruções SQL em um banco de dados interno, no qual são armazenados metadados de objetos do Looker criados pelos usuários, e em bancos de dados externos, em que 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 informações detalhadas que mostram os processos internos do aplicativo Looker. Esse nível de gravidade é usado normalmente apenas para depuração do código interno.

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

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

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

  • error: essas mensagens indicam eventos de erro que provavelmente não são graves o suficiente para interromper a execução do Looker.

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

Descrições de serviços

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

Você também pode 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 ao banco de dados de qualquer cliente.

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

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

  • http_core: mensagens geradas a partir de solicitações HTTP para o servidor da Web principal que disponibiliza o conteúdo interno do aplicativo.

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

  • logger: mensagens que são 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 TDP e por outras tarefas de longa duração.

  • raven: mensagens geradas pelo serviço de relatório 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 configurar 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í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 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"}