Configurações de administrador: registro

Painel de registros

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, digite o texto 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 dos 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 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 dos 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 as 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 são armazenados metadados de objetos do Looker criados pelos usuários) e em um externo (em que 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 dos apps do Looker. Normalmente, esse nível de gravidade é usado apenas para depuração de código interno.

  • detalhado: são mensagens informativas detalhadas que mostram os eventos que ocorrem no Looker em um nível mais granular. Normalmente, esse nível de gravidade é usado apenas para solução de problemas.

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

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

Descrições do serviço

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 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 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 de front-end 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 que são geradas por conexões SSH com o serviço do Git. A configuração padrão é o nível warn, que não exibe informações. Mude para o nível de informações 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.

  • renderizar: 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 de registro em instâncias hospedadas pelo cliente

Por padrão, as mensagens do sistema são exibidas em texto com 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 uma 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 estiver 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"}