Definições de administrador – Registo

Painel de registo

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

Pode limitar as informações apresentadas no painel Registo. Para tal, introduza texto no campo Filtro para que o painel Registo mostre apenas mensagens que incluam esse texto.

Para atualizar o registo e mostrar as 500 mensagens mais recentes, selecione Atualizar registo.

Para ajustar o nível de gravidade das mensagens de registo apresentadas para os serviços do Looker, ajuste os níveis de registo.

Níveis de registo

A secção Níveis de registo permite-lhe definir o nível de gravidade mínimo necessário para que uma mensagem seja apresentada no registo, para vários serviços do Looker diferentes. Isto permite-lhe ocultar informações de registo que não lhe interessam.

O nível de gravidade predefinido para os serviços db:* e db:looker está definido como info, o que significa que as declarações SQL que contêm ou filtram informações pessoais (por exemplo, nomes de clientes) são registadas pelo Looker. Isto aplica-se às definições de gravidade de info, verbose ou debug. Para desativar o registo de declarações SQL, defina o nível de gravidade dos serviços db:* e db:looker como aviso, erro ou fatal.

O Looker regista declarações SQL numa base de dados interna (onde os metadados dos objetos do Looker criados pelos utilizadores são armazenados) e numa base de dados externa (onde os dados e os metadados dos clientes são armazenados).

Descrições de gravidade

Os níveis de gravidade das mensagens de registo são apresentados a seguir, do menos grave para o mais grave:

  • debug: as entradas do registo de depuração são mensagens de informações detalhadas que mostram os processos internos da aplicação do Looker. Este nível de gravidade é normalmente usado apenas para depurar código interno.

  • verbose: estas são mensagens informativas detalhadas que mostram eventos que ocorrem no Looker a um nível mais detalhado. Normalmente, este nível de gravidade só é usado para resolução de problemas.

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

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

  • erro: estas mensagens indicam eventos de erro que provavelmente não são suficientemente graves para fazer com que o Looker pare de ser executado.

  • fatal: estas 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 pendente Predefinição define o nível de gravidade predefinido para todos os serviços do Looker. Todos os serviços definidos como predefinição usam o nível de gravidade no menu pendente Predefinição. O nível de gravidade predefinido do menu pendente Predefinição é info.

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 à base de dados de estatísticas ou por consultas a qualquer base de dados de clientes.

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

  • http: mensagens geradas a partir de pedidos HTTP que o servidor Web de front-end está a receber ou processar.

  • http_core: mensagens geradas a partir de pedidos HTTP para o servidor Web principal que serve os detalhes internos da aplicação.

  • jsch: mensagens geradas por ligações SSH ao serviço Git. A predefinição é o nível warn, que não apresenta informações. Altere para o nível info para resolver problemas de ligação SSH.

  • logger: mensagens geradas quando faz alterações ao nível do registo.

  • org.apache.active: mensagens geradas pelo ActiveMQ. O ActiveMQ é um serviço de mensagens que o Looker usa para comunicar tarefas entre subsistemas. É 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 do programador.

Depois de modificar o nível do registo de um serviço, selecione Definir níveis para guardar as alterações.

Definir o formato do registo em instâncias alojadas pelo cliente

Por predefinição, as mensagens do sistema são apresentadas 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 saída de várias linhas. Isto pode causar problemas para os processadores de registos que requerem entradas de linha única para a correspondência de padrões.

Se a sua instância do Looker for alojada pelo cliente e precisar de um resultado de linha única, pode usar a --log-format=json opção de arranque para formatar as entradas do registo em estruturas JSON de linha única. O exemplo seguinte mostra os mesmos eventos que o 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"}