Configurações de administrador: configurações gerais

Na página Configurações da seção Geral do menu Administrador, é possível definir as configurações do Looker para toda a instância.

Chave de licença

A chave de licença é exclusiva da instância do Looker que você está usando. Ele ativa ou desativa determinados recursos do Looker com base no seu contrato de licenciamento.

A chave de licença fica oculta por padrão. Selecione o ícone de olho para mostrar a chave de licença.

URL do host

O URL do host é a parte base do URL da sua instância do Looker. Ele é usado especificamente quando os links para sua instância são criados em e-mails programados e em todos os URLs absolutos que o Looker gera.

Verifique se a configuração URL do host usa http:// ou https:// corretamente, com base na configuração do servidor da instância.

A alteração do URL do host pode afetar a funcionalidade de alguns recursos do Looker. Consulte O que acontece se o URL mudar para minha instância do Looker? Página de práticas recomendadas para mais informações sobre como mudar os URLs das instâncias.

Contatos técnicos

Os endereços de e-mail adicionados a essa caixa vão receber notificações de atualizações de segurança, correções de bugs importantes e novas versões do Looker. O endereço de e-mail precisa pertencer a um usuário válido do Looker. Se você adicionar um e-mail que não pertence a um usuário válido do Looker (por exemplo, um endereço de uma lista de distribuição), ele vai aparecer no campo Contato técnico, mas o Looker não vai enviar notificações para ele.

O suporte do Looker exige a permissão de um contato técnico para realizar as seguintes ações:

  • Causar inatividade na instância, o que pode ser devido a uma atualização de versão não programada, mudanças de desempenho no servidor do Looker ou outros motivos
  • Mudar algo na sua licença do Looker, possivelmente para ativar novos recursos

fuso horário do aplicativo

Ao mostrar dados em uma Análise, um Look ou um dashboard, o Looker pode converter dados de tempo do fuso horário do banco de dados da conexão no fuso horário apropriado do usuário.

Se a opção Fusos horários específicos do usuário estiver ativada, o administrador poderá definir o fuso horário padrão do usuário ou os usuários poderão definir o próprio fuso horário padrão. Se o administrador ou o usuário não tiver definido o fuso horário padrão do usuário, o Fuso horário do aplicativo será usado para esse usuário, e todos os dados baseados em tempo consultados por esse usuário serão convertidos para o Fuso horário do aplicativo.

A configuração Fuso horário do aplicativo também é usada como o fuso horário padrão para envios de conteúdo. O fuso horário usado para as programações não afeta os dados de tempo retornados por uma consulta. Ele afeta apenas o horário em que uma entrega de dados é enviada.

Consulte a página de documentação Como usar as configurações de fuso horário para mais informações.

Sistema fechado

A configuração Sistema fechado é usada com grupos para impedir que os usuários de um grupo conheçam os usuários de outro. Isso geralmente é útil para instalações multilocatárias.

Os locais no Looker em que os usuários podem ver outros usuários incluem:

Quando a configuração Sistema fechado está ativada, os usuários não administradores que não têm a permissão see_users só podem ver outros usuários com quem compartilham um grupo. Eles também só vão poder acessar os grupos dos quais fazem parte.

Todos os administradores e usuários que receberam a permissão see_users podem conferir todos os usuários e grupos na instância.

Quando ativada, a configuração de consentimento de login mostra uma tela de consentimento para todos os usuários que tentarem fazer login na instância do Looker. A tela de consentimento vai exibir a mensagem que foi digitada no campo Configuração da mensagem, e vai exigir que os usuários cliquem no botão Concordo na tela de consentimento antes de fazer login na instância. Depois que você ativar a Configuração de consentimento de login, o campo Configuração de mensagem ficará visível.

Configuração da mensagem

Se a opção Configuração de consentimento de login estiver ativada, no campo Configuração de mensagem, digite a mensagem que será mostrada a todos os usuários que tentarem fazer login na instância do Looker. Esse campo só fica visível depois que a configuração de consentimento de login é ativada.

Pastas pessoais particulares padrão

Quando a opção Pastas pessoais particulares padrão está ativada, a pasta pessoal de um usuário fica visível apenas para ele e para os administradores do Looker. Por padrão, outros usuários não veem a pasta na pasta "Pessoas", e o conteúdo dela não fica visível em boards ou nas pesquisas de conteúdo.

Se você quiser conceder acesso a uma pasta pessoal, adicione o acesso a outros usuários ou grupos de usuários usando a opção Gerenciar acesso no menu de engrenagem da pasta pessoal.

Se você desativar a opção Pastas pessoais privadas padrão, a pasta pessoal de um usuário poderá ser visualizada por qualquer usuário do Looker no grupo Todos os usuários.

Notificação de nova conta

A configuração Notificação de nova conta pode ser ativada ou desativada. Quando esse recurso está ativado, qualquer usuário administrador do Looker recebe um e-mail quando uma nova conta do Looker é criada. Os usuários de incorporação assinada são uma exceção. Não são gerados e-mails quando um usuário de incorporação assinada é criado. O e-mail vai conter o endereço de e-mail do novo usuário.

Guias no app

Os guias no app permitem que o Looker se comunique com os usuários no aplicativo por meio de tutoriais, banners, alertas e pesquisas. Essas comunicações são usadas para ajudar os usuários a aproveitar melhor a plataforma, alertar sobre novos recursos, receber feedback dos usuários na plataforma e convidá-los para treinamentos e eventos em que eles podem aprender a usar melhor o Looker.

Os administradores podem optar por desativar os guias em suas instâncias, o que desativará os guias para todos os usuários naquela instância. Não é possível desativar seletivamente os guias no app para determinados usuários. O Looker não mostra guias no app para usuários incorporados ou usuários que não são administradores em instâncias de rótulo particular.

Os guias são criados e implantados pela equipe de experiência do cliente do Looker e mudam com o tempo. O Looker usa JavaScript de software de terceiros (Pendo) para disponibilizar os guias. O Looker analisa os guias individuais e os adiciona à lista de permissões. Ao buscar um guia do Pendo, o Looker usa hashes de integridade SHA-256 para validar se o guia não foi alterado. Se houver mudanças no guia após a análise do Looker, ele vai impedir o uso do guia alterado. Se o navegador do usuário não conseguir acessar o servidor do Pendo, o guia simplesmente não será exibido.

Quando ativada, essa configuração mostra um banner de notificação de cookie para todos os usuários na sua instância. Essa configuração fica desativada por padrão.

Recomendamos ativar essa configuração se você precisar cumprir os regulamentos de proteção de dados da União Europeia.

Quando a Pesquisa selecionada está ativada, os usuários podem pesquisar conteúdo em pastas compartilhadas, pastas pessoais e boards. O conteúdo salvo nas pastas pessoais de outros usuários só será incluído nos resultados se também estiver fixado em um quadro. Os resultados da pesquisa vão excluir conteúdo que existe apenas nas pastas pessoais de outros usuários. Os usuários podem excluir conteúdo de pastas pessoais selecionando a chave ao lado do nome do recurso Pesquisa selecionada no modo de pesquisa.

Limitar a opção "Atualizar painel automaticamente"

Quando ativada, apenas os administradores do Looker podem ativar a opção Atualizar painel automaticamente em painéis definidos pelo usuário. Isso impede que usuários que não são administradores atualizem automaticamente os dados nos painéis e blocos do dashboard. A atualização automática de dados do painel pode sobrecarregar alguns sistemas de banco de dados.

Número do projeto do Google Cloud

O número do projeto do Google Cloud é necessário para ativar o suporte no app. Esse valor pode ser encontrado na página de visão geral do Cloud no console do Google Cloud.

Essa alteração pode levar até duas horas para entrar em vigor. Para implementar a mudança imediatamente, clique no botão Atualizar ao lado da configuração Chave de licença depois de inserir o número do projeto do Google Cloud.

Se você ainda não tiver um projeto do Google Cloud para o Looker, crie um seguindo nosso guia de criação de projeto do Google Cloud ou nossa documentação mais detalhada sobre Como criar e gerenciar projetos.

Usar o Gravatar

Quando ativada, essa configuração mostra a opção Foto do perfil no menu do usuário, permitindo que os usuários selecionem ou criem um avatar para a conta usando o app Gravatar.

fusos horários específicos dos usuários

Ao adicionar uma conexão, especifique o fuso horário em que seu banco de dados armazena as informações de horário como o fuso horário do banco de dados.

Quando a opção Fusos horários específicos do usuário está ativada, cada usuário recebe um fuso horário e o Looker converte os dados baseados em tempo do Fuso horário do banco de dados para o fuso horário do usuário quando ele consulta os resultados da consulta ou interpreta os filtros.

Quando a opção Fusos horários específicos do usuário está desativada, o Looker converte os dados baseados em tempo de todos os usuários para o valor do Fuso horário da consulta.

Consulte a página de documentação Como usar as configurações de fuso horário para mais informações.

Cores de visualização padrão

A configuração Cores de visualização padrão permite definir uma coleção de cores padrão para as visualizações e criar novas coleções de cores para usar nas instâncias.

Como definir uma coleção de cores padrão

Cada instância do Looker precisa ter uma coleção de cores padrão.

Para definir uma coleção de cores pré-existente como padrão, escolha a coleção de cores no menu suspenso e clique em Atualizar. Observação: definir uma nova coleção de cores padrão atualiza todas as visualizações nos painéis e visualizações que usam a coleção padrão. As visualizações salvas com uma coleção de cores diferente ou com uma paleta personalizada não são afetadas.

Você pode conferir as primeiras paletas categóricas, sequenciais e divergentes de cada coleção diretamente no menu suspenso. Estas são as paletas que serão usadas como padrão de visualização. Para conferir todas as paletas da coleção de cores, visite a página de documentação Coleções de cores.

Como criar uma coleção de cores personalizada

Para criar uma coleção de cores personalizada, siga estas etapas:

  1. Selecione a última opção Nova coleção de cores no menu suspenso Cores de visualização padrão.
  2. Dê um nome exclusivo à nova coleção na caixa de texto Nome.
  3. Clique em cada paleta de cores para abrir o menu Cores na paleta.
  4. Selecione cores individuais no menu Cores na paleta para editar uma de cada vez ou selecione Editar tudo para editar todas as cores de uma vez.
  5. Repita as etapas 3 e 4 para cada paleta de cores.
  6. Quando terminar de editar a nova coleção de cores, clique em Criar.

Os valores de cor podem ser formatados como strings hexadecimais, como #2ca6cd, ou como nomes de cores CSS, como mediumblue. Ou clique na roda de cores para abrir e selecionar uma tonalidade no seletor de cores. Se você optar por editar todas as cores, use uma vírgula entre os nomes de cada uma para separá-las. Para adicionar ou remover uma cor, clique nos sinais + ou -.

A nova coleção se tornará automaticamente o padrão da instância, mas você pode escolher outro padrão.

Os IDs de coleção e de paleta para qualquer nova coleção de cores personalizada são baseados no nome de cada coleção. Isso permite que os dashboards do LookML que usam essas coleções sejam renderizados de forma consistente nas instâncias se ambas tiverem as mesmas coleções personalizadas com nomes idênticos.

Como excluir uma coleção de cores personalizadas

Você pode excluir uma coleção de cores personalizadas selecionando a coleção no menu suspenso e clicando no botão Excluir exibido. Não é possível excluir as coleções de cores nativas do Looker.

Carregar recursos da CDN

Essa opção está disponível apenas para instâncias hospedadas pelo cliente. Como as instâncias hospedadas pelo Looker sempre carregam recursos da CDN, não é possível desativar essa configuração para elas.

CDN é a sigla em inglês para rede de fornecimento de conteúdo. Uma CDN é uma rede de servidores que armazena conteúdo em vários locais geográficos para reduzir o tempo de carregamento da página para os usuários. Seus dados nunca são armazenados nesses servidores. Somente itens específicos do Looker (como imagens) são armazenados no CDN.

A configuração Carregar recursos da CDN pode ser ativada ou desativada. Quando ele está ativado, as páginas do Looker carregam mais rápido.

Manter recursos no cache do navegador

Quando essa configuração está ativada, recursos estáticos, como arquivos JavaScript e fontes, são armazenados em cache no armazenamento do navegador de cada usuário. Isso acelera as navegações subsequentes, porque o navegador não precisa continuar recarregando esses recursos do servidor do Looker.

Acesso no aplicativo para dispositivos móveis

Quando essa configuração está ativada, os usuários podem fazer login na conta do Looker na instância usando o app para dispositivos móveis. Quando ela está desativada, todas as sessões móveis são encerradas.

Forçar autenticação por dispositivo móvel

Quando essa configuração está ativada, os usuários precisam fazer login no app Looker para dispositivos móveis sempre que abrirem o app no dispositivo móvel. Os usuários também podem ativar o login biométrico quando a opção Forçar autenticação para dispositivos móveis está ativada.

Aplicação da Política de Segurança de Conteúdo

Quando essa configuração está ativada, os cabeçalhos da Política de Segurança de Conteúdo (CSP) que estão em conformidade com as recomendações rígidas da CSP do Google são enviados e aplicados. Os cabeçalhos da CSP impedem que scripts de terceiros sejam executados no Looker e podem corromper algumas extensões do navegador. Para permitir que scripts de terceiros sejam executados no Looker, desative essa configuração.

Essa opção foi adicionada para que os desenvolvedores tivessem tempo de ajustar os scripts para se adequar às recomendações rígidas do CSP. Ela será removida em uma versão futura do Looker.

URLs públicos

A configuração URL público pode ser ativada ou desativada. Quando essa configuração está ativada, os usuários do Looker com as permissões adequadas podem gerar URLs públicos para acessar dados do Looker.

Lista de permissões de domínios de e-mail para conteúdo programado

Com essa configuração, os administradores do Looker podem definir os domínios de e-mail em que os usuários podem enviar conteúdo do Looker, como Looks, dashboards, consultas com visualizações ou notificações de alerta por e-mail.

Para limitar envios de conteúdo e notificações de alerta para endereços de e-mail com um domínio específico, insira o domínio no formato domain.suffix. Por exemplo, para limitar a entrega de e-mails apenas aos e-mails com os domínios gmail.com e friendly_domain.org, especifique esses domínios no campo Lista de permissões de domínios de e-mail para conteúdo programado e conceda a permissão schedule_look_emails aos usuários.

Saiba mais sobre como essa configuração e as permissões do usuário afetam a exibição de conteúdo do Looker e notificações de alerta na seção Visão geral das permissões desta página.

looker_internal_email_domain_allowlist atributo do usuário

Além dos domínios de e-mail incluídos no campo Lista de permissões de domínios de e-mail para conteúdo programado, também é possível especificar domínios de e-mail em um nível por grupo usando o atributo de usuário looker_internal_email_domain_allowlist. O atributo do usuário aceita o mesmo formato de string da configuração de administrador Lista de permissões de domínio de e-mail para conteúdo programado.

Se um grupo receber vários conjuntos de domínios de e-mail, por exemplo, por meio de associação a vários grupos, os membros desse grupo poderão enviar e-mails para todos os domínios atribuídos a cada um dos valores do atributo do usuário, bem como para os domínios listados na configuração de administrador Lista de permissões de domínios de e-mail para conteúdo programado. Em outras palavras, o conjunto de domínios de e-mail para os quais um grupo pode enviar e-mails é a união do conjunto de domínios de e-mail listados no campo Lista de permissões de domínios de e-mail para conteúdo programado e cada conjunto de domínios de e-mail atribuído ao grupo pelo atributo de usuário looker_internal_email_domain_allowlist.

Visão geral das permissões

Os usuários que incorporam e que não incorporam precisam ter pelo menos a permissão schedule_look_emails para enviar e-mails com qualquer conteúdo do Looker. Para enviar notificações de alerta, o usuário também precisa ter permissões create_alerts.

Usuários incorporados e não incorporados que têm a permissão schedule_look_emails também podem receber a permissão schedule_external_look_emails. Saiba mais sobre permissões e dependências na página de documentação Papéis.

Para ter uma visão geral de como as permissões do usuário afetam os domínios que podem receber conteúdo do Looker ou notificações de alerta, consulte a tabela a seguir:

Tipo de usuário Permissões A lista de permissões de domínios de e-mail para conteúdo programado contém o domínio friendly_domain.org A lista de permissões de domínios de e-mail para conteúdo programado não contém domínios
Não incorporado Apenas o schedule_look_emails Pode enviar e-mails para o próprio endereço de e-mail, para o endereço de e-mail de outro usuário do Looker na mesma instância ou para um endereço de e-mail com o domínio friendly_domain.org Pode enviar conteúdo por e-mail para qualquer endereço de e-mail
schedule_look_emails e create_alerts Pode enviar conteúdo por e-mail e notificações de alerta para o próprio endereço de e-mail, para o endereço de e-mail de outro usuário do Looker na mesma instância ou para um endereço de e-mail com o domínio friendly_domain.org Pode enviar conteúdo por e-mail e notificações de alerta para qualquer endereço de e-mail
Apenas o schedule_external_look_emails Pode enviar conteúdo por e-mail para qualquer endereço de e-mail Pode enviar conteúdo por e-mail para qualquer endereço de e-mail
schedule_external_look_emails e create_alerts Pode enviar conteúdo por e-mail e notificações de alerta para qualquer endereço de e-mail Pode enviar e-mails de envio de conteúdo e notificações de alerta para qualquer endereço de e-mail
Incorporação assinada Apenas o schedule_look_emails Pode enviar conteúdo por e-mail para um endereço de e-mail com o domínio friendly_domain.org Não é possível enviar conteúdo do Looker por e-mail
schedule_look_emails e create_alerts Pode enviar e-mails de envio de conteúdo e notificações de alerta para um endereço de e-mail com o domínio friendly_domain.org Não é possível enviar por e-mail notificações de alerta ou conteúdo do Looker
schedule_external_look_emails Pode enviar conteúdo por e-mail para qualquer endereço de e-mail Pode enviar conteúdo por e-mail para qualquer endereço de e-mail
schedule_external_look_emails e create_alerts Pode enviar conteúdo por e-mail e notificações de alerta para qualquer endereço de e-mail Pode enviar e-mails de envio de conteúdo e notificações de alerta para qualquer endereço de e-mail

O conteúdo incorporado do Looker é acessado por uma conta de usuário dedicada, não por contas de usuário individuais. Quando uma pessoa acessa o conteúdo do Looker usando uma incorporação, não se espera que o Looker saiba o endereço de e-mail do usuário.

Uma exceção às regras estipuladas na tabela é a seguinte: você pode fornecer ao Looker um endereço de e-mail de um usuário incorporado definindo-o no atributo de usuário email no URL de incorporação assinado. Exemplo:

...&user_attributes={"email":"joe@domain.com"}

Se você definir o atributo de usuário email no URL de incorporação, o Looker vai permitir que um usuário incorporado com apenas a permissão schedule_look_emails envie o conteúdo do Looker para o próprio endereço de e-mail, mesmo que o domínio não esteja no campo Lista de permissões de domínios de e-mail para conteúdo programado ou se o campo Lista de permissões de domínios de e-mails para conteúdo programado estiver em branco.

Lista de permissões de URL para ações de dados

Essa configuração permite definir URLs (como https://looker.com) em que os usuários podem processar ações de dados.

Por exemplo, se você adicionar o URL https://looker.com à lista de permissões de URL para ações de dados, elas só poderão ser processadas em https://looker.com. As tentativas de processar ações de dados em outros URLs não serão permitidas.

Se esse campo for deixado em branco, não haverá restrições de URL para ações de dados. No entanto, se você incluiu um atributo de usuário em uma ação de dados, esse campo é obrigatório. Nesse caso, você precisa fornecer URLs válidos para processar ações de dados.

Bloquear imagens incorporadas inline nos resultados da consulta

Por padrão, o Looker não exibe imagens codificadas em Base64 nos resultados da consulta. Desative essa configuração para exibir imagens codificadas em Base64 nos resultados da consulta.

Bloquear fórmulas e macros em arquivos CSV e Excel

Quando essa configuração está ativada, o Looker adiciona um caractere ' a todos os valores que podem ser interpretados como fórmulas ou macros em consultas que são baixadas nos formatos de planilha CSV ou Excel.

Token de webhook de saída

Se um usuário usar um webhook para enviar conteúdo, como um painel ou um Look, a solicitação vai incluir um token especial do Looker que pode ser definido aqui. Os servidores que recebem webhooks podem verificar se as solicitações contêm esse valor para confirmar a legitimidade das solicitações de webhook.

Formato de exportação padrão

A configuração Formato de exportação padrão permite escolher o formato de arquivo padrão usado quando os usuários optam por fazer o download de dados. Os usuários poderão escolher outro formato de arquivo, se quiserem.

Formato|Extensão do arquivo|Descrição --|--|-- TXT|.txt|Gera um arquivo de texto delimitado por tabulações. Planilha do Excel|.xlsx|Gera um arquivo de planilha usando o formato para Microsoft Excel 2007 e posterior. CSV|.csv|Gera um arquivo de texto delimitado por vírgulas. JSON|.json|Gera um arquivo JSON com um registro por linha. HTML|.html|Gera o HTML básico para exibir os dados de maneira semelhante à forma como o usuário os vê no navegador. No entanto, a formatação não é exatamente a mesma porque o CSS do Looker não será incluído. Markdown|.md|Gera um arquivo Markdown padrão com uma tabela delimitada por |.

Integração

Quando ativado, os administradores e desenvolvedores que fizerem login em uma nova instância do Looker vão encontrar o tutorial de integração do Looker, que orienta os usuários nas quatro principais etapas para usar uma instância:

  1. Adicionando uma conexão
  2. Como criar um projeto
  3. Se quiser, edite os arquivos do projeto
  4. Exploração de dados

Quando qualquer combinação de administradores ou desenvolvedores concluir o guia completo, ele vai deixar de ser exibido.

A configuração Guias no app precisa estar ativada para que a opção Integração seja disponibilizada.