Configurações do administrador: registro

Painel de registro

O painel Registro mostra as 500 mensagens de registro mais recentes do sistema que foram geradas pela 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 mostradas no painel de registros. Para fazer isso, digite o texto no campo Filtro para que o painel "Registro" mostre apenas as mensagens com 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 exibidas 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 as Análises de atividades do sistema.

Níveis de registro

Na seção Log Levels, é possível definir o nível de gravidade mínimo necessário para que uma mensagem apareça no registro para vários serviços diferentes do Looker. Assim, você pode 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, ou seja, 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, Informações detalhadas ou depuração. 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 as instruções SQL em um banco de dados interno (em que são armazenados os metadados de objetos do Looker criados pelos usuários) e em um banco de dados 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 em seguida, do menos grave ao mais grave:

  • debug: as entradas de registro de depuração são mensagens detalhadas que mostram os processos internos de aplicativos do Looker. Normalmente, esse nível de gravidade é usado 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: essas mensagens indicam situações potencialmente perigosas.

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

  • fatais: essas mensagens indicam eventos de erro muito graves que provavelmente interromperão 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 do menu suspenso Padrão. O nível de gravidade padrão do menu suspenso Padrão é informações.

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 em qualquer banco de dados do cliente.

  • db:looker: mensagens geradas por consultas para o 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 geradas por conexões SSH com o serviço Git. A configuração padrão é o nível warn, que não exibe informações. Mude para o nível info para resolver problemas de conexão SSH.

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

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

  • 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 definir o formato do registro em instâncias hospedadas pelo cliente

Por padrão, as mensagens do sistema são exibidas em texto no 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ídas em várias linhas. Isso pode causar problemas para processadores de registros que exigem entradas de linha única para a correspondência de padrões.

Se a instância do Looker for hospedada pelo cliente e você precisar de 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 abaixo 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"}