A página Gerenciar alertas mostra uma lista de todos os alertas que você possui ou segue, ou dos quais está listado como destinatário, dependendo das permissões de alerta:
| Permissões | Alertas exibidos na página do usuário Gerenciar alertas |
|---|---|
admin |
Os usuários podem ver os alertas que criaram ou seguiram ou para os quais estão listados como destinatários. |
create_alerts |
Os usuários podem ver os alertas criados por eles. |
follow_alerts |
Os usuários podem ver os alertas que seguiram ou para os quais estão listados como destinatários. |
Como acessar a página de gerenciamento de alertas do usuário
Se o administrador do Looker não tiver concedido a você permissões de alertas, não será possível acessar essa página no menu do usuário.
Para acessar a página do usuário Gerenciar alertas, clique na foto do perfil ou no ícone do usuário e escolha Alertas:
A página do usuário Gerenciar alertas fornece informações sobre todos os alertas na instância do Looker. Você pode 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, 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 ele seja acionado. Clique no nome do alerta para abrir a página Detalhes do alerta. |
| Painel | O nome do painel 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 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 | Um Sim ou um 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 -- é exibido se a consulta de alerta ainda não foi executada ou se a consulta de alerta foi executada, mas não foi possível determinar se as condições de alerta foram atendidas. Essa coluna exibe í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 é entregue. 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 foram alterados entre as duas consultas de alerta mais recentes. Leia mais sobre esta mensagem na seção Mensagens de erro e aviso de alerta nesta página. |
| Frequência | A frequência com que o alerta é verificado se as condições foram atendidas ou excedidas. |
| Status | Esta coluna indica se o alerta está ativo ou desativado.
|
| Seguindo | Um botão que indica o status abaixo do alerta. Saiba mais na seção Seguindo alertas nesta página. |
| Atividade | Um link que direciona para a guia Atividade do alerta na página Detalhes do alerta. |
| Menu de três pontos | Um menu que permite realizar outras ações no alerta. Saiba mais na seção Opções de gerenciamento de alertas nesta página. |
Se um usuário excluir o painel ou bloco do painel em que o alerta está, esse alerta será desativado: os seguidores ou destinatários não receberão mais notificações quando as condições do alerta forem atendidas. Nesta página, o nome do painel de controle será excluído imediatamente. Na próxima vez que a consulta de alerta for executada, o status vai aparecer como Disabled (Desativado) indicando que o painel ou o elemento do painel (tile) foi excluído. Um administrador pode excluir permanentemente o alerta do menu de três pontos à direita dele.
Filtrar alertas
Para filtrar a lista de alertas, clique no ícone de filtro na parte de cima da lista de alertas:
Você pode filtrar alertas por:
- Frequência: a frequência em que o alerta é verificado 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 uma frequência de Hour, 2 hours, 3 hours, 4 hours, 6 hours, 8 hours ou 12 hours.
- Diariamente: retorna todos os alertas com uma frequência diária de qualquer Time.
- Semanal: retorna todos os alertas com uma frequência Semanal de Dia ou Horário.
- Mensal: retorna todos os alertas com uma frequência mensal de qualquer dia ou horário.
- 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 nem 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 nas condições.
É possível impor vários filtros aos resultados. Para excluir um filtro, clique no x ao lado do nome dele. A atualização do navegador também vai excluir todos os filtros selecionados.
Agrupar alertas
Clique no ícone Agrupar alertas para abrir o menu Agrupar por.
Você pode agrupar alertas das seguintes maneiras:
- Padrão: sem agrupamento
- Nomes dos painéis: organizados em ordem alfabética pelo nome do painel em que o alerta é definido
- Proprietário: em ordem alfabética pelo proprietário do alerta
Mensagens de aviso e de erro
A página do usuário Gerenciar alertas exibe todos os erros ou avisos que aparecem quando a consulta de alerta é executada ou a notificação de alerta é entregue. Se aplicável, as mensagens de erro serão exibidas quando você passar o cursor sobre o ícone de aviso ou de erro na coluna Condição atendida:
Para alertas configurados para entregar notificações às integrações do Slack ou de anexos 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 de 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 no qual o alerta estava sendo enviado tiver sido desconectado da instância do Looker, se o canal do Slack em que o alerta estava sendo excluído tiver sido 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 se baseia não mudaram entre as duas consultas de alerta mais recentes. Passe o cursor sobre esse ícone para exibir a mensagem Alerta de alerta desatualizado e o 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.
Existem algumas explicações possíveis para os dados não mudarem entre as consultas. Se o aviso persistir, fale com seu administrador ou desenvolvedor do Looker para confirmar se as políticas de armazenamento em cache definidas para este bloco do painel estão alinhadas com a configuração de frequência de alerta.
Alertas seguintes
A coluna Seguindo mostra os botões clicáveis Parar de seguir e Seguir e os botões Seguir clicáveis.
Se você estiver seguindo o alerta, verá um botão Parar de seguir ao lado dele. Se você clicar em Parar de seguir, deixará de receber notificações quando esse alerta for acionado. Depois de clicar em Parar de seguir:
- Se o alerta for seu, você vai ver um botão Seguir nessa coluna.
- Se o alerta não for seu, ele vai ser removido desta página quando o navegador for atualizado.
- Se você estiver listado como destinatário das notificações de um alerta, mas não tiver seguido o alerta na janela de visualização de alerta, o botão Seguir não será clicável. Para deixar de seguir o alerta, cancele sua inscrição diretamente na notificação de alerta.
Você verá um botão Seguir não clicável ao lado do alerta se uma destas condições for verdadeira:
- O alerta pertence a você, mas não é possível segui-lo.
- Você foi listado como um destinatário por e-mail para as notificações de alerta, mas não seguiu o alerta da janela de visualização de alerta. Para deixar de seguir o alerta, cancele sua inscrição diretamente na notificação de alerta.
- O alerta é 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:
- Ver alerta
- Editar alerta
- Desativar alerta (se o alerta estiver ativado)
- Ativar alerta (se o alerta estiver desativado)
Clique em Ver alerta para abrir a página Detalhes do alerta.
Clique em Editar alerta para abrir a janela de alertas em que é possível modificar as configurações. Clique em Salvar alerta para salvar as alterações ou em Cancelar para fechar a janela do alerta sem salvar.
Se um usuário excluir o painel ou bloco do painel em que o alerta está, esse 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 para o 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 é configurada pelo proprietário. Os proprietários de alertas e os seguidores veem uma visualização diferente desta 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.
- Clique no título do alerta
Como configurar a página "Detalhes do alerta"
Depois que você criar um alerta, uma entrada para esse alerta vai aparecer 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:
- Clique na caixa de texto para adicionar contexto sobre as condições que acionam o alerta ou o que ele significa. Clique em Salvar para armazenar a descrição.
- Clique no botão + Vincular painel de investigação para abrir uma nova janela em que você pode conectar outro painel a este alerta:
Na janela Vincular painel a alertas, selecione a pasta que contém o painel e clique no nome do painel. O nome do painel vinculado aparecerá no lugar do botão + Vincular painel de investigação. Clique no botão para acessar o painel vinculado. Para excluir o painel vinculado, clique no x no nome do painel. O Looker solicitará que você confirme a exclusão do link.
Alguns detalhes do alerta são exibidos automaticamente na página Detalhes do alerta e não podem ser configurados:
- Informações sobre o histórico do alerta, indicadas na guia Atividade da página.
- Visualização de alertas
- O status da sincronização do painel e o nome do painel ao qual o alerta está associado
Outras maneiras de interagir com um alerta seu:
- Clique no menu de três pontos na visualização de alerta e em Explorar aqui para abrir uma opção predefinida com a consulta do bloco do painel 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, destinatários e seguidores.
Clique em Concluído para fechar a página Detalhes do alerta.
Como ver a página "Detalhes do alerta"
Para ver um alerta que não é seu, você pode ver os Detalhes do alerta se estiver listado como um destinatário ou se tiver escolhido seguir o alerta. Abra a guia Detalhes na página Detalhes dos alertas para ver as informações sobre um alerta que o proprietário configurou:
- Veja o contexto das condições que acionam o alerta ou o que ele significa.
- Clique no painel vinculado para acessar outro painel que talvez inclua contexto à consulta de alerta.
- Veja o alerta.
- Veja o status de sincronização de alertas.
- Clique no menu de três pontos na visualização de alerta e em Explorar aqui para abrir uma opção predefinida com a consulta do bloco do painel 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, destinatários e seguidores.
- Clique em Concluído para fechar a página Detalhes do alerta.
Como ver 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. Os resultados dessas verificações se tornam o histórico do alerta. Clique na guia Atividade na parte superior da página Detalhes do alerta para ver o histórico do alerta e mais informações:
- Veja a frequência com que o alerta é verificado em relação às condições.
- Ver metadados do alerta.
- Veja o status de 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, destinatários e seguidores.
- Clique em Concluído para fechar a página Detalhes do alerta.
Como ver 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 6/25/2021, 10:45:21 AM
|
| Tempo de execução | Quanto tempo a consulta de alerta levou para ser executada | Qualquer duração no formato 0.81s
|
| Novidades | Um booleano que indica se a consulta de alerta verificou dados que foram alterados entre as duas consultas de alerta mais recentes. Se os dados foram alterados, ou se eles não foram alterados |
|
| Origem | A origem dos dados usados na consulta de alerta para verificar o valor condicional |
|
| Horário de 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 |
| Atendido | Um booleano que indica se as condições de alerta foram atendidas ou não |
|
| Gatilho | O valor condicional que aciona o alerta se for atingido ou excedido | Qualquer valor numérico |
| Observado | O valor observado que atendeu ou excedeu as condições do alerta e acionou o alerta | Qualquer valor numérico |
| Status | O status da consulta de alerta |
|
Como ver o status da sincronização de alertas
As duas guias na página Detalhes do alerta mostram o status da sincronização do alerta e o nome do painel ao qual ele está associado:
- Uma marca de seleção circulada em verde indica que o alerta ainda está sincronizado com o painel.
- Um símbolo de aviso triangular amarelo indica que a sincronização do alerta com o painel foi cancelada. O status inclui um carimbo de data/hora de quando a sincronização foi interrompida. Um alerta não sincronizado exibe um valor None na coluna Dashboard. 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.