Como criar alertas

Se você tiver as permissões de usuário apropriadas, poderá criar alertas em blocos baseados em consultas ou Look-linked em dashboards definidos pelo usuário ou nos painéis do LookML.

Como criar um alerta

Os alertas só podem ser definidos em blocos que têm pelo menos uma medida numérica ou um cálculo de tabela na visualização do bloco. O tipo de visualização e os campos presentes na visualização de bloco do dashboard determinam se é possível definir uma condição de alerta com base em um único valor de cálculo de campo ou tabela ou em "qualquer" ou valor de cálculo da tabela.

Dependendo do tipo de visualização do bloco do dashboard e dos tipos de campos presentes na visualização, o Looker verifica os dados de maneiras diferentes. Quando você cria um alerta, ele é de um destes tipos:

  • Alertas de valor único (usados apenas com visualizações de valor único): o Looker verifica os dados com base no valor usado na visualização, que é a primeira linha da tabela de resultados.
  • Alertas de série temporal (usados quando há uma dimensão de data ou hora nos resultados da consulta): o Looker verifica todas as novas linhas que não foram vistas antes (com base na dimensão de data ou hora da consulta).
  • Alertas categóricos (nem valor único nem série temporal): o Looker verifica todas as linhas e valores dinâmicos, a menos que uma linha ou um valor dinâmico específico tenha sido selecionado quando o alerta foi criado.

Não é possível enviar alertas baseados em um cálculo de tabela que inclui um total de linhas.

Para criar alertas, o painel precisa estar fora do modo de edição e você precisa estar fora do modo de desenvolvimento.

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

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

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 sincroniza com muitos dos tipos comuns de alterações que você ou outros usuários fazem no painel ou bloco subjacente, sem precisar recriar o alerta. Consulte a página de documentação Efeitos das edições do painel em alertas para mais informações.

Nomear um alerta

O título padrão do alerta indica quais condições precisam ser atendidas 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. Digite um título personalizado e clique fora do campo ou pressione a tecla Enter para ver sua atualização.
  4. Clique em Salvar alerta para salvar o novo título.

O título do seu alerta personalizado vai aparecer em todos os alertas visíveis publicamente, 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 acionam esse alerta.

Como definir condições de alerta

Nos menus suspensos Condição da janela de criação de alertas, é possível definir os componentes que informam ao Looker como verificar os dados do bloco em busca de alterações e os tipos de alterações que acionam uma notificação de alerta.

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

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

Essas condições incluem o seguinte:

  • É 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 outras condições estarão disponíveis:

  • Increases by (Aumenta em)
  • Decreases by (Diminui em)
  • Alterações em (uma combinação de aumenta em e diminui em)

Há algumas considerações adicionais no uso dessas condições de comparação com dados de série temporal. Para mais informações, consulte a página "Práticas recomendadas" em Como definir alertas com base em dados de série temporal.

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

Como definir notificações de alerta

Na seção Para onde enviar da janela de criação de alertas, é possível especificar o destino da notificação.

Enviar alertas por e-mail

Para enviar suas notificações de alerta por e-mail, selecione E-mail na lista suspensa Para onde enviar. Você pode designar os destinatários da notificação por e-mail de alerta. Seu e-mail será listado por padrão, e você pode 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.

Cada destinatário vai receber um e-mail com informações sobre o alerta e a opção de parar de seguir o alerta. Se ele parar de seguir o alerta, o endereço de e-mail dele será removido da lista de destinatários.

Nos painéis incorporados, você pode personalizar o URL fornecido para os destinatários vincularem ao Looker. Para usar essa opção, um administrador do Looker ou um usuário com a permissão schedule_look_emails ou create_alerts primeiro 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 um dos domínios disponíveis.
  • No campo Path, insira um caminho para o painel, como /dashboards/12 ou /reports/salesoverview. A opção Caminho será exibida somente se URL definido pelo usuário estiver selecionado no campo Selecionar caminho do conteúdo na página Incorporar do menu Administrador.
  • No campo Rótulo do URL, você pode digitar um novo texto para o link que leva ao conteúdo. Esse campo exibe qualquer texto digitado no campo Rótulo do URL na página Incorporar do menu Administrador por padrão e pode ser alterado.

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 no Looker Action Hub. Quando essa ação é ativada na página Ações no painel Administrador, Anexo do Slack (Token de API) aparece como uma opção na lista suspensa Para onde enviar da janela de criação de alertas.

Os administradores de instâncias hospedadas pelo cliente que usam um servidor do hub de ações auto-hospedado precisam reiniciar o servidor do hub de ações quando atualizam a instância do Looker.

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

  1. Selecione Slack Attachment (API Token) na lista suspensa Onde enviar.

    Os campos Tipo de canal e Compartilhar com serão exibidos.

    Mesmo que os usuários incorporados tenham permissão para enviar notificações de alerta para a integração do anexo do Slack, eles não verão o Anexo do Slack (Token de API) na lista suspensa Para onde enviar, a menos que o espaço de trabalho do Slack esteja configurado para o usuário do bot do app Looker.

  2. Use o campo Channel Type 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 com será 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 com, selecione a mensagem direta ou o canal para onde você quer enviar a notificação de alerta. O usuário ou canal selecionado receberá uma notificação com informações relacionadas ao bloco em que o alerta está definido:

    • Uma imagem em PNG da visualização de blocos do dashboard
    • 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 navegar até o painel do bloco.
    • Um link para cancelar a inscrição na notificação de alerta

    Para visualizações de valor único, a notificação do Slack vai incluir o valor único como texto, em vez de um PNG da visualização.

Enviar alertas para a integração com o Slack

A ação do Slack está disponível no Looker Action Hub. Quando essa ação é ativada na página Ações no painel Administrador, o Slack aparece como uma opção na lista suspensa 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 mais recente.
  • O recurso Lista de permissões de IP não está ativado na instância do Looker.

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

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

Depois que um administrador do Looker ativar a ação do Slack e conectar os espaços de trabalho apropriados do Slack, será possível enviar notificações de alerta para o Slack seguindo estas etapas:

  1. Selecione Slack no menu suspenso Para onde enviar.

    Se você ainda não se autenticou no Slack, um botão Fazer login com o Slack será exibido 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 OAuth. Selecione o espaço de trabalho do Slack adequado na lista suspensa. Clique em Allow (Permitir).

    Você também pode fazer a autenticação no Slack usando a página da 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 que você fizer login em pelo menos um espaço de trabalho do Slack, os campos Channel Type e Share In serão exibidos.

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

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

  4. O campo Share In é preenchido com as opções de canal e mensagem direta baseadas no espaço de trabalho do Slack selecionado. Selecione a mensagem direta ou o canal para o qual você quer enviar a notificação de alerta. Qualquer pessoa nesse canal verá uma notificação com informações relacionadas ao bloco em que o alerta está definido:

    • Uma imagem em PNG da visualização de blocos do dashboard
    • 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 navegar até o painel do bloco.
    • um link para cancelar a inscrição na notificação de alerta;

    Para visualizações de valor único, a notificação do Slack vai incluir o valor único como texto, em vez de um PNG da visualização.

Como definir a frequência dos alertas

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

  • Mensal em um Dia especificado do mês (o padrão é o 1o do mês) em um Horário especificado (o padrão é 05:00)
  • Semanal em um Dia especificado da semana (o padrão é Dom para domingo) em um Horário especificado (o padrão é 05:00)
  • Diariamente em um Horário especificado (o padrão é 05:00)
  • Por hora em um intervalo especificado (o padrão é verificar os dados a cada hora) com os horários de Início e Término especificados. O padrão é 05:00 e 17:00. Com intervalos por hora, o Looker verifica 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 os horários de Início e Término especificados (o padrão é 05:00 e 17:00). Com intervalos baseados em minutos, o Looker verifica os dados nestes intervalos:
    • 15 minutos
    • 30 minutos

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

O Looker envia alertas de acordo com o fuso horário indicado na configuração Fuso horário do aplicativo da página Configurações do administrador ou, se ativado, pelo fuso horário específico do usuário do criador do alerta.

Definição de 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 ou definir as permissões deles.

Para definir as permissões do alerta, selecione as opções Público ou Particular na lista suspensa Permissões na janela de criação de alertas. Se for possível seguir um alerta, ele será marcado como Público por padrão. Isso significa que qualquer usuário do Looker com permissões de acompanhamento no conteúdo do bloco do dashboard poderá conferir o alerta e as configurações dele na janela de visualização de alertas. Eles também podem acompanhar o alerta para receber notificações por e-mail quando as condições do alerta forem acionadas.

É possível definir o alerta como Particular para que as configurações fiquem visíveis apenas para você e para os administradores. Para isso, escolha a opção Particular na lista suspensa Permissões na janela de criação de alertas.

Não é possível seguir os alertas para as integrações do Slack e anexo do Slack (token de API). No entanto, se você criar 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.