A página de usuário Gerenciar alertas mostra uma lista de todos os alertas que você possui ou segue, ou para os quais está listado como destinatário, dependendo das suas permissões de alerta:
| Permissões | Alertas exibidos na página de usuário Gerenciar alertas |
|---|---|
admin |
Os usuários podem ver os alertas que criaram ou seguiram ou que estão listados como destinatários. |
create_alerts |
Os usuários podem ver os alertas que criaram. |
follow_alerts |
Os usuários podem ver os alertas que seguiram ou dos quais estão listados como destinatários. |
Acessando a página de usuário Gerenciar alertas
Para navegar até a página do usuário Gerenciar alertas, selecione o menu Perfil e depois Alertas.
A página do usuário Gerenciar alertas apresenta informações sobre todos os alertas na instância do Looker. Para alertas que pertencem a você, estão seguindo ou dos quais você está listado como destinatário, é possível visualizar essas 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 padrão do alerta 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 dele. |
| 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 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 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 de alerta foram atendidas. Essa coluna exibe ícones de aviso ou de erro relacionados a avisos ou erros que surgem 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 aviso 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 esta mensagem na seção Mensagens de aviso e erro de alerta 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 no momento.
|
| Seguindo | Um botão que indica o status seguindo do alerta. Saiba mais na seção Alertas seguintes 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 no qual você pode realizar outras ações no alerta. Saiba mais na seção Opções de gerenciamento de alertas desta página. |
Se um usuário excluir o painel ou bloco do painel em que o alerta está ativado, esse alerta será desativado: todos os seguidores ou destinatários não receberão mais notificações quando as condições de alerta forem atendidas. Nessa página, o nome do painel será excluído imediatamente para o alerta. Após a próxima execução da consulta de alerta, o status será Desativado com uma dica indicando que o painel ou elemento (bloco) do painel foi excluído. Depois disso, um administrador poderá 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 superior da lista de alertas.
É possível filtrar alertas por:
- Frequência: a frequência em 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 uma 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 Horário.
- Semanal: retorna todos os alertas com uma frequência Semanal de qualquer 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 atingidas 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.
Você pode impor vários filtros aos resultados. Para excluir um filtro, selecione o x ao lado do nome dele. A atualização do navegador também vai excluir todos os filtros selecionados.
Alertas de agrupamento
Clique no ícone Agrupar alertas para abrir o menu Agrupar por.
É possível agrupar alertas das seguintes maneiras:
- 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 pelo proprietário do alerta.
Erros de alerta e mensagens de aviso
A página do usuário Gerenciar alertas exibe os erros ou avisos que são exibidos quando a consulta de alerta é executada ou a notificação de alerta é entregue. 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 entregar notificações para integrações do Slack ou 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 de alerta foram atendidas, mas a notificação não pôde ser entregue. Essa falha pode ocorrer se algo na configuração do Slack mudou desde a criação do alerta. Por exemplo, se o espaço de trabalho do Slack em que o alerta estava sendo enviado foi desconectado da instância do Looker, se o canal do Slack em que o alerta estava sendo entregue foi excluído ou se o Looker não consegue se conectar às integrações.
Aviso: consulta de 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 entre as duas consultas de alerta mais recentes. Passar o cursor sobre esse ícone mostra a mensagem Aviso de alerta desatualizado e este 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 por que os dados não mudaram 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 este bloco do painel estão alinhadas com a configuração de frequência de alertas.
Alertas a seguir
A coluna Seguindo mostra os botões clicáveis Parar de seguir e Seguir e Seguir não clicáveis.
Se você estiver seguindo o alerta, o botão Parar de seguir vai aparecer ao lado dele. Se você selecionar Parar de seguir, não vai mais receber notificações quando esse alerta for acionado. Depois de selecionar Parar de seguir, você verá resultados diferentes, dependendo da sua relação com o alerta (proprietário, destinatário ou nenhum dos dois):
- Se o alerta for seu, o botão Seguir vai aparecer nessa coluna.
- Se você não for o proprietário do alerta, ele será removido desta página quando você atualizar o navegador.
- Se você estava listado como destinatário das notificações de um alerta, mas não seguiu o alerta na janela de visualização, o botão Seguir não é clicável. Para deixar de seguir um alerta, cancele a inscrição diretamente na notificação de alerta.
O botão Seguir não clicável será exibido ao lado do alerta se alguma destas condições for verdadeira:
- O alerta é seu, 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 alerta. Para deixar de seguir um 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 as seguintes opções:
- Ver alerta
- Editar alerta
- Desativar alerta se o alerta estiver ativado
- Ativar alerta (se o alerta estiver desativado no momento)
Selecione Visualizar alerta para abrir a página Detalhes do alerta.
Selecione Editar alerta para abrir a janela de alerta, onde é possível modificar as configurações do alerta. Selecione Salvar alerta para salvar as alterações ou Cancelar para fechar a janela de alerta sem salvar.
Se um usuário excluir o painel ou bloco do painel em que o alerta está ativado, esse alerta será desativado: todos os seguidores ou destinatários não receberão mais notificações quando as condições de alerta forem atendidas. Nessa página, o proprietário do alerta verá imediatamente que o nome do painel foi excluído para o alerta. Após a próxima execução da consulta de alerta, o Status do alerta vai aparecer 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. Proprietários e seguidores do alerta têm uma visualização diferente desta página.
É possível abrir a página Detalhes do alerta de uma das seguintes maneiras:
- Clique no menu de três pontos à direita do alerta e selecione Ver alerta.
- Clicando no título do alerta
Como configurar a página "Detalhes do alerta"
Depois que você criar um alerta, uma entrada para ele será exibida 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:
- Selecione dentro da caixa de texto para adicionar contexto sobre as condições que acionam seu alerta ou o que significa para um alerta ser acionado. Selecione Salvar para salvar a descrição.
- Selecione o botão + Vincular painel investigativo para abrir uma nova janela e conectar outro painel a esse alerta.
Na janela Vincular painel ao alerta, selecione a pasta que contém o painel e escolha o nome dele. O nome do painel vinculado 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 de 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 (anotados na guia Atividade da página)
- A visualização de alertas
- O status da sincronização e o nome do painel a que o alerta está associado
Outras maneiras de interagir com seus próprios alertas incluem:
- Selecione o menu de três pontos na visualização de alerta e depois Explorar a partir daqui para abrir uma Análise predefinida com a consulta do bloco do dashboard em que o alerta está 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 para o proprietário, os destinatários e os seguidores.
Selecione Concluído para fechar a página Detalhes do alerta.
Como visualizar a página "Detalhes do alerta"
Você poderá ver os Detalhes do alerta de um alerta que não seja de sua propriedade se estiver listado como destinatário ou se tiver optado por seguir o alerta. Abra a guia Detalhes na página Detalhes dos alertas para conferir as informações sobre um alerta configurado pelo proprietário:
- Veja o contexto sobre quais condições acionam seu alerta ou o que significa um alerta ser acionado.
- Selecione o painel vinculado para acessar outro painel que pode adicionar contexto à consulta do alerta.
- Acesse a visualização do alerta.
- Veja o status da sincronização de alertas.
- Selecione o menu de três pontos na visualização de alerta e depois Explorar a partir daqui para abrir uma Análise predefinida com a consulta do bloco do dashboard em que o alerta está 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 para o proprietário, os destinatários e os seguidores.
- Para fechar a página Detalhes do alerta, selecione Concluído.
Como visualizar atividades de 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. Na parte superior da página Detalhes do alerta, selecione a guia Atividade para visualizar o histórico do alerta, bem como outras informações:
- Veja com que frequência o alerta é verificado em relação às condições dele.
- Ver metadados de alertas.
- Veja o status da sincronização de alertas.
- Selecione o 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.
- Selecione 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 alerta executado.
| Título | Definição | Valores possíveis |
|---|---|---|
| Executou 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 levou para executar a consulta de alerta | Qualquer duração no formato 0.81s
|
| Novidade | Um booleano que indica se a consulta de alerta verificou os dados que foram alterados entre as duas consultas de alerta mais recentes. Se os dados mudaram; 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 de origem | O carimbo de data/hora da linha do banco de dados a partir da qual 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. |
|
| Gatilho | O valor condicional que acionaria o alerta se for atingido ou excedido | Qualquer valor numérico |
| Observado | O valor observado que atendeu ou ultrapassou as condições de alerta e acionou o alerta. | Qualquer valor numérico |
| Status | O status da consulta do alerta |
|
Como visualizar 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 a que ele está associado:
- Uma marca de seleção circundada na cor verde indica que o alerta ainda está sincronizado com o dashboard.
- 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 informações sobre como resolver alertas não sincronizados, consulte a página de documentação Efeito das edições do painel nos alertas.