Configurações de 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 acessar a página Registro, na seção Servidor do menu Administrador, selecione Registro.

É possível limitar as informações mostradas no painel "Registro". Para isso, insira texto no campo Filtro para que o painel de registros mostre apenas 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

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 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 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 dos clientes 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ódigo interno.

  • verbose: são mensagens informativas detalhadas que mostram eventos ocorrendo no Looker em um nível mais refinado. Normalmente, esse nível de gravidade é 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 nocivas.

  • 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 vão fazer 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 usam 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 de tabela derivada persistente.

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

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

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

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

  • jsch: mensagens geradas por conexões SSH com o serviço Git. A configuração padrão é o nível warn, 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 mudanças 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 mudanças.

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 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"}