Painel de registros
A página Registro mostra as 500 mensagens de registro do sistema mais recentes geradas pela sua instância do Looker. Para ver a página Log, na seção Servidor do menu Administrador, selecione Registro.
- Para limitar as informações exibidas na janela"Registro", digite o texto no campo Filtro, e a janela"Registro"mostrará apenas as mensagens que incluem o texto digitado.
- Clique em Refresh Log para atualizar o registro e mostrar as 500 mensagens mais recentes.
- É possível ajustar o nível de gravidade das mensagens de registro que serão exibidas para vários serviços do Looker. Isso é explicado em mais detalhes abaixo.
A janela "Registro" não é a melhor maneira de analisar o uso ou o histórico do usuário. Em vez disso, se você tiver ativado o recurso Atividade do sistema no Labs, consulte a página de documentação Como criar relatórios de uso do Looker com a atividade dos sistemas. Caso contrário, consulte a página da documentação Como criar relatórios de uso e metadados do Looker com i__looker.
Níveis de registro
A seção Níveis de registro permite definir 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 oculta 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. Isso significa que as instruções SQL que contêm ou filtram informações pessoais (por exemplo, um nome de cliente) são registradas pelo Looker. Isso é válido para as configurações de gravidade de info, detalhado ou depurado. 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 tanto no banco de dados interno (em que armazenamos metadados para objetos do Looker criados pelos usuários) quanto em nossos bancos de dados externos (em que armazenamos dados e metadados do cliente).
Descrições de gravidade
Os níveis de gravidade das mensagens de registro estão listados abaixo, do menos grave ao mais grave:
debug: as entradas do registro de depuração são 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.
Detalhado: são mensagens informativas detalhadas que mostram eventos que ocorrem no Looker em um nível mais refinado. Este nível de gravidade geralmente é usado apenas para solucionar 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 fazer com que o Looker pare de ser executado.
fatal: essas mensagens indicam eventos de erro muito graves que podem causar a interrupçã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 padrão usarão o nível de gravidade no menu suspenso Padrão. O nível de gravidade padrão da lista suspensa Padrão é Informações.
Também é possível definir níveis de gravidade individualmente para os seguintes serviços:
pdt: mensagens associadas ao processo permanente de tabela derivada.
db:*: mensagens geradas por consultas ao banco de dados de análise ou por qualquer banco de dados de clientes.
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 de solicitações HTTP para o servidor da Web principal que atende aos elementos internos do aplicativo.
jsch: mensagens geradas por conexões SSH com o serviço Git. A configuração padrão é alerta, que não exibe informações. Mude para o nível info 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 de relatório de erros.
render: mensagens geradas pelo renderizador, que renderiza PDFs e PNGs.
scheduler: mensagens geradas pelo processo do programador.
Após modificar o nível de registro de um serviço, clique em 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 saídas 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 da 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 acima, 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"}