Se você tiver as permissões apropriadas do usuário, poderá criar alertas em blocos baseados em consultas ou vinculados ao visual em painéis definidos pelo usuário ou painéis do LookML que usam painéis novos ou legados.
Como criar um alerta
Os alertas só podem ser definidos em blocos com pelo menos uma medida numérica ou cálculo de tabela na visualização do bloco. O tipo de visualização e os campos presentes na visualização de blocos do painel determinam se você pode definir uma condição de alerta com base em um único valor de cálculo de campo ou tabela ou em "qualquer" valor de cálculo de campo ou 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. Quando você 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é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 na consulta).
- Alertas categóricos (nem um valor único nem uma série temporal): o Looker verifica todas as linhas e valores dinâmicos, a menos que uma linha ou valor dinâmico específico tenha sido selecionado quando o alerta foi criado
Os alertas com base em um cálculo de tabela que inclui um total de linhas não são compatíveis.
Para criar alertas, seu painel deve estar fora do modo de edição e você deve estar fora do modo de desenvolvimento.
Para criar um alerta em um bloco do painel, clique no ícone de sino e no botão Novo na parte inferior da lista de alertas que você tem permissão para ver. Talvez seja necessário rolar para ver a lista completa. Se nenhum alerta estiver configurado para o bloco, ou se você não tiver permissão para ver os alertas existentes, passe o cursor sobre o bloco do painel para ver o ícone de alertas em forma de sino. Clique no ícone Alertas para abrir a janela de criação de alertas.
Na janela de criação de alertas, você pode especificar vários componentes do alerta:
- Título personalizado
- Condições de alerta
- Destinatários
- Frequência
- Permissões (dependendo se o alerta seria seguinte)
Cada consulta de alerta captura as configurações de painel e bloco no momento em que o alerta foi criado. Uma consulta de alerta não captará as alterações feitas no painel ou no bloco após a criação do alerta, incluindo alterações nos filtros do painel ou na aparência da visualização do bloco do painel (como alterações no tipo de visualização). Você precisa criar um novo alerta depois que as alterações forem implementadas para que elas sejam aplicadas ao alerta e às notificações.
Um alerta é sincronizado com muitos dos tipos comuns de alterações que você ou outros usuários fazem no painel ou bloco subjacente, 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.
Nomear um alerta
O título de alerta padrão indica quais condições precisam ser verdadeiras para que o alerta seja acionado. Se quiser renomear seu alerta:
- Clique no menu de três pontos e em Editar alerta.
- Clique uma vez no título do alerta.
- Digite um título personalizado e clique fora do campo ou pressione a tecla Enter para ver a atualização.
- Clique em Salvar alerta para salvar o novo título.
Seu título de alerta personalizado será exibido em todos os alertas visíveis publicamente listados na janela de visualização de alertas do bloco. O título personalizado também aparecerá nas notificações de alerta.
Passe o cursor sobre o título personalizado de qualquer alerta na janela de visualização do alerta para ver as condições que acionam o 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 as mudanças nos dados do bloco 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 tabela que aparecem na visualização do bloco do painel.
- A alteração que o campo, os campos ou o cálculo da tabela selecionada precisa passar para acionar a notificação de alerta
- A magnitude da alteração que acionaria 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 contiver um campo de data ou hora, condições adicionais estarão disponíveis:
- Increases by (Aumenta em)
- Decreases by (Diminui em)
- Alterações em (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 a página "Práticas recomendadas" em Como configurar alertas com base em dados de série temporal.
O Looker só cria alertas com base em comparações entre valores inteiros e decimais. No entanto, com uma solução simples, é possível definir alertas 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, você pode especificar o destino da notificação.
Enviando alertas para e-mail
Para enviar suas notificações de alerta para o e-mail, selecione E-mail na lista suspensa Para onde enviá-lo. Você pode designar os destinatários da notificação 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 você pode enviar notificações de alerta.
Cada destinatário receberá um e-mail com informações sobre o alerta e uma opção para deixar de seguir o alerta. Se ele optar por parar de seguir o alerta, o endereço de e-mail dele será removido da lista de destinatários.
Incluir link personalizado
Se o recurso URLs personalizados para alertas e e-mails de programação do Labs estiver ativado, o Looker exibirá a opção Incluir link personalizado.
No caso de conteúdo incorporado, é possível personalizar o URL para que os destinatários o vinculem novamente ao Looker.
- No campo Domain, selecione um dos domínios disponíveis.
- No campo Path, insira opcionalmente um caminho para o conteúdo, como
/dashboards/12ou/reports/salesoverview. O formato do caminho deve corresponder à seleção de parâmetro definida definida na página Configurações de administrador: incorporar. - No campo Rótulo do URL, insira um novo texto para o link que direciona para o conteúdo.
Como enviar alertas para a integração de anexo do Slack (token de API)
A ação de anexo do Slack (token de API) está disponível no Hub de ação do Looker. Quando essa ação é ativada na página Ações no painel Administrador, o Anexo do Slack (token de API) aparece como uma opção na lista suspensa Para onde enviar da janela de criação de alerta.
Os administradores das instâncias hospedadas pelo cliente que usam um servidor de hub de ação auto-hospedado precisam reiniciar o servidor quando atualizarem a instância do Looker.
Depois que um administrador do Looker tiver ativado a ação Anexo da Slack (Token de API) e o usuário do bot de aplicativo do Looker tiver sido configurado no Slack, será possível enviar notificações de alerta para o Slack usando a integração de Anexo da Slack (Token de API):
Selecione Anexo do Slack (Token de API) na lista suspensa Para onde enviá-lo.
Os campos Tipo de canal e Compartilhar em aparecerão abaixo do menu suspenso Para onde enviar.
Mesmo que os usuários incorporados tenham permissões para enviar notificações de alerta à integração de anexos do Slack, eles não verão o Anexo do Slack (Token de API) na lista suspensa Onde enviá-lo, a menos que o espaço de trabalho do Slack esteja configurado para o usuário bot do aplicativo Looker.
Use o campo Channel Type para especificar o tipo de destinatário do Slack em que o alerta:
- Canais: envie o alerta para um canal do Slack.
- Users: envia o alerta em uma mensagem direta para um usuário do Slack.
Depois de selecionar o tipo de canal, o campo Share In será preenchido com o canal ou as opções de mensagens diretas aplicáveis às credenciais do usuário do bot do app Looker no espaço de trabalho do Slack.
No campo Compartilhar em, selecione a mensagem direta ou o canal para o qual você deseja enviar a notificação de alerta. O usuário ou canal selecionado receberá uma notificação com informações relativas ao bloco em que o alerta foi definido:
- Uma imagem PNG da visualização de blocos 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
Para visualizações de valor único, a notificação do Slack incluirá 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 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 alerta. Um administrador do Looker também precisa conectar pelo menos um espaço de trabalho do Slack à instância do Looker.
A integração do Slack está disponível para implantações hospedadas pelo Looker que atendem a estas condições:
- a instância do Looker está na versão 6.24 ou posterior;
- O recurso Lista de permissões de IP não está ativado na instância do Looker.
Essa integração com o Slack não é compatível com instâncias hospedadas pelo cliente.
Para permitir a instalação do aplicativo Looker, o proprietário do espaço de trabalho do Slack pode precisar ajustar as configurações de instalação do aplicativo do espaço de trabalho do Slack.
Depois que um administrador do Looker tiver ativado a ação do Slack e conectado os espaços de trabalho apropriados do Slack, você poderá enviar notificações de alerta para o Slack:
Selecione Slack na lista suspensa Onde enviar.
Se você ainda não fez a autenticação no Slack, um botão Sign in with Slack é exibido na lista suspensa Where to send it.
Clique em Sign in with Slack. O Looker 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 será exibido no canto superior direito da página OAuth. Selecione o espaço de trabalho apropriado do Slack no menu suspenso. Clique em Permitir.
Também é possível autenticar no Slack pela página da conta pessoal do 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 de login em cada um.
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 abaixo do campo Workspace.
Mesmo que os usuários incorporados tenham permissões para enviar notificações de alerta à integração do 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 na lista suspensa Onde enviar.
A lista suspensa 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 que você quer enviar a notificação de alerta não aparecer, veja uma lista dos espaços de trabalho que o administrador do Looker conectou à instância do Looker e faça login em cada um individualmente na página da sua conta pessoal.
O campo Share In é preenchido com as opções de canal e mensagem direta baseadas no espaço de trabalho selecionado do Slack. Selecione a mensagem direta ou o canal para onde você quer enviar a notificação de alerta. Qualquer pessoa nesse canal verá uma notificação com informações relativas ao bloco em que o alerta foi definido:
- Uma imagem PNG da visualização de blocos 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
Para visualizações de valor único, a notificação do Slack incluirá o valor único como texto, em vez de um PNG da visualização.
Como definir a frequência do alerta
Na seção Frequência da janela de criação do alerta, você pode definir a frequência com que o Looker verifica se há alterações nos seus dados e envia uma notificação de alerta caso as condições de alerta sejam 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 do mês especificado (o padrão é o 1o do mês) em uma Hora especificada (o padrão é 05:00).
- Semanal, em um Dia da semana especificado (o padrão é Dom para domingo) em um Horário especificado (o padrão é 05:00).
- Daily em um Time 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 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 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 pode verificar 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 Check every como 12 hours com Start como 05:00 e End como 17:00, o Looker verificará os dados às 5h e 17h.
O Looker envia alertas de acordo com o fuso horário indicado na configuração do 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 de alertas.
Como definir permissões de alertas
Para definir as permissões do seu alerta, selecione as opções Pública ou Particular na lista suspensa Permissões na janela de criação do alerta. Se um alerta não for impossível acompanhar, ele será marcado como Público por padrão, o que significa que qualquer usuário do Looker com permissões a seguir no conteúdo subjacente do bloco do painel pode ver seu alerta e as configurações dele na janela de visualização de alerta. Eles também podem seguir seu alerta para receber notificações por e-mail quando as condições dele forem acionadas.
Não é possível seguir os alertas para integrações do Slack e de Anexo do Slack (token de API). 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.
Você pode definir seu alerta como Particular para que as configurações sejam 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 alerta.
Por motivos de segurança, alguns alertas não podem ser vistos ou seguidos por outros usuários, e você não conseguirá visualizar ou definir as permissões de alerta.