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

Na página Configurações, na 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 para a instância do Looker que você está usando. Ela ativa ou desativa determinados recursos do Looker com base no seu contrato de licença.

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

URL do host

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

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

Mudar o URL do host pode afetar a funcionalidade de alguns recursos do Looker. Confira a seção O que vai acontecer se o URL mudar da minha instância do Looker? Práticas recomendadas para mais informações sobre como alterar URLs de instâncias.

Contatos técnicos

Os endereços de e-mail adicionados a esta 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, como o 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.

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

  • Causar inatividade para a 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 para você

Fuso horário do aplicativo

Ao mostrar dados em uma Análise, Look ou painel, o Looker pode converter os 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, um 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 usuário não tiver definido o fuso horário padrão do usuário, o fuso horário do aplicativo será usado para ele, e todos os dados com base no tempo consultados por ele serão convertidos para o fuso horário do aplicativo.

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

Para mais informações, consulte a página de documentação Como usar configurações de fuso horário.

Sistema fechado

Essa opção precisa ser ativada pelo Looker. Entre em contato com o suporte do Looker para começar.

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

Os locais no Looker onde os usuários podem encontrar outros usuários incluem:

Quando a configuração Sistema fechado está ativada, 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ó poderão ver os grupos de que fazem parte.

Todos os administradores e todos os usuários que tiverem recebido a permissão see_users poderão ver todos os usuários e grupos na instância.

Quando ativada, a configuração de consentimento de login exibe uma tela de consentimento para todos os usuários que tentam fazer login na instância do Looker. A tela de consentimento exibirá a mensagem que foi inserida no campo Configuração da mensagem e 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 da mensagem ficará visível.

Configuração da mensagem

Se a opção Login Consent Configuration estiver ativada, no campo Message Configuration, insira a mensagem que será exibida para 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 por padrão apenas para ele e para os administradores do Looker. Por padrão, outros usuários não verão a pasta na pasta Pessoas, e o conteúdo nela não ficará visível nos boards nem nas pesquisas de conteúdo.

Se você quiser conceder acesso a uma pasta pessoal, é possível dar acesso a outros usuários ou a grupos de usuários pela 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 de usuários Todos os usuários.

Notificação de nova conta

A configuração Notificação de nova conta pode ser ativada ou desativada. Quando ativado, todos os usuários administradores do Looker recebem um e-mail quando uma conta é criada. Os usuários da Incorporação assinada são uma exceção. Os e-mails não são gerados quando um usuário de incorporação assinado é criado. O e-mail 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 ao máximo a plataforma, alertar sobre novos recursos, receber feedback sobre a plataforma e convidá-los para treinamentos e eventos em que podem aprender a usar melhor o Looker.

Os administradores podem desativar os guias na instância, o que vai desativar os guias para todos os usuários nela. Não há como desativar os guias no app para determinados usuários. O Looker não mostrará 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 projetados 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 verifica os guias individuais e os adiciona à lista de permissões. Ao buscar um guia da Pendo, o Looker usa hashes de integridade SHA-256 para validar que o guia não foi alterado. Se houver alguma mudança no guia após a revisão do Looker, o Looker impedirá o uso do guia alterado. Se o navegador de um usuário não puder acessar o servidor Pendo, o guia simplesmente não será exibido.

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

O Looker recomenda que você ative essa configuração se precisar obedecer aos 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 o conteúdo que existe somente nas pastas pessoais de outros usuários. Os usuários têm a opção de excluir conteúdo de pastas pessoais selecionando a chave ao lado do nome do recurso Pesquisa selecionada no modal de pesquisa.

Limitar a opção "Atualizar painel automaticamente"

Quando ativado, apenas os administradores do Looker vão poder ativar a opção Atualizar painel automaticamente nos painéis definidos pelo usuário. Isso impede que usuários que não são administradores atualizem automaticamente os dados em painéis e blocos de painéis. A atualização automática dos 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 o guia Criar um projeto do Google Cloud ou nossa documentação mais detalhada sobre Como criar e gerenciar projetos.

Usar o Gravatar

Quando ativada, essa configuração exibe 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, você especifica o fuso horário 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 dados com base no horário do fuso horário do banco de dados para o fuso horário de um usuário ao visualizar os resultados da consulta ou interpretar filtros.

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

Para mais informações, consulte a página de documentação Como usar configurações de fuso horário.

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 visualizações e também permite criar novas coleções de cores para uso nas suas 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 preexistente como padrão, escolha a coleção de cores no menu suspenso e clique no botão Atualizar. Observação: definir uma nova coleção de cores padrão vai atualizar todas as visualizações em Looks e dashboards com a coleção de cores padrão. As visualizações salvas com uma coleção de cores diferente ou uma paleta personalizada não serão afetadas.

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

Como criar uma coleção de cores personalizadas

Para criar uma coleção de cores personalizadas:

  1. Selecione Criar uma coleção de cores no menu suspenso de coleção.
  2. Dê um nome exclusivo à sua nova coleção.
  3. Selecione cada paleta para editar.
  4. Selecione cores individuais para editar ou selecione Editar todas para editar todas as cores de uma vez.
  5. Quando terminar de editar sua nova coleção, selecione Atualizar.

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 cor 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 um padrão diferente, se quiser.

Os IDs de coleção e de paleta para as novas coleções de cores personalizadas são baseados no nome de cada coleção. Isso permite que os painéis do LookML que usam essas coleções renderizem consistentemente entre as instâncias se as duas instâncias tiverem as mesmas coleções personalizadas com nomes idênticos.

Como excluir uma coleção de cores personalizadas

Para excluir uma coleção de cores personalizadas, selecione-a no menu suspenso e clique 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, essa configuração não pode ser desativada para elas.

CDN significa rede de fornecimento de conteúdo. Uma CDN é uma rede de servidores que armazena conteúdo em diversas localizações geográficas para reduzir o tempo de carregamento da página para os usuários. Seus dados nunca são armazenados nesses servidores. Aqui, apenas itens específicos do Looker, como imagens, são armazenados.

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

Manter recursos no cache do navegador

Quando essa configuração está ativada, os 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 no 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 Looker para dispositivos móveis. Quando ela está desativada, todas as sessões em dispositivos móveis atuais 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. Os usuários também podem ativar o login biométrico quando a opção Forçar autenticação por dispositivo móvel 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) em conformidade com as recomendações rigorosas de CSP do Google são enviados e aplicados. Isso impede que scripts de terceiros sejam executados no Looker e pode 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 tenham tempo de ajustar os scripts e seguir as recomendações rigorosas da 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 apropriadas podem gerar URLs públicos para acessar os 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 as entregas de conteúdo e as notificações de alerta a endereços de e-mail com um domínio específico, use o formato domain.suffix. Por exemplo, para limitar as entregas de e-mails apenas a e-mails com domínios gmail.com e friendly_domain.org, você pode especificar esses domínios no campo Lista de permissões de domínios de e-mail para conteúdo programado e conceder aos usuários a permissão schedule_look_emails.

Saiba mais sobre como essa configuração e as permissões de um usuário afetam a capacidade de exibir conteúdo do Looker e notificações de alerta na seção Visão geral de 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 global, também é possível especificar domínios de e-mail por grupo usando o atributo de usuário looker_internal_email_domain_allowlist. O atributo do usuário aceita o mesmo formato de string que a configuração do administrador Lista de permissões de domínios de e-mail para conteúdo programado.

Se um grupo receber vários conjuntos de domínios de e-mail, por exemplo, pela 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 de 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 o qual um grupo pode enviar e-mails é a união do conjunto de domínios 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ídos ao grupo pelo atributo de usuário looker_internal_email_domain_allowlist.

Visão geral das permissões

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

Os usuários incorporados e sem incorporação 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 a que os usuários podem enviar envios de conteúdo ou notificações de alerta do Looker, 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ínio de e-mail para conteúdo programado não contém domínios
Não incorporado schedule_look_emails Pode enviar por e-mail entregas de conteúdo e notificações de alerta para o próprio endereço de e-mail, para o endereço 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 por e-mail entregas de conteúdo e alertas para qualquer endereço de e-mail
create_alerts
schedule_look_emails Pode enviar por e-mail entregas de conteúdo e alertas para qualquer endereço de e-mail Pode enviar por e-mail entregas de conteúdo e alertas para qualquer endereço de e-mail
schedule_external_look_emails
create_alerts
Incorporação assinada schedule_look_emails Pode enviar entregas de conteúdo e notificações de alerta por e-mail 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
create_alerts
schedule_look_emails Pode enviar por e-mail entregas de conteúdo e alertas para qualquer endereço de e-mail Pode enviar por e-mail entregas de conteúdo e alertas para qualquer endereço de e-mail
schedule_external_look_emails
create_alerts

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

Uma exceção às regras estipuladas na tabela é a seguinte: você pode fornecer ao Looker o endereço de e-mail de um usuário de incorporação 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 que tenha apenas a permissão schedule_look_emails envie o conteúdo do Looker para o próprio endereço de e-mail, mesmo que esse 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-mail 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 URLs para ações de dados, essas ações só poderão ser processadas em https://looker.com. Não serão permitidas tentativas de processar ações de dados em outros URLs.

Se esse campo for deixado em branco, não haverá restrições de URL para ações de dados. No entanto, se você tiver incluído um atributo do usuário em uma ação de dados, esse campo será obrigatório. Nesse caso, é necessário 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 esta configuração para exibir imagens codificadas em Base64 nos resultados de consultas.

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 transferidas por download 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 conferir a legitimidade delas.

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 fazem o download de dados. Os usuários ainda podem escolher outro formato de arquivo.

Format|File Extension|Descrição --|--|-- TXT|.txt|Gera um arquivo de texto delimitado por tabulações. Planilha do Excel|.xlsx|Gera um arquivo de planilha no formato 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 HTML básico para mostrar os dados de maneira semelhante à visualização que o usuário faz 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 do Looker que fizerem login em uma nova instância vão receber o tutorial de integração do Looker, que orienta os usuários nas quatro etapas principais para usar uma instância do Looker:

  1. Como adicionar uma conexão
  2. Como criar um projeto
  3. Editar arquivos de projetos, se quiser
  4. Explorar dados

Assim que qualquer combinação de administradores ou desenvolvedores conclui o guia completo, ele deixa de ser exibido.

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