Criar alertas

Se tiver as autorizações de utilizador adequadas, pode criar alertas em mosaicos baseados em consultas ou associados a Looks em painéis de controlo definidos pelo utilizador ou painéis de controlo do LookML.

Criar um alerta

Os alertas só podem ser definidos em mosaicos que tenham, pelo menos, uma medida numérica ou um cálculo da tabela na visualização do mosaico. O tipo de visualização e os campos presentes na visualização do mosaico do painel de controlo determinam se pode definir uma condição de alerta baseada num único campo ou valor de cálculo de tabela, ou num campo "qualquer" ou valor de cálculo de tabela.

Consoante o tipo de visualização do mosaico do painel de controlo e os tipos de campos presentes na visualização, o Looker verifica os seus dados de diferentes formas. Quando cria um alerta, este é de um dos seguintes 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 cronológicas (usados quando existe uma dimensão de data ou hora nos resultados da consulta): o Looker verifica todas as novas linhas que não foram vistas anteriormente (com base na dimensão de data ou hora na consulta).

  • Alertas categóricos (nem valor único nem série cronológica): o Looker verifica todas as linhas e valores dinâmicos, a menos que tenha sido selecionada uma linha ou um valor dinâmico específico quando o alerta foi criado.

Para criar alertas, o painel de controlo tem de estar fora do modo de edição e tem de estar fora do modo de desenvolvimento.

Para criar um alerta num mosaico do painel de controlo, clique no ícone de sino do mosaico e, de seguida, clique no botão Novo na parte inferior da lista dos alertas que tem autorização para ver (pode ter de deslocar a página para ver a lista completa). Se ainda não estiverem configurados alertas para esse mosaico ou se não tiver autorização para ver alertas existentes nesse mosaico, mantenha o ponteiro sobre o mosaico do painel de controlo para revelar o ícone Alertas em forma de sino. Clique no ícone de Alertas em forma de sino no mosaico do painel de controlo para abrir a caixa de diálogo de criação de alertas.

Na janela de criação de alertas, pode especificar vários componentes do alerta:

Cada consulta de alerta capta as definições do painel de controlo e do mosaico no momento em que o alerta foi criado. No entanto, um alerta é sincronizado com muitos dos tipos comuns de alterações que você ou outros utilizadores fazem ao respetivo painel de controlo ou mosaico subjacente, sem necessidade de recriar o alerta. Consulte a página de documentação Efeito das edições do painel de controlo nos alertas para mais informações.

Atribuir um nome a um alerta

O título do alerta predefinido indica que condições têm de ser verdadeiras para o alerta ser acionado. Se quiser mudar o nome do alerta, siga estes passos:

  1. Clique no menu de três pontos e, de seguida, em Editar alerta.
  2. Clique uma vez no título do alerta.
  3. Introduza um título personalizado e, em seguida, clique fora do campo ou prima a tecla Enter para ver a atualização.
  4. Clique em Guardar alerta para guardar o novo título.

O título do alerta personalizado é apresentado em todos os alertas visíveis publicamente que estão listados na janela de visualização de alertas nesse mosaico. O título personalizado também aparece nas notificações de alerta.

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

Definir condições de alerta

Nos menus pendentes Condição na janela de criação de alertas, pode definir os componentes que indicam ao Looker como verificar se existem alterações nos dados do mosaico e os tipos de alterações que acionam uma notificação de alerta.

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

  • A lista de campos ou cálculos de tabelas que aparecem na visualização do mosaico do painel de controlo
  • A alteração que o campo, os campos, o cálculo da tabela ou os cálculos da tabela selecionados têm de sofrer para acionar a notificação de alerta
  • A magnitude da alteração que acionaria a notificação de alerta

Estas condições incluem o seguinte:

  • É superior a
  • É inferior a
  • É igual a
  • É superior ou igual a
  • É inferior ou igual a

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

  • Aumenta em
  • Diminui em
  • Alterações efetuadas por (uma combinação de Aumentos de e Diminuições de)

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

Definir notificações de alertas

Na secção Para onde enviar da janela de criação de alertas, pode especificar o destino da notificação de alerta.

Enviar alertas para o email

Para enviar as notificações de alerta por email, selecione Email no menu pendente Para onde enviar. Pode designar os destinatários da notificação por email de alerta. O seu email é apresentado por predefinição e pode modificar a lista de destinatários conforme necessário. As suas autorizações determinam os domínios de email para os quais pode enviar notificações de alerta.

Cada destinatário recebe um email com informações sobre o alerta e uma opção para deixar de seguir o alerta. Se optar por deixar de seguir o alerta, o respetivo endereço de email é removido da lista de destinatários.

Para painéis de controlo incorporados, pode personalizar o URL que fornece aos destinatários para criar uma ligação de volta ao Looker. Para usar esta opção, um administrador do Looker ou um utilizador com a autorização schedule_look_emails ou create_alerts tem primeiro de especificar os domínios permitidos para o link personalizado e selecionar o formato do URL do link personalizado na página Incorporar no menu Administração.

  • No campo Domínio, selecione um dos domínios disponíveis.
  • No campo Caminho, introduza um caminho para o painel de controlo, como /dashboards/12 ou /reports/salesoverview. A opção Caminho é apresentada apenas se URL definido pelo utilizador estiver selecionado no campo Selecionar caminho do conteúdo na página Incorporar no menu Administração.
  • No campo Etiqueta do URL, introduza opcionalmente um novo texto para o link que aponta para o conteúdo. Este campo apresenta qualquer texto introduzido no campo Etiqueta do URL na página Incorporar no menu Administração por predefinição e pode ser alterado neste campo.

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

A ação Anexo do Slack (símbolo da API) está disponível no Centro de ações do Looker. Quando esta ação está ativada na página Ações do painel Administração, a opção Anexo do Slack (token da API) é apresentada como uma opção no menu pendente Para onde enviar da janela de criação de alertas.

Depois de um administrador do Looker ativar a ação Anexo do Slack (token da API) e de o utilizador do bot da app Looker ter sido configurado no Slack, pode seguir estes passos para enviar notificações de alertas para o Slack através da integração Anexo do Slack (token da API):

  1. Selecione Anexo do Slack (token da API) no menu pendente Para onde enviá-lo.

    Os campos Tipo de canal e Partilhar em são apresentados.

  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
    • Utilizadores: envie o alerta numa mensagem direta a um utilizador do Slack

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

  3. No campo Partilhar em, selecione a mensagem direta ou o canal para o qual quer enviar a notificação de alerta. O utilizador ou o canal selecionado recebe uma notificação com informações relativas ao mosaico no qual o alerta está definido:

    • Uma imagem PNG da visualização do mosaico do painel de controlo
    • Uma mensagem com o nome do painel de controlo ou o título do alerta personalizado e as condições que acionaram o alerta
    • Um link para navegar para o painel de controlo do mosaico
    • Um link para anular a subscrição da notificação de alerta

Envio de alertas para a integração do Slack

A ação do Slack está disponível no Centro de ações do Looker. Quando esta ação está ativada na página Ações do painel Administração, o Slack é apresentado como uma opção no menu pendente Para onde enviar da janela de criação de alertas. Um administrador do Looker também tem de associar, pelo menos, um espaço de trabalho do Slack à instância do Looker.

A integração do Slack está disponível para implementações alojadas no Looker que satisfazem estas condições:

Esta integração do Slack não é suportada para instâncias alojadas pelo cliente.

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

Depois de um administrador do Looker ativar a ação do Slack e associar os espaços de trabalho do Slack adequados, pode enviar notificações de alerta para o Slack seguindo estes passos:

  1. Selecione Slack no menu pendente Para onde enviar.

    Se ainda não tiver feito a autenticação no Slack, é apresentado um botão Iniciar sessão com o Slack no menu pendente Para onde enviar.

  2. Clique em Iniciar sessão com o Slack. O Looker pede acesso ao espaço de trabalho do Slack. Se o administrador do Looker tiver associado vários espaços de trabalho do Slack à sua instância do Looker, é apresentado um menu pendente na parte superior direita da página de autorização OAuth. Selecione o espaço de trabalho do Slack adequado no menu pendente. Clique em Permitir.

    Também pode autenticar o Slack a partir da página da sua conta pessoal no Looker. Se o administrador do Looker tiver associado vários espaços de trabalho do Slack à sua instância do Looker, é apresentada uma lista de espaços de trabalho com opções para iniciar sessão em cada um individualmente.

    Depois de iniciar sessão em, pelo menos, um espaço de trabalho do Slack, são apresentados os campos Tipo de canal e Partilhar em.

    Mesmo que os utilizadores incorporados tenham autorizações para enviar notificações de alerta para a integração do Slack, a opção Slack não é apresentada no menu pendente Para onde enviar, a menos que o respetivo espaço de trabalho do Slack esteja ligado à instância do Looker.

  3. O menu pendente Espaço de trabalho mostra uma lista de todos os espaços de trabalho nos quais tem sessão iniciada. Selecione um espaço de trabalho na lista. Se não vir o espaço de trabalho para o qual quer enviar a notificação de alerta, pode ver uma lista dos espaços de trabalho que o seu administrador do Looker associou à sua instância do Looker e iniciar sessão em cada um individualmente a partir da página da sua conta pessoal no Looker.

  4. O campo Partilhar em é 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 ao qual quer enviar a notificação de alerta. Todas as pessoas nesse canal veem uma notificação com informações relativas ao mosaico no qual o alerta está definido:

    • Uma imagem PNG da visualização do mosaico do painel de controlo
    • Uma mensagem com o nome do painel de controlo ou o título do alerta personalizado e as condições que acionaram o alerta
    • Um link para navegar para o painel de controlo do mosaico
    • Um link para anular a subscrição da notificação de alerta

Definir a frequência dos alertas

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

  • Mensalmente num dia especificado do mês (predefinição: 1.º do mês) a uma hora especificada (predefinição: 05:00)
  • Semanalmente num Dia especificado da semana (a predefinição é Dom para domingo) a uma Hora especificada (a predefinição é 05:00)
  • Diariamente a uma hora especificada (a predefinição é 05:00)
  • Por hora a um intervalo especificado (a predefinição é verificar os dados a cada hora) com horas de início e fim especificadas (a predefinição é 05:00 e 17:00). Com intervalos de horas, pode fazer com que o Looker verifique os dados nestes intervalos:
    • Hora
    • 2 horas
    • 3 horas
    • 4 horas
    • 6 horas
    • 8 horas
    • 12 horas
  • Minutos num intervalo especificado (a predefinição é verificar os dados a cada 15 minutos) com horas de início e fim especificadas (a predefinição é 05:00 e 17:00). Com intervalos baseados em minutos, pode fazer com que o Looker verifique os dados nestes intervalos:
    • 15 minutos
    • 30 minutos

As horas de início e fim estão incluídas. Por exemplo, se definir Verificar a cada como 12 horas com uma hora de Início de 05:00 e uma hora de Fim de 17:00, o Looker verifica os dados às 05:00 e às 17:00.

O Looker envia alertas de acordo com o fuso horário indicado na definição Fuso horário da aplicação na página Definições de administração ou, se ativado, o fuso horário específico do utilizador do criador do alerta.

Definir autorizações de alertas

Por motivos de segurança, alguns alertas não podem ser vistos nem seguidos por outros utilizadores, e não pode ver nem definir as respetivas autorizações.

Pode definir as autorizações do alerta selecionando as opções Público ou Privado no menu pendente Autorizações na janela de criação de alertas. Se um alerta puder ser seguido, é marcado como Público por predefinição, o que significa que qualquer utilizador do Looker com autorizações de seguimento no conteúdo subjacente do mosaico do painel de controlo pode ver o seu alerta e as respetivas definições na janela de visualização de alertas. Também podem seguir o seu alerta para receber notificações por email quando as condições do alerta forem acionadas.

Pode definir o seu alerta como Privado para que as respetivas definições sejam visíveis apenas para si (e para os administradores). Para tal, escolha a opção Privado no menu pendente Autorizações na janela de criação de alertas.

Não é possível seguir os alertas para as integrações do Slack e do anexo do Slack (token da API). No entanto, se estiver a criar um alerta para um destes destinos e o marcar como Público, outros utilizadores vão poder ver e duplicar as suas definições de alerta.