Como visualizar alertas que você tem ou segue

A página do usuário Gerenciar alertas mostra uma lista de todos os alertas que você tem ou segue ou em que você é listado como destinatário, dependendo das suas permissões de alerta:

Permissões Alertas exibidos na página do usuário Gerenciar alertas
admin Os usuários podem conferir os alertas que criaram ou seguiram ou em que estão listados como destinatários.
create_alerts Os usuários podem conferir os alertas que criaram.
follow_alerts Os usuários podem conferir os alertas que seguiram ou para os quais foram listados como destinatários.

Como acessar a página "Gerenciar alertas" do usuário

Para acessar a página do usuário Gerenciar alertas, selecione o menu Perfil e, em seguida, Alertas.

A página do usuário Gerenciar alertas fornece informações sobre todos os alertas na instância do Looker. Para alertas que você criou, segue ou em que você é um destinatário, é possível ver estas configurações na tabela da página do usuário Gerenciar alertas:

Coluna Definição
Nome do alerta O título do alerta, que é definido quando ele é criado ou editado. O título do alerta padrão indica as condições que precisam ser atendidas ou excedidas para que o alerta seja acionado. Selecione o nome do alerta para abrir a página Detalhes do alerta.
Painel O nome do painel que contém o bloco com o alerta. Acesse o link para navegar até o painel. Nenhum indica que o alerta foi desincronizado do painel. Para resolver um alerta não sincronizado, consulte a página de documentação Efeito das edições do painel nos alertas.
Proprietário O nome do usuário que criou o alerta.
Tempo médio de execução A duração da consulta de alerta em segundos.
Condição atendida Sim ou Não, que indica se as condições do alerta foram atendidas na última execução da consulta. Um símbolo -- será exibido se a consulta de alerta ainda não tiver sido executada ou se ela tiver sido executada, mas não foi possível determinar se as condições do alerta foram atendidas. Essa coluna mostra ícones de aviso ou de erro relacionados a avisos ou erros que aparecem quando a consulta de alerta é executada ou a notificação de alerta é enviada. Passe o cursor sobre o ícone de aviso ou erro para ver a mensagem de erro associada, se aplicável.

Um ícone de aviso com um alerta de alerta desatualizado indica que os dados no bloco do painel não mudaram entre as duas consultas de alerta mais recentes. Leia mais sobre essa mensagem na seção Mensagens de erro e aviso do alerta desta página.
Frequência A frequência com que o alerta é verificado para saber se as condições foram atendidas ou excedidas.
Status Essa coluna indica se o alerta está ativo ou desativado.

  • Um alerta é marcado como Desativado quando um usuário desativa o próprio alerta (usando o menu de três pontos) no pop-up de criação de alertas ou quando um administrador do Looker desativa o alerta. Passe o cursor sobre o status Desativado para ver a explicação sobre por que o alerta foi desativado. A desativação de um alerta pausa as notificações para todos os destinatários, mas o alerta ainda aparece na janela de visualização de alertas. O proprietário do alerta pode ver que o status do alerta aparece como Ativo até a próxima vez que a consulta de alerta for executada.

  • Se um administrador desativar o alerta, os seguidores não vão mais receber notificações.
Seguindo Um botão que indica seu status de seguidor do alerta. Saiba mais na seção Alertas seguidos desta página.
Atividade Um link que direciona você para a guia Atividade do alerta na página Detalhes do alerta.
Menu de três pontos Um menu com outras ações que podem ser realizadas no alerta. Consulte mais informações na seção Opções de gerenciamento de alertas desta página.

Se um usuário excluir o painel ou o bloco de resumo em que o alerta está ativado, ele será desativado. Os seguidores ou destinatários não vão mais receber notificações quando as condições do alerta forem atendidas. Nesta página, o nome do painel será excluído imediatamente para o alerta. Na próxima vez que a consulta de alerta for executada, o status vai aparecer como Desativado com uma mensagem de dica indicando que o painel ou elemento do painel (bloco) foi excluído. Um administrador pode excluir permanentemente o alerta no menu de três pontos à direita dele.

Como filtrar alertas

Para filtrar a lista de alertas, selecione o ícone de filtro na parte de cima da lista.

É possível filtrar alertas por:

  • Frequência: a frequência com que o alerta é verificado para saber se as condições foram atendidas ou excedidas
    • Minutos: retorna todos os alertas com uma frequência de 15 minutos ou 30 minutos.
    • Horarário: retorna todos os alertas com uma frequência de 1 hora, 2 horas, 3 horas, 4 horas, 6 horas, 8 horas ou 12 horas.
    • Diário: retorna todos os alertas com uma frequência diária de qualquer horário.
    • Semanal: retorna todos os alertas com uma frequência Semanal de qualquer Dia ou Hora.
    • Mensal: retorna todos os alertas com uma frequência Mensal de qualquer Dia ou Hora.
  • Condição atendida: indica se as condições do alerta foram atendidas quando a consulta de alerta foi executada pela última vez.
    • Sim: as condições de alerta foram atendidas ou excedidas.
    • Não: as condições de alerta não foram atendidas ou excedidas.
  • Status: indica se o alerta ainda está sendo verificado em relação às condições
    • Ativo: o alerta ainda está sendo verificado de acordo com as condições.
    • Desativado: o alerta não está mais sendo verificado em relação às condições.

É possível aplicar vários filtros aos resultados. Para excluir um filtro, selecione o x ao lado do nome dele. Atualizar o navegador também exclui todos os filtros selecionados.

Agrupar alertas

Clique no ícone Agrupar alertas para abrir o menu Agrupar por.

É possível agrupar alertas das seguintes maneiras:

  • Padrão: sem agrupamento
  • Nomes do painel: em ordem alfabética pelo nome do painel em que o alerta foi definido
  • Proprietário: em ordem alfabética pelo proprietário do alerta

Mensagens de alerta e aviso

A página do usuário Gerenciar alertas mostra todos os erros ou avisos que aparecem quando a consulta de alerta é executada ou a notificação de alerta é enviada. Passe o cursor sobre o ícone de aviso ou erro na coluna Condição atendida para ver a mensagem de erro associada.

Para alertas configurados para enviar notificações às integrações do Slack ou do Anexo do Slack (token de API), a mensagem de erro Notification delivery failed with existing configuration aparece quando a consulta de alerta determina que as condições do alerta foram atendidas, mas a notificação não pôde ser enviada. Essa falha pode ocorrer se algo na configuração do Slack tiver mudado desde a criação do alerta. Por exemplo, se o espaço de trabalho do Slack para onde o alerta estava sendo enviado foi desconectado da instância do Looker ou se o canal do Slack para onde o alerta estava sendo enviado foi excluído ou se o Looker não conseguir se conectar às integrações.

Aviso: consulta de dados atualizados

Um ícone de aviso na coluna Condição atendida indica que os dados no bloco do painel em que o alerta é baseado não mudaram entre as duas consultas de alerta mais recentes. Ao passar o cursor sobre esse ícone, a mensagem Alerta de alerta desatualizado e este texto aparecem:

The data for this tile did not change between the two most recent alert queries. Verify that the caching policies defined for this dashboard tile are aligned with the alert frequency.

Há algumas explicações possíveis para os dados não terem mudado entre as consultas. Se o aviso persistir, converse com o administrador ou desenvolvedor do Looker para verificar se as políticas de armazenamento em cache definidas para esse bloco do painel estão alinhadas à configuração de frequência do alerta.

Alertas seguintes

A coluna Seguindo mostra botões Seguir e Deixar de seguir clicáveis e botões Seguir não clicáveis.

Se você estiver seguindo o alerta, vai aparecer um botão Parar de seguir ao lado dele. Se você selecionar Parar de seguir, não vai receber mais notificações quando esse alerta for acionado. Depois de selecionar Parar de seguir, você vai ver resultados diferentes, dependendo da sua relação com o alerta (proprietário, destinatário ou nenhum dos dois):

Um botão Follow inativo vai aparecer ao lado do alerta se uma das seguintes condições for verdadeira:

Opções de gerenciamento de alertas

À direita de cada alerta, há um menu de três pontos com estas opções:

  • Ver alerta
  • Editar alerta
  • Desativar alerta (se o alerta estiver ativado)
  • Ativar alerta (se o alerta estiver desativado)

Selecione View Alert para abrir a página Alert Details.

Selecione Editar alerta para abrir a janela de alerta, onde é possível modificar as configurações. Selecione Salvar alerta para salvar as mudanças ou Cancelar para fechar a janela de alerta sem salvar.

Se um usuário excluir o painel ou o bloco de resumo em que o alerta está ativado, ele será desativado. Os seguidores ou destinatários não vão mais receber notificações quando as condições do alerta forem atendidas. Nesta página, o proprietário do alerta vai saber imediatamente que o nome do painel foi excluído. Na próxima vez que a consulta de alerta for executada, o Status do alerta vai aparecer como Desativado.

Página "Alert Details"

A página Detalhes do alerta é um pop-up que mostra um resumo das informações do alerta, que é configurado pelo proprietário. Os proprietários e seguidores de alertas têm uma visualização diferente desta página.

Você pode abrir a página Detalhes do alerta de uma destas maneiras:

  1. Clique no menu de três pontos à direita do alerta e selecione Ver alerta.
  2. Clicar no título do alerta

Como configurar a página "Detalhes do alerta"

Depois que você cria um alerta, uma entrada para ele aparece na página do usuário Gerenciar alertas. Abra a página Detalhes do alerta para configurar as informações sobre o alerta que os seguidores e destinatários podem ver:

  1. Selecione dentro da caixa de texto para adicionar contexto sobre quais condições acionam o alerta ou o que significa acionar um alerta. Selecione Salvar para salvar a descrição.
  2. Selecione o botão + Link Investigative Dashboard para abrir uma nova janela em que você pode conectar outro painel a esse alerta.

Na janela Vincular painel a alerta, selecione a pasta que contém o painel e o nome dele. O nome do painel vinculado vai aparecer no lugar do botão + Vincular painel de investigação. Selecione o botão para acessar o painel vinculado. Para excluir o painel vinculado, clique no x no nome dele. O Looker vai pedir que você confirme a exclusão do link.

Alguns detalhes do alerta são mostrados automaticamente na página Detalhes do alerta e não podem ser configurados:

  • Informações sobre o histórico do alerta (notadas na guia Atividade da página)
  • Visualização do alerta
  • O status de sincronização do painel e o nome do painel ao qual o alerta está associado

Outras maneiras de interagir com um alerta seu incluem:

  • Selecione o menu de três pontos na visualização do alerta e, em seguida, selecione Analisar a partir daqui para abrir uma Análise predefinida com a consulta do bloco do painel em que o alerta foi definido.
  • Selecione o botão Testar agora para executar uma consulta de alerta instantâneo. Se o alerta for acionado, uma notificação será enviada ao proprietário, aos destinatários e aos seguidores.

Selecione Concluído para fechar a página Detalhes do alerta.

Como acessar a página "Detalhes do alerta"

Você pode conferir os Detalhes do alerta de um alerta que não é seu se estiver listado como destinatário ou se tiver escolhido acompanhar o alerta. Abra a guia Detalhes na página Detalhes dos alertas para conferir as informações sobre um alerta que o proprietário configurou:

  1. Confira o contexto sobre quais condições acionam o alerta ou o que significa acionar um alerta.
  2. Selecione o painel vinculado para navegar até outro painel que possa adicionar contexto à consulta de alerta.
  3. Acessar a visualização do alerta.
  4. Confira o status da sincronização de alertas.
  5. Selecione o menu de três pontos na visualização de alerta e clique em Analisar a partir daqui para abrir uma Análise predefinida com a consulta do bloco do painel em que o alerta foi definido.
  6. Selecione o botão Testar agora para executar uma consulta de alerta instantâneo. Se o alerta for acionado, uma notificação será enviada ao proprietário, aos destinatários e aos seguidores.
  7. Para fechar a página Detalhes do alerta, selecione Concluído.

Como conferir a atividade do alerta

O Looker executa uma consulta de alerta na frequência especificada para verificar se os dados atenderam ou excederam as condições de alerta. Os resultados dessas verificações se tornam o histórico do alerta. Selecione a guia Atividade na parte de cima da página Detalhes do alerta para conferir o histórico do alerta e outras informações:

  1. Confira a frequência com que o alerta é verificado em relação às condições.
  2. Acessar metadados do alerta.
  3. Confira o status da sincronização de alertas.
  4. Selecione o botão Testar agora para executar uma consulta de alerta instantâneo. Se o alerta for acionado, uma notificação será enviada ao proprietário, aos destinatários e aos seguidores.
  5. Selecione Concluído para fechar a página Detalhes do alerta.

Como conferir os metadados do alerta

A tabela na guia Atividade da página Detalhes do alerta inclui metadados sobre cada execução de alerta.

Título Definição Valores possíveis
Executado em O carimbo de data/hora de quando a consulta de alerta foi iniciada Qualquer carimbo de data/hora no formato 6/25/2021, 10:45:21 AM
Tempo de execução Tempo que a consulta do alerta levou para ser executada Qualquer duração no formato 0.81s
Fresco Um booleano que indica se a consulta de alerta verificou dados que mudaram entre as duas consultas de alerta mais recentes. Se os dados mudaram ou não
  • Yes (se os dados mudaram)
  • No (se os dados não mudarem)
Origem A origem dos dados em que a consulta de alerta verificou o valor condicional
  • query
  • cache
  • stale cache
  • Se query, cache ou stale cache não forem usados, o valor Source vai ficar em branco.
Hora da origem O carimbo de data/hora da linha do banco de dados em que a consulta de alerta verificou o valor condicional Qualquer carimbo de data/hora no formato 6/25/2021, 9:25:40 AM
Condição atendida Um booleano que indica se as condições de alerta foram atendidas ou não
  • Yes (as condições foram atendidas)
  • No (as condições não foram atendidas)
Gatilho O valor condicional que aciona o alerta se for atendido ou excedido Qualquer valor numérico
Observado O valor observado que atendeu ou excedeu as condições de alerta e acionou o alerta Qualquer valor numérico
Status O status da consulta de alerta
  • Complete
  • Running
  • Not Started

Como conferir o status da sincronização de alertas

As duas guias na página Detalhes do alerta mostram o status de sincronização do alerta e o nome do painel a que ele está associado:

  • Uma marca de seleção verde com um círculo indica que o alerta ainda está sincronizado com o painel.
  • Um símbolo de aviso triangular amarelo indica que o alerta foi desincronizado do painel. O status inclui um carimbo de data/hora de quando a sincronização foi interrompida. Um alerta não sincronizado mostra um valor Nenhum na coluna Painel. Para informações sobre como resolver um alerta não sincronizado, consulte a página de documentação Efeito das edições do painel nos alertas.