Os administradores do Looker podem gerenciar alertas criados por todos os usuários na página de gerenciamento de Alertas, que pode ser acessada na seção Alertas e programações do painel Administrador. A página de administração de gerenciamento de Alertas lista informações sobre todos os alertas ativos e inativos.
Os administradores também podem ver os alertas que criaram ou seguiram ou para os quais estão listados como destinatários na página de usuário Gerenciar alertas. Os usuários com outras permissões de alerta podem gerenciar os alertas que criaram e seguiram na página do usuário Gerenciar alertas.
Informações do alerta
A página de administrador Gerenciar alertas mostra informações sobre todos os alertas na instância do Looker. Os administradores e os usuários com a permissão see_alerts podem ver estas configurações na tabela da página de administrador em Gerenciar alertas:
| Coluna | Definição |
|---|---|
| Nome do alerta | O título do alerta, que é definido quando o alerta é criado ou editado. O título padrão do alerta indica as condições que precisam ser atendidas ou excedidas para que o alerta seja acionado. Clique no nome do alerta para abrir a página Detalhes do alerta correspondente. |
| Painel | O nome do dashboard que contém o bloco com o alerta. Clique no link para acessar o painel. Nenhum indica que o alerta não foi sincronizado no painel. Para resolver um alerta não sincronizado, consulte a página de documentação Efeito de edições do painel em 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 | Um Sim ou Não que indica se as condições de alerta foram atendidas quando a consulta de alerta foi executada pela última vez. Um símbolo -- será exibido se a consulta de alerta ainda não tiver sido executada ou se a consulta de alerta tiver sido executada, mas não for possível determinar se as condições do alerta foram atendidas. Essa coluna exibe ícones de aviso ou de erro relacionados a todos os avisos ou erros exibidos quando a consulta de alerta é executada ou a notificação de alerta é entregue. Passe o cursor sobre o ícone de aviso ou erro para ver a mensagem de erro associada, se aplicável.Um ícone com um alerta de alerta desatualizado indica que os dados no bloco do dashboard não mudaram entre as duas consultas de alerta mais recentes. Leia mais sobre essa mensagem na seção Mensagens de erro e aviso nesta 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.
|
| Seguindo | Um botão que indica seu status seguindo para o alerta. Saiba mais na seção Alertas seguintes nesta 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 em que é possível realizar outras ações com o alerta. Saiba mais na seção Opções de gerenciamento de alertas nesta página. |
Se um usuário excluir o painel ou o bloco do dashboard em que o alerta está ativado, o alerta será desativado: os seguidores ou destinatários não receberão mais notificações quando as condições do alerta forem atendidas. Nessa página, o nome do painel será excluído imediatamente do alerta. Depois que a consulta de alerta for executada na próxima vez, o status será exibido como Desativado, com uma dica indicando que o painel ou o elemento do painel (bloco) foi excluído. Um administrador poderá excluir permanentemente o alerta no menu de três pontos à direita dele.
Como filtrar alertas
Para filtrar a lista de alertas, use a barra de pesquisa Lista de filtros na parte superior da página.
Você pode filtrar alertas pelos seguintes atributos:
- 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.
- Por hora: retorna todos os alertas com a frequência de Hora, 2 horas, 3 horas, 4 horas, 6 horas, 8 horas ou 12 horas.
- Diária: retorna todos os alertas com uma frequência Diária de qualquer Hora.
- Semanal: retorna todos os alertas com uma frequência Semanal de qualquer Dia ou Hora.
- Mensal: retorna todos os alertas com a frequência Mensal de qualquer Dia ou Hora.
- Condição atendida: indica se as condições de 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 em relação às condições.
- Desativado: o alerta não está mais sendo verificado em relação às condições.
É possível impor vários filtros aos resultados. Para excluir um filtro, clique no x ao lado do nome dele. Atualizar o navegador também vai excluir todos os filtros selecionados.
Como agrupar alertas
Clique no ícone Alertas de grupo para abrir o menu Agrupar por.
Você pode agrupar alertas das seguintes formas:
- Padrão: sem agrupamento
- Nomes dos painéis: em ordem alfabética pelo nome do painel em que o alerta está definido
- Proprietário: em ordem alfabética por proprietário do alerta
Erros e mensagens de alerta
A página de administrador Gerenciar alertas exibe erros ou avisos que aparecem quando a consulta de alerta é executada ou a notificação de alerta é entregue. As mensagens de erro, se aplicáveis, aparecem quando você passa o cursor sobre o ícone de aviso ou de erro na coluna Condição atendida.
Nos alertas configurados para enviar notificações às integrações do Slack ou Anexo do Slack (token de API), a mensagem de erro Notification delivery failed with existing configuration será exibida quando a consulta do alerta determinar que as condições do alerta foram atendidas, mas a notificação não foi entregue. Essa falha pode ocorrer se algo na configuração do Slack tiver mudado desde que o alerta foi criado. Por exemplo, se o espaço de trabalho do Slack onde o alerta estava sendo enviado foi desconectado da instância do Looker, se o canal do Slack onde o alerta estava sendo enviado foi excluído ou se o Looker não conseguiu se conectar às integrações.
Aviso: consultando dados novos
Um ícone de aviso na coluna Condição atendida indica que os dados no bloco do painel em que o alerta se baseia não mudaram nas duas consultas de alerta mais recentes. Passe o cursor sobre esse ícone para exibir a mensagem Aviso de alerta desatualizado e o seguinte texto:
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 o motivo pelo qual os dados não mudam entre as consultas. Se o alerta persistir, fale com seu administrador ou desenvolvedor do Looker para verificar se as políticas de armazenamento em cache definidas neste bloco do dashboard estão alinhadas à configuração de frequência de alertas.
Alertas a seguir
A coluna Seguindo mostra os botões Parar de seguir e Seguir e botões Seguir que não podem ser clicados.
Se você estiver seguindo o alerta, o botão Parar de seguir será exibido ao lado dele. Se você clicar em Parar de seguir, não receberá mais notificações quando esse alerta for acionado. Depois de clicar em Parar de seguir:
- Se você for o proprietário do alerta, verá o botão Seguir nessa coluna.
- Se o alerta não for seu, ele será removido desta página quando você atualizar o navegador.
- Se você tiver sido listado como um destinatário para as notificações de um alerta, mas não tiver seguido o alerta na janela de visualização de alertas, você verá um botão Seguir que não pode ser clicado. Se quiser parar de seguir o alerta, cancele a inscrição diretamente na notificação de alerta.
Você verá o botão Seguir que não pode ser clicado ao lado do alerta se alguma destas condições for verdadeira:
- Você é o proprietário do alerta, mas ele não pode ser seguido.
- Você foi listado como um destinatário de e-mail das notificações de alerta, mas não seguiu o alerta da janela de visualização de alertas. Se quiser parar de seguir o alerta, cancele a inscrição diretamente na notificação de alerta.
- O alerta está configurado para enviar notificações ao Slack.
Opções de gerenciamento de alertas
À direita de cada alerta, há um menu de três pontos com estas opções:
- Visualizar alerta
- Editar alerta
- Desativar alerta (se o alerta estiver ativado no momento)
- Ativar alerta (se o alerta estiver desativado no momento)
Clique em Visualizar alerta para abrir a página Detalhes do alerta.
Clique em Editar alerta para abrir a janela e modificar as configurações. Clique em Salvar alerta para salvar as alterações ou em Cancelar para fechar a janela de alerta sem salvar.
Se um usuário excluir o painel ou o bloco do dashboard em que o alerta está ativado, o alerta será desativado: os seguidores ou destinatários não receberão mais notificações quando as condições do alerta forem atendidas. Nessa página, o proprietário do alerta verá imediatamente que o nome do painel foi excluído do alerta. Na próxima vez que a consulta de alerta for executada, o Status do alerta será exibido como Desativado.
Página "Detalhes do alerta"
A página Detalhes do alerta é um pop-up que mostra um resumo das informações do alerta, que são configuradas pelo proprietário do alerta. Os proprietários e seguidores de alertas têm uma visualização diferente da página.
É possível abrir a página Detalhes do alerta de uma destas maneiras:
- Clique no menu de três pontos à direita do alerta e selecione Ver alerta.
- Clicando no título do alerta
Configurar a página "Detalhes do alerta"
Depois que você cria um alerta, uma entrada para ele aparece na página de administração 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.
Para vincular um painel a um alerta, siga estas etapas:
- Clique na caixa de texto para contextualizar quais condições acionam o alerta ou o que significa que um alerta seja acionado. Clique em Salvar para armazenar a descrição.
- Clique no botão + Link Investigative Dashboard.
Na janela Vincular painel ao alerta, selecione a pasta que contém o painel e clique no nome do painel.
O nome do dashboard vinculado vai aparecer no lugar do botão + Link Investigative Dashboard. Clique no botão para acessar o painel vinculado. Para excluir o painel vinculado, clique no x no nome do painel. O Looker vai pedir que você confirme a exclusão.
Alguns detalhes de alertas são exibidos automaticamente na página Detalhes do alerta e não podem ser configurados:
- Informações sobre o histórico do alerta, anotados na guia Atividade da página
- Visualização de alertas
- 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:
- Clique no menu de três pontos na visualização do alerta e depois em Explorar aqui para abrir uma Análise predefinida com a consulta do bloco do dashboard em que o alerta está definido.
- Clique no botão Testar agora para executar uma consulta de alerta instantâneo. Se o alerta for acionado, uma notificação será enviada para o proprietário, os destinatários e os seguidores.
Clique em Concluído para fechar a página Detalhes do alerta.
Como visualizar a página "Detalhes do alerta"
Será possível ver os Detalhes do alerta de um alerta que não for de sua propriedade se você estiver listado como um destinatário ou se tiver optado por segui-lo. Abra a guia Detalhes na página Detalhes do alerta para ver as informações sobre um alerta configurado pelo proprietário.
Na guia Detalhes da página Detalhes do alerta, é possível realizar as seguintes tarefas:
- Confira o contexto sobre quais condições acionam o alerta ou o que significa para que um alerta seja acionado.
- Clique no painel vinculado para acessar outro painel que pode adicionar contexto à consulta de alerta.
- Confira a visualização do alerta.
- Veja o status da sincronização de alertas.
- Clique no menu de três pontos na visualização do alerta e depois em Explorar aqui para abrir uma Análise predefinida com a consulta do bloco do dashboard em que o alerta está definido.
- Clique no botão Testar agora para executar uma consulta de alerta instantâneo. Se o alerta for acionado, uma notificação será enviada para o proprietário, os destinatários e os seguidores.
- Clique em Concluído para fechar a página Detalhes do alerta.
Como visualizar a atividade de alertas
O Looker executa uma consulta de alerta na frequência especificada para verificar se os dados atenderam ou excederam as condições de alerta. O resultado dessas verificações se torna o histórico do alerta. Você pode clicar na guia Atividade na parte superior da página Detalhes do alerta para ver o histórico, além de outras informações.
Na guia Atividade da página Detalhes do alerta, é possível realizar as seguintes tarefas:
- Confira a frequência com que o alerta é verificado em relação às condições dele.
- Visualizar metadados de alertas.
- Veja o status da sincronização de alertas.
- Clique no botão Testar agora para executar uma consulta de alerta instantâneo. Se o alerta for acionado, uma notificação será enviada para o proprietário, os destinatários e os seguidores.
- Clique em Concluído para fechar a página Detalhes do alerta.
Como visualizar metadados de alertas
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 DD/MM HH:MM05/30 18:25 |
| Tempo de execução | Quanto tempo a consulta de alerta levou para ser executada | Qualquer duração no formato 0.81s
|
| Recente | Um booleano que indica se a consulta de alerta verificou os dados alterados entre as duas consultas de alerta mais recentes. Se os dados mudaram e se os dados não mudaram |
|
| Origem | A origem dos dados a partir dos quais a consulta de alerta verificou o valor condicional |
|
| Horário 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 DD/MM HH:MMExemplo: 05/25 16:01 |
| Condição atendida | Um booleano que indica se as condições de alerta foram atendidas ou não. |
|
| Gatilho | O valor condicional que acionaria o alerta se for atingido 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 |
|
Como visualizar o status da sincronização de alertas
As duas guias da página Detalhes do alerta mostram o status de sincronização do alerta e o nome do painel ao qual o alerta está associado:
- Uma marca de seleção verde e circular indica que o alerta ainda está sincronizado com o painel.
- Um símbolo de aviso triangular amarelo indica que o alerta foi dessincronizado 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 mais informações sobre como resolver um alerta não sincronizado, consulte a página de documentação Efeito de edições do painel em alertas.