Como criar relatórios de uso e metadados do Looker com i__looker

Os administradores e os usuários do Looker que receberam a permissão see_system_activity têm acesso ao painel do Uso de uma instância, que se conecta diretamente ao banco de dados do aplicativo subjacente do Looker, chamado i__looker. O banco de dados i__looker armazena informações sobre sua instância do Looker, incluindo todos os visuais e painéis salvos na instância, informações do usuário e 90 dias de consultas históricas:

Nesta página, descrevemos os Explorars mais usados no i__looker e apresentamos alguns exemplos de usos comuns. Essa funcionalidade pode ser útil para fins de auditoria e monitoramento.

O texto SQL e o texto em filtros executados pelos usuários podem ser acessados em i__looker e visualizados por qualquer usuário que tenha permissão para visualizar o modelo i__looker.

Realizar ações: modifique quem tem acesso de visualização ao modelo i__looker. Os administradores do Looker têm acesso a i__looker por padrão. Os usuários que não são administradores podem receber acesso ao i__looker se receberem a permissão see_system_activity.

Dica da equipe do Chat: os dados com base no horário em i__looker são armazenados no fuso horário do sistema do Looker. Consulte a página Como usar as configurações de fuso horário para mais informações.

Explorar histórico

A guia "Explorar histórico" inclui informações sobre cada execução de consulta na sua instância do Looker nos últimos 90 dias.

Você pode acessar o histórico de exploração no seguinte URL, substituindo <instance_name.looker.com> pelo endereço da sua instância do Looker:

https://<instance_name.looker.com>/explore/i__looker/history

A guia "Explorar" do histórico pode ser usada como uma versão mais detalhada do painel Consultas na página Administrador. Ele tem todas as informações no painel Consultas, mas vai além das 50 consultas mais recentes e tem mais informações sobre usuários, papéis, grupos etc.

O que o histórico de exploração não é

A guia "Explorar" do histórico inclui visualizações com os títulos Olhar, Painel e Usuário. Essas visualizações não listam todos os usuários, painéis e aparências da instância. Em vez disso, essas visualizações listam as aparências, os painéis e os usuários que foram acessados ou ativos nos últimos 90 dias. Para ver listas abrangentes de aparências, painéis ou usuários, use as Explorars descritas posteriormente nesta página.

Truncar a tabela Histórico

Como o tamanho da tabela Histórico pode aumentar rapidamente, o Looker exclui automaticamente os registros que atendem a qualquer um dos seguintes critérios:

  • O history.created_time tem mais de 90 dias no passado.
  • O history.created_time tem mais de sete dias no passado, e o history.source é o scheduled_task.

Campos úteis na ferramenta Explorar histórico

Há muitos campos no "Explorar histórico". Estes são alguns dos campos mais usados:

  • history.source: a origem de uma consulta, como um olhar salvo, painel, explorar, tarefa agendada, API etc.

  • history.created_time: a data e a hora em que um evento no histórico de exploração foi criado. Cada evento está vinculado a uma consulta no Looker. As consultas vêm da página "Explorar", os painéis, a aparência, as chamadas de API e os eventos programados.

  • history.result_source: se os resultados de uma consulta foram retornados do cache ou do banco de dados como uma consulta nova.

  • history.runtime_in_seconds: o tempo que uma consulta levou para ser executada. Isso inclui a construção da consulta, sempre que ela é gasta na fila, o tráfego de entrada e saída do banco de dados e a execução do banco de dados da consulta.

  • query.model: o modelo LookML associado a uma consulta.

  • query.explore: a exploração LookML associada a uma consulta.

  • query.sql_text: o SQL real que foi executado para uma consulta.

Examples

Veja abaixo alguns usos comuns do Explorar Histórico. É necessário substituir <instance_name.looker.com> no início do URL pelo endereço da instância do Looker para que esses links funcionem.

Qual é o tempo de execução médio de diferentes modelos na minha instância?

Essa opção lista cada modelo que foi consultado nos últimos 90 dias e mostra o ambiente de execução médio para consultas com base nesses modelos nos últimos 90 dias:

https://<instance_name.looker.com>/explore/i__looker/history?fields=query.model,history.average_runtime&f[history.result_source]=query&sorts=history.average_runtime+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22history.result_source%22%3A%5B%7B%22type%22%3A%22%3D%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22query%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Essa guia lista os títulos de cada painel acessado nos últimos 90 dias e uma contagem do número de vezes que cada um deles foi acessado:

https://<instance_name.looker.com>/explore/i__looker/history?fields=dashboard.title,history.query_run_count&f[dashboard.title]=-NULL&sorts=history.query_run_count+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22dashboard.title%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Essa guia mostra quantas vezes uma exploração foi executada por cada papel na instância nos últimos 90 dias:

https://<instance_name.looker.com>/explore/i__looker/history?fields=history.query_run_count,query.view,role.name&pivots=role.name&f[role.name]=-NULL&sorts=history.query_run_count+desc+0&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22role.name%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Alguém consultou uma exploração específica nos últimos 90 dias?

Você pode usar a ferramenta Explorar histórico para determinar se uma exploração específica foi usada nos últimos 90 dias:

  1. Selecione os campos history.created_date, query.explore e query.link.
  2. Filtre por query.explore e insira o nome da guia"Explorar".
  3. Clique em Executar.

Alguém usou um campo de uma vista específica nos últimos 90 dias?

Você pode usar a ferramenta Explorar histórico para determinar se algum campo de uma vista específica foi usado nos últimos 90 dias:

  1. Selecione os campos history.created_date, query.explore e query.link.
  2. Filtre em query.fields_used, inserindo o nome da visualização seguida por um ponto, como orders., e selecionando contém para a condição de filtro. O período no seu filtro garante que você retorne apenas os campos dessa vista, e não os campos de vistas com nomes semelhantes.
  3. Clique em Executar.

Olhe para explorar

A guia "Explorar" inclui informações sobre todos os aparências salvas na sua instância do Looker, como:

  • Quem criou a aparência e quando eles foram criados
  • Os campos que compõem um Look
  • As pastas em que os visuais são armazenados

Você pode acessar o Look Explore no seguinte URL, substituindo <instance_name.looker.com> pelo endereço da sua instância do Looker:

https://<instance_name.looker.com>/explore/i__looker/look

Campos úteis na ferramenta Explorar visuais

Estes são alguns dos campos mais usados na ferramenta Explorar por visuais:

  • look.created_date: a data em que um Look foi criado.

  • look.deleted_date: a data em que um Look foi excluído. Se o Look não tiver sido excluído, esse campo será NULL.

  • look.public: indicar se a aparência foi ou não publicada.

  • look.public_slug: a parte de hash do URL de visualização.

  • query.link: um link para o Explorar subjacente à aparência.

  • space.name: o nome da pasta em que um Look está armazenado.

Examples

Veja abaixo alguns usos comuns do recurso Explorar por visuais. É necessário substituir <instance_name.looker.com> no início do URL pelo endereço da instância do Looker para que esses links funcionem.

Quantos looks públicos existem?

Essa guia lista todos os aparências na sua instância que se tornaram públicas:

https://<instance_name.looker.com>/explore/i__looker/look?fields=look.id,look.title,look.link&f[look.public]=Yes&sorts=look.title&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22look.public%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22Yes%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%7D%5D%7D&dynamic_fields=%5B%5D&origin=share-expanded

Quais visuais foram excluídos?

Essa guia lista todos os visuais que foram excluídos:

https://<instance_name.looker.com>/explore/i__looker/look?fields=look.id,look.title,look.link,look.deleted_date&f[look.deleted_date]=NOT+NULL&sorts=look.title&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22look.deleted_date%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%227%22%2C%22unit%22%3A%22day%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%2C%22error%22%3Afalse%7D%5D%7D&dynamic_fields=%5B%5D&origin=share-expanded

Em quais pastas minhas aparências são salvas?

A guia "Explorar" lista todos os seus visuais, classificados pela pasta em que estão armazenados:

https://<instance_name.looker.com>/explore/i__looker/look?fields=space.name,look.id,look.title,look.link&f[look.deleted_date]=NOT+NULL&sorts=space.name+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22look.deleted_date%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%227%22%2C%22unit%22%3A%22day%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%2C%22error%22%3Afalse%7D%5D%7D&dynamic_fields=%5B%5D&origin=share-expanded

Painel de exploração

O painel Explorar inclui informações sobre todos os painéis salvos na sua instância do Looker. Assim como no recurso Explorar por visuais, é possível encontrar informações sobre seus painéis, como quem os criou, quando foram criados e em qual pasta residem. Também é possível encontrar informações sobre as configurações e os elementos do painel.

É possível acessar o painel "Explorar" no seguinte URL, substituindo <instance_name.looker.com> pelo endereço da sua instância do Looker:

https://<instance_name.looker.com>/explore/i__looker/dashboard

Campos úteis na ferramenta Explorar do painel

O painel Explorar tem campos semelhantes ao Explorar visual. Além desses campos, veja outros campos usados exclusivamente no recurso Explorar do painel:

Examples

Veja abaixo alguns usos comuns do recurso Explorar do painel. É necessário substituir <instance_name.looker.com> no início do URL pelo endereço da instância do Looker para que esses links funcionem.

Quantos painéis são executados no carregamento?

Essa exploração mostra uma contagem de quantos painéis na instância estão configurados para Executar no carregamento:

https://<instance_name.looker.com>/explore/i__looker/dashboard?fields=dashboard.count&f[dashboard.run_on_load]=Yes&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22dashboard.run_on_load%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22Yes%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%7D%5D%7D&origin=share-expanded

Quantos painéis são atualizados com frequência?

Semelhante a Executar no carregamento, a configuração Atualização automática poderá afetar o desempenho do Looker se você tiver um grande número de painéis que são atualizados automaticamente com frequência. Esta exploração mostra o número de painéis configurados para atualização automática e quantos são atualizados a cada intervalo de tempo:

https://<instance_name.looker.com>/explore/i__looker/dashboard?fields=dashboard.refresh_interval,dashboard.count&f[dashboard.refresh_interval]=-NULL&sorts=dashboard.count+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22dashboard.refresh_interval%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Explorar usuários

A ferramenta Explorar usuários inclui informações sobre todos os usuários da sua instância do Looker. Inclui informações como:

  • Credenciais da API do usuário

  • Grupos de usuários

  • Funções, permissões e conjuntos de permissões atribuídos aos usuários

  • Detalhes e configurações do usuário, como nome, ID e se o usuário está ativado na instância

É possível acessar a exploração de usuários no seguinte URL, substituindo <instance_name.looker.com> pelo endereço da instância do Looker:

https://<instance_name.looker.com>/explore/i__looker/user

Campos úteis na ferramenta Explorar usuários

Estes são alguns dos campos mais usados na exploração de usuários:

  • group.name: o nome de um grupo do qual um usuário faz parte

  • permission_set.permissions: a lista de permissões concedidas a um usuário

  • role.name: a função atribuída a um usuário

  • user.dev_mode: se o usuário está no modo de desenvolvimento.

  • user.is_disabled: se um usuário foi desativado na instância do Looker.

  • user.edit_link: um link para a página no Looker, em que você pode editar as informações do usuário.

  • role.edit_link: um link para a página no Looker, em que você pode editar as informações do papel atribuído ao usuário.

  • group.edit_link: um link para a página no Looker, em que você pode editar o conjunto de grupos que um usuário tem.

Examples

Veja abaixo alguns usos comuns da ferramenta Explorar usuários. É necessário substituir <instance_name.looker.com> no início do URL pelo endereço da instância do Looker para que esses links funcionem.

Quais usuários tiveram o acesso desativado?

Essa guia lista todos os usuários que tiveram o acesso desativado:

https://<instance_name.looker.com>/explore/i__looker/user?fields=user.name&f[user.is_disabled]=Yes&sorts=user.name&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22user.is_disabled%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22Yes%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%7D%5D%7D&origin=share-expanded

Quais usuários têm uma permissão específica?

Essa guia lista todos os usuários na instância que têm a permissão develop:

https://<instance_name.looker.com>/explore/i__looker/user?fields=user.name&f[permission_set.permissions]=%25develop%25&sorts=user.name&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22permission_set.permissions%22%3A%5B%7B%22type%22%3A%22contains%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22develop%22%7D%2C%7B%7D%5D%2C%22id%22%3A0%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded

Quantos usuários existem em cada papel na minha instância?

Essa exploração conta o número de usuários ativos em cada função na instância. Um usuário pode ter mais de uma função atribuída. Por exemplo, se um usuário tiver recebido as funções "developer" e a função "admin", ele será contado duas vezes:

https://<instance_name.looker.com>/explore/i__looker/user?fields=role.name,user.count&f[user.is_disabled]=No&sorts=user.count+desc&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%7D&filter_config=%7B%22user.is_disabled%22%3A%5B%7B%22type%22%3A%22is%22%2C%22values%22%3A%5B%7B%22constant%22%3A%22No%22%7D%2C%7B%7D%5D%2C%22id%22%3A2%2C%22error%22%3Afalse%7D%5D%7D&origin=share-expanded