Como criar alertas

Se você tiver as permissões adequadas, poderá criar alertas em blocos com base em consultas ou vinculados a um Look em painéis definidos pelo usuário ou LookML.

Como criar um alerta

Os alertas só podem ser definidos em Blocos que tenham 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 do bloco do painel determinam se é possível definir uma condição de alerta com base em um único campo ou valor de cálculo de tabela ou em "qualquer" campo ou valor de cálculo de tabela.

Dependendo do tipo de visualização do bloco do painel e dos tipos de campos presentes na visualização, o Looker verifica seus dados de maneiras diferentes. Ao criar um alerta, ele será 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éries temporais (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 na consulta).
  • Alertas categóricos (nem valor único nem série temporal) — o Looker verifica todas as linhas e valores de pivot, a menos que uma linha ou um valor de pivot específico tenha sido selecionado ao criar o alerta.

Não é possível usar alertas com base em um cálculo de tabela que inclui um total de linha.

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 do bloco e depois no botão Novo na parte de baixo da lista dos alertas que você tem permissão para ver. Talvez seja necessário rolar a tela para ver a lista inteira. Se ainda não houver alertas configurados para esse bloco ou se você não tiver permissão para ver os alertas existentes, mantenha o ponteiro sobre o bloco do painel para revelar o ícone de Alertas em forma de sino. Clique no ícone de sino Alerts 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 é sincronizado com muitos dos tipos comuns de mudanças que você ou outros usuários fazem no painel ou bloco principal, sem a necessidade de recriar o alerta. Consulte a página de documentação Efeito das edições do painel nos alertas para mais informações.

Como nomear um alerta

O título do alerta 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. Digite um título personalizado e clique fora do campo ou pressione a tecla Enter para conferir 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 publicamente listados na janela de visualização de alertas no bloco. O título personalizado também vai aparecer nas notificações do alerta.

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

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 as 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 ou os cálculos de tabela selecionados precisam sofrer para acionar a notificação de alerta
  • A magnitude da mudança que aciona a notificação de alerta

Essas 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)
  • Alterações feitas por (uma combinação de Aumenta em e Diminui em)

O uso dessas condições de comparação com dados de série temporal tem algumas considerações adicionais. Para mais informações, consulte esta página de práticas recomendadas sobre Como definir alertas com base em série temporal temporais.

É possível criar alertas com base apenas em comparações de valores de dados inteiros e decimais. Para definir alertas com base em mudanças percentuais dos valores de dados, consulte a página de práticas recomendadas Como definir condições de alerta com base em mudanças percentuais dos 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.

Como enviar alertas para e-mail

Para enviar as notificações de alerta por e-mail, selecione E-mail no menu suspenso 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 cancelar a inscrição. Se o usuário decidir parar de seguir o alerta, o endereço de e-mail dele será removido da lista de destinatários.

Para painéis incorporados, é possível personalizar o URL fornecido para que os destinatários tenham acesso 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 precisa especificar os domínios permitidos para o link personalizado e selecionar o formato do URL do link personalizado na página Inserir no menu Administrador.

  • No campo Domínio, selecione um dos domínios disponíveis.
  • No campo Caminho, insira um caminho para o painel, como /dashboards/12 ou /reports/salesoverview. A opção Caminho só aparece se URL definido pelo usuário estiver selecionado no campo Selecionar caminho do conteúdo na página Inserir no menu Administrador.
  • No campo URL label, insira um novo texto para o link que aponta para o conteúdo. Esse campo mostra qualquer texto inserido no campo Rótulo do URL na página Inserir no menu Administrador por padrão e pode ser alterado nesse campo.

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

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

Os administradores de instâncias hospedadas pelo cliente que usam um servidor do Action Hub auto-hospedado precisam reiniciar o servidor quando atualizam a instância da Looker.

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

  1. Selecione Anexo do Slack (token da API) no menu suspenso Para onde enviar.

    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 Attachment, eles não vão encontrar a opção Slack Attachment (API Token) no menu suspenso Where to send it, 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 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: enviar 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 relacionadas ao 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 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 inclui o valor único como texto, em vez de um PNG da visualização.

Como enviar alertas para a integração do Slack

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

Esta integração do 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 precisa ajustar as configurações de instalação do app.

Depois que um administrador do Looker ativar a ação do Slack e conectar os espaços de trabalho do Slack adequados, você poderá 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 tiver feito a autenticação no Slack, o 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 no menu suspenso. Clique em Permitir.

    Também é possível fazer a autenticação 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ê vai encontrar 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, eles não vão ver a opção Slack no menu suspenso Para onde enviar, a menos que o espaço de trabalho do Slack esteja conectado à instância do Looker.

  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 o espaço de trabalho para o qual você quer enviar a notificação de alerta não aparecer, acesse uma lista dos espaços de trabalho que o administrador do Looker conectou à sua instância 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. Qualquer pessoa nesse canal vai receber uma notificação com informações relacionadas ao 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 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 inclui 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, é possível definir a frequência com que o Looker verifica se há mudanças nos dados e envia uma notificação de alerta se as condições forem atendidas. A frequência padrão é Diária às 05:00. As opções de frequência disponíveis são as seguintes:

  • Mensal em um dia específico do mês (o padrão é o 1º) em um horário específico (o padrão é 05:00).
  • Semanal em um dia específico da semana (o padrão é Dom 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 os horários de início e término especificados (o padrão é 05:00 e 17:00). Com intervalos de uma hora, é possível verificar os dados do Looker 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 Fim especificados (o padrão é 05:00 e 17:00). Com intervalos baseados em minutos, é possível fazer com que o Looker verifique os dados nesses 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 de 05:00 e um horário de Término de 17:00, o Looker vai verificar os dados às 05:00 e 17:00.

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

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 conferir nem definir as permissões deles.

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

Você pode definir o alerta como Privado para que as configurações dele sejam visíveis apenas para você (e administradores) escolhendo a opção Privado no menu suspenso Permissões na janela de criação de alertas.

Não é possível acompanhar os alertas para as integrações com o Slack e o 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.