Como criar alertas

Se você tiver as permissões de usuário adequadas, poderá criar alertas em blocos baseados em consultas ou vinculados a Looks em painéis definidos pelo usuário ou painéis do LookML.

Como criar um alerta

Para criar um alerta em um bloco do painel, clique no ícone add_alert Alertas do bloco e, em seguida, clique no botão Novo na parte de baixo da lista de alertas que você tem permissão para ver. Talvez seja necessário rolar para ver a lista inteira. Se nenhum alerta estiver configurado para esse bloco ou se você não tiver permissão para ver os alertas atuais, mantenha o ponteiro sobre o bloco do painel para revelar o ícone Alertas add_alert. Clique no ícone add_alert Alertas no bloco do painel para abrir a caixa de diálogo de criação de alertas.

  1. Adicionar o Look como um bloco a um dashboard.
  2. Acesse o painel e localize o bloco específico.
  3. Clique no ícone add_alert Alertas no bloco para configurar e criar as condições de alerta.

Na janela de criação de alertas, é possível especificar vários componentes do alerta:

Cada consulta de alerta captura as configurações do painel e do bloco no momento em que o alerta foi criado. No entanto, um alerta é sincronizado com muitos dos tipos comuns de mudanças que você ou outros usuários fazem no painel ou bloco, sem a necessidade de recriar o alerta. Para mais informações, consulte a página de documentação Efeito das edições do painel nos alertas.

Como nomear um alerta

O título padrão indica quais condições precisam ser verdadeiras para que o alerta seja acionado. Se você quiser renomear o alerta, siga estas etapas:

  1. Clique no menu de três pontos e em Editar alerta.
  2. Clique uma vez no título do alerta.
  3. Insira um título personalizado e clique fora do campo ou pressione a tecla Enter para ver a atualização.
  4. Clique em Salvar alerta para salvar o novo título.

O título do alerta personalizado vai aparecer em todos os alertas visíveis ao público listados na janela de visualização de alertas desse bloco. O título personalizado também vai aparecer nas notificações de alerta.

Passe o cursor sobre o título personalizado de qualquer alerta na janela de visualização para ver as condições que o acionam.

Como definir condições de alerta

Nos menus suspensos Condição na janela de criação de alertas, é possível definir os componentes que informam ao Looker como verificar se há mudanças nos dados do bloco e os tipos de mudanças que acionam uma notificação de alerta.

A condição de alerta é representada por estes componentes:

  • A lista de campos ou cálculos de tabela que aparecem na visualização do bloco do painel.
  • A mudança que o campo, os campos, o cálculo de tabela ou os cálculos de tabela selecionados precisam sofrer para acionar a notificação de alerta
  • A magnitude da mudança que acionaria a notificação de alerta

As condições incluem:

  • É maior que
  • É menor que
  • É igual a
  • É maior ou igual a
  • É menor ou igual a

Se a consulta tiver um campo de data ou hora, estas condições adicionais estarão disponíveis:

  • Increases by (Aumenta em)
  • Decreases by (Diminui em)
  • Mudanças por (uma combinação de Aumentos por e Diminuições por)

É possível criar alertas com base em comparações de números inteiros e valores de dados decimais. Para definir alertas com base em mudanças percentuais nos valores de dados, consulte a página de práticas recomendadas Como definir condições de alerta com base em mudanças percentuais nos valores de dados.

Como definir notificações de alerta

Na seção Para onde enviar da janela de criação de alertas, especifique o destino da notificação de alerta.

Como enviar alertas para o e-mail

Para enviar as notificações de alerta por e-mail, selecione E-mail no menu suspenso Destino de envio. É possível definir quem vai receber a notificação de alerta por e-mail. Seu e-mail será listado por padrão, e você poderá modificar a lista de destinatários conforme necessário. Suas permissões determinam para quais domínios de e-mail você pode enviar notificações de alerta. Não há limite para o número de destinatários que você pode notificar, mas, se a organização estiver usando um servidor SMTP externo, ele poderá ter os próprios limites diários ou por mensagem.

Cada destinatário vai receber um e-mail com informações sobre o alerta e uma opção para deixar de segui-lo. Se eles optarem por deixar de seguir o alerta, o endereço de e-mail deles será removido da lista de destinatários. Cada destinatário também vai receber uma notificação push no dispositivo móvel se:

Para painéis incorporados, é possível personalizar o URL que você fornece para os destinatários acessarem o Looker. Para usar essa opção, um administrador do Looker ou um usuário com a permissão schedule_look_emails ou create_alerts precisa especificar os domínios permitidos para o link personalizado e selecionar o formato do URL do link personalizado na página Incorporar no menu Administrador.

  • No campo Domínio, selecione uma das opções disponíveis.
  • No campo Caminho, insira um caminho para o painel, como /dashboards/12 ou /reports/salesoverview. A opção Caminho só vai aparecer se a opção URL definido pelo usuário estiver selecionada no campo Selecionar caminho do conteúdo na página Incorporar do menu Administrador.
  • No campo Rótulo do URL, digite um novo texto para o link que aponta para o conteúdo (opcional). Esse campo mostra qualquer texto inserido no campo Rótulo do URL na página Incorporar do menu Administrador por padrão e pode ser alterado nesse campo.

Como enviar alertas para a integração do anexo do Slack (token de API)

A ação de anexo do Slack (token de API) está disponível na central de ações do Looker. Quando essa ação estiver ativada na página Ações no painel de admin Administrador, o Anexo do Slack (token de API) vai aparecer como uma opção no menu suspenso Para onde enviar da janela de criação de alertas.

Depois que um administrador do Looker ativar a ação do anexo do Slack (token de API) e o usuário do bot do app Looker tiver sido configurado no Slack, siga estas etapas para enviar notificações de alerta ao Slack usando a integração do anexo do Slack (token de API):

  1. Selecione Anexo do Slack (token da API) no menu suspenso Destino de envio.

    Os campos Tipo de canal e Compartilhar em vão aparecer.

  2. Use o campo Tipo de canal para especificar o tipo de destinatário do Slack para o alerta:

    • Canais: envie o alerta para um canal do Slack.
    • Usuários: envie o alerta em uma mensagem direta para um usuário do Slack.

    Depois de selecionar o tipo de canal, o campo Compartilhar em é preenchido com as opções de canal ou mensagem direta aplicáveis às credenciais do usuário do bot do app Looker no espaço de trabalho do Slack.

  3. No campo Compartilhar em, selecione a mensagem direta ou o canal para onde você quer enviar a notificação de alerta. O usuário ou canal selecionado vai receber uma notificação com informações sobre o bloco em que o alerta está definido:

    • Uma imagem PNG da visualização do bloco do painel
    • Uma mensagem com o nome do painel ou o título do alerta personalizado e as condições que acionaram o alerta
    • Um link para acessar o painel do bloco
    • Um link para cancelar a inscrição na notificação de alerta

Como enviar alertas para a integração com o Slack

A ação do Slack está disponível na central de ações do Looker. Quando essa ação estiver ativada na página Ações no painel de admin Administrador, o Slack vai aparecer como uma opção no menu suspenso Para onde enviar da janela de criação de alertas. Um administrador do Looker também precisa conectar pelo menos um espaço de trabalho do Slack à instância do Looker.

A integração com o Slack está disponível para implantações hospedadas pelo Looker que atendem a estas condições:

  • A instância está no Looker 6.24 ou em uma versão mais recente.
  • O recurso Lista de permissões de IP não está ativado na instância do Looker.

Essa integração do Slack não é compatível com instâncias hospedadas pelo cliente.

Para ativar a instalação do app do Looker, o proprietário do espaço de trabalho do Slack pode precisar ajustar as configurações de instalação do app para o espaço de trabalho do Slack.

Depois que um administrador do Looker ativar a ação do Slack e conectar os espaços de trabalho adequados, siga estas etapas para enviar notificações de alerta para o Slack:

  1. Selecione Slack no menu suspenso Destino de envio.

    Se você ainda não tiver feito a autenticação no Slack, um botão Fazer login com o Slack vai aparecer no menu suspenso Para onde enviar.

  2. Clique em Fazer login com o Slack. O Looker vai solicitar acesso ao espaço de trabalho do Slack. Se o administrador do Looker tiver conectado vários espaços de trabalho do Slack à sua instância do Looker, um menu suspenso vai aparecer no canto superior direito da página do OAuth. Selecione o espaço de trabalho do Slack apropriado no menu suspenso. Clique em Permitir.

    Também é possível autenticar no Slack na página da sua conta pessoal no Looker. Se o administrador do Looker tiver conectado vários espaços de trabalho do Slack à sua instância do Looker, você verá uma lista de espaços de trabalho com opções para fazer login em cada um deles individualmente.

    Depois de fazer login em pelo menos um espaço de trabalho do Slack, os campos Tipo de canal e Compartilhar em vão aparecer.

    Mesmo que os usuários incorporados tenham permissões para enviar notificações de alerta para a integração do Slack, a menos que o espaço de trabalho do Slack esteja conectado à instância do Looker, eles não vão ver a opção Slack no menu suspenso Para onde enviar.

  3. O menu suspenso Espaço de trabalho mostra uma lista de todos os espaços de trabalho em que você fez login. Selecione um espaço de trabalho na lista. Se você não encontrar o espaço de trabalho para onde quer enviar a notificação de alerta, consulte uma lista dos espaços de trabalho que o administrador do Looker conectou à sua instância do Looker e faça login em cada um deles individualmente na página da sua conta pessoal no Looker.

  4. O campo Compartilhar em é preenchido com as opções de canal e mensagem direta com base no espaço de trabalho do Slack selecionado. Selecione a mensagem direta ou o canal para onde você quer enviar a notificação de alerta. Todos nesse canal vão receber uma notificação com informações sobre o bloco em que o alerta está definido:

    • Uma imagem PNG da visualização do bloco do painel
    • Uma mensagem com o nome do painel ou o título do alerta personalizado e as condições que acionaram o alerta
    • Um link para acessar o painel do bloco
    • Um link para cancelar a inscrição na notificação de alerta

Definir a frequência dos alertas

Na seção Frequência da janela de criação de alertas, você pode definir a frequência com que o Looker verifica se há mudanças nos seus dados e envia uma notificação de alerta se as condições de alerta forem atendidas. A frequência padrão é Diária às 05:00. As opções de frequência disponíveis são as seguintes:

  • Mensalmente em um Dia especificado do mês (o padrão é o 1º dia do mês) em um Horário especificado (o padrão é 05:00)
  • Semanalmente em um dia específico da semana (o padrão é Sun para domingo) em um horário específico (o padrão é 05:00)
  • Diariamente em um Horário especificado (o padrão é 05:00)
  • A cada hora em um intervalo especificado (o padrão é verificar os dados a cada hora) com horários de Início e Término especificados (o padrão é 05:00 e 17:00). Com intervalos por hora, o Looker pode verificar os dados nestes intervalos:
    • Hora
    • 2 horas
    • 3 horas
    • 4 horas
    • 6 horas
    • 8 horas
    • 12 horas
  • Minutos em um intervalo especificado (o padrão é verificar os dados a cada 15 minutos) com horários de Início e Término especificados (o padrão é 05:00 e 17:00). Com intervalos baseados em minutos, o Looker pode verificar os dados nestes intervalos:
    • 15 minutos
    • 30 minutos

Os horários de início e término são inclusivos. Por exemplo, se você definir Verificar a cada como 12 horas com um horário de Início às 05:00 e um horário de Término às 17:00, o Looker vai verificar os dados às 05:00 e às 17:00.

Como definir permissões de alertas

Por motivos de segurança, alguns alertas não podem ser visualizados ou seguidos por outros usuários, e você não pode ver nem definir as permissões deles.

Para definir as permissões do seu alerta, selecione as opções Público ou Privado no menu suspenso Permissões na janela de criação. Se um alerta puder ser seguido, ele será marcado como Público por padrão. Isso significa que qualquer usuário do Looker com permissões para seguir no conteúdo subjacente do bloco do painel poderá ver o alerta e as configurações dele na janela de visualização de alertas. Eles também podem seguir seu alerta para receber notificações por e-mail quando as condições dele forem acionadas.

Para definir seu alerta como Particular e garantir que as configurações dele sejam visíveis apenas para você (e os administradores), escolha a opção Particular no menu suspenso Permissões na janela de criação.

Não é possível seguir os alertas para as integrações do Slack e do Slack Attachment (API Token). No entanto, se você estiver criando um alerta para um desses destinos e marcá-lo como Público, outros usuários poderão ver e duplicar suas configurações de alerta.

Incluindo análise dos principais fatores

Ao configurar o alerta, você também pode especificar se quer que a notificação inclua resultados da análise dos principais fatores com tecnologia do Gemini. Essa análise fornece insights sobre a mudança nos dados que acionou o alerta e por que ela pode ter ocorrido. Para incluir esses insights, ative a configuração Análise dos principais fatores com tecnologia do Gemini ao criar ou editar o alerta. Esta opção fica desativada por padrão.