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 para a 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. Clique no í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. Ela é usada especificamente quando os links para sua instância são criados em e-mails programados e em todos os URLs absolutos gerados pelo Looker.

Verifique 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. Consulte O que vai acontecer se o URL da minha instância do Looker mudar? Práticas recomendadas para mais informações sobre como alterar URLs de instância.

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 seu servidor Looker ou outros motivos
  • Mude 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, 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, 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, o fuso horário do aplicativo será usado para esse usuário, e todos os dados com base em tempo consultados por ele serão convertidos no 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 programações não afeta os dados de horário retornados por uma consulta, mas afeta apenas a hora de envio de uma entrega de dados.

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

Sistema fechado

A configuração Sistema fechado é usada com grupos para impedir que os usuários de um grupo saibam sobre 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. Ela também só poderá ver os grupos de que for membro.

Todos os administradores e usuários que receberam a permissão see_users podem ver 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 privadas 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 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 acesso a outros usuários ou a grupos de usuários com 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 ela está ativada, 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. E-mails não são gerados quando um usuário incorporado assinado é criado. O e-mail terá 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 usando 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 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.

Eles são criados e implantados pela equipe de Experiência do Cliente do Looker e vão mudar 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 da Pendo, o Looker usa hashes de integridade SHA-256 para confirmar que o guia não foi alterado. Se houver alterações no guia após a revisão do Looker, ele 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. Esta 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 excluem o conteúdo que existe apenas nas pastas pessoais de outros usuários. Os usuários têm a opção de excluir conteúdo em 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 ela está ativada, apenas os administradores do Looker podem ativar a opção Atualizar painel automaticamente em dashboards 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 selecionar ou criar um avatar para a conta no 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 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 em um fuso horário do usuário quando ele visualiza os resultados da consulta ou interpreta 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 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 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 vai atualizar todas as visualizações nos Looks e dashboards que usam a coleção de cores 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 sua 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 de + ou -.

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

Os códigos de coleção e de paleta das novas coleções de cores personalizadas 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 as duas instâncias 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 que aparece. 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 para rede de fornecimento de conteúdo. Um 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. Somente itens específicos do Looker (como imagens) são armazenados na 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 Looker para dispositivos móveis. Quando ele está desativado, 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 aplicativo no dispositivo móvel. Os usuários também podem ativar o login biométrico quando a opção Forçar autenticação 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) que estão em conformidade com as recomendações rígidas de 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. Desative essa configuração para permitir que scripts de terceiros sejam executados no Looker.

Essa opção foi adicionada para que os desenvolvedores tenham tempo de ajustar os scripts de acordo com as recomendações rigorosas da CSP e 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 o envio de conteúdo e as notificações de alerta a 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 de usuário aceita o mesmo formato de string da configuração de 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, por meio da 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 e 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 para os quais um grupo pode enviar e-mails é a união do conjunto de domínios de e-mail listados na 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 de permissões

Os usuários com e sem incorporação precisam ter pelo menos a permissão schedule_look_emails para enviar qualquer conteúdo do Looker por e-mail. Para enviar notificações de alerta, um 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ínio 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 schedule_look_emails 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
create_alerts
schedule_look_emails Pode enviar conteúdo por e-mail e notificações de alerta para qualquer endereço de e-mail Pode enviar conteúdo por e-mail e notificações de alerta para qualquer endereço de e-mail
schedule_external_look_emails
create_alerts
Incorporação assinada schedule_look_emails Pode enviar conteúdo por e-mail 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
create_alerts
schedule_look_emails Pode enviar conteúdo por e-mail e notificações de alerta para qualquer endereço de e-mail Pode enviar conteúdo por e-mail e notificações de alerta para qualquer endereço de e-mail
schedule_external_look_emails
create_alerts

O conteúdo incorporado do Looker é acessado por uma conta de usuário incorporada dedicada, e 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

Com essa configuração, você pode definir os URLs (como https://looker.com) em que seus usuários podem processar ações de dados.

Por exemplo, se você adicionar o URL https://looker.com à lista de permissões para ações de dados, essas ações 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 ' antes de todos os valores que possam ser interpretados como fórmulas ou macros em consultas transferidas 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 escolhem fazer o download de dados. Os usuários poderão escolher outro formato de arquivo, se quiserem.

Format|File Extension|Description --|--|-- 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 um HTML básico para mostrar os dados de maneira semelhante à visualização no navegador. No entanto, a formatação não é 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

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

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