Este guia mostra como configurar um sistema de monitoramento automatizado que envia mensagens privadas para o seu grupo de administradores quando novos avisos de administrador são detectados no seu site Discourse.
Nível de usuário exigido: Administrador
Visão Geral
Avisos de administrador alertam os administradores sobre problemas importantes do site, como atualizações de plugins, problemas de compatibilidade de temas ou preocupações de segurança. Este guia ajuda você a configurar um sistema automatizado para notificar proativamente sua equipe de administração sempre que novos avisos de administrador aparecerem no seu site, garantindo que você nunca perca atualizações críticas.
O sistema de monitoramento consiste em dois componentes principais:
- Uma consulta do Data Explorer que conta novos avisos de administrador criados nas últimas 24 horas
- Uma Automação do Discourse que executa a consulta periodicamente e envia uma mensagem privada para o seu grupo de administradores quando avisos são encontrados
Pré-requisitos
Antes de começar, certifique-se de que os seguintes plugins estão habilitados no seu site:
- Data Explorer - Disponível nos planos Business e Enterprise hospedados, ou pode ser instalado em instâncias auto-hospedadas
- Discourse Automation - Incluído no núcleo do Discourse (nenhuma instalação separada é necessária)
Hospedado pelo Discourse?
Os plugins Automations e Data Explorer estão disponíveis a partir do plano Business e superiores.
Hospedado pelo Discourse?Criar a consulta do Data Explorer
O primeiro passo é criar uma consulta que identifique novos avisos de administrador.
- Navegue até
/admin/plugins/discourse-data-explorerno seu site Discourse - Clique em Adicionar para criar uma nova consulta
- Nomeie sua consulta como “Contagem de Avisos de Administrador - Últimas 24 Horas”
- Adicione a seguinte consulta SQL:
SELECT 'Há novos avisos de administrador no painel.' AS message, id, created_at
FROM admin_notices
WHERE created_at >= CURRENT_TIMESTAMP - INTERVAL '24 hours'
ORDER BY created_at DESC
Esta consulta conta os avisos de administrador criados nas últimas 24 horas.
- Clique em Salvar para armazenar a consulta
- Teste a consulta clicando em Executar para garantir que ela retorne os resultados corretamente
Configurar a automação
Em seguida, você configurará uma automação que executa esta consulta periodicamente e envia notificações.
Criar a automação
- Navegue até
/admin/plugins/automation/ - Clique em Adicionar automação
- Para Script, selecione Agendar um MP com resultados do Data Explorer
- Insira um nome como “Alerta sobre Novos Avisos de Administrador”
- Para Gatilho, selecione Recorrente
Configurar o gatilho
Na seção de gatilho:
- Defina Recorrência para executar de acordo com sua programação preferida (por exemplo, “A cada 24 horas”)
- Habilite Data de início e escolha quando você deseja que o monitoramento comece
Configurar o script
Na seção Script, configure os seguintes campos:
Enviar para Usuário, Grupo ou E-mail: Insira o nome do seu grupo de administradores (geralmente admins)
Consulta do Data Explorer: Selecione “Contagem de Avisos de Administrador - Últimas 24 Horas” (a consulta que você criou anteriormente)
Ignorar envio de MP se não houver resultados: Habilite esta opção para evitar o envio de MPs quando a contagem for 0
Agora clique no botão “Atualizar automação”.
Habilitar a automação
Após configurar todas as configurações:
- Revise sua configuração
- Clique no alternador Habilitar automação no topo da página para ativar a automação
- Opcionalmente, clique em Acionar agora para testar a automação imediatamente
Como funciona
Uma vez habilitado, o sistema opera da seguinte forma:
- A cada 24 horas (ou no seu intervalo configurado), a automação é acionada automaticamente
- A consulta do Data Explorer é executada e conta os avisos de administrador criados nas últimas 24 horas
- Se a contagem for maior que 0, um MP é enviado para o grupo de administradores com a contagem de avisos
- Se nenhum novo aviso for encontrado, nenhum MP é enviado (devido à configuração “Ignorar envio de MP se não houver resultados”)
Isso garante que sua equipe de administração receba notificações oportunas sobre novos avisos de administrador sem ser sobrecarregada com mensagens desnecessárias.
Solução de problemas
Automação não está sendo executada
- Verifique se a automação está habilitada - verifique o alternador no topo da página da automação
- Verifique
/logsem busca de quaisquer mensagens de erro relacionadas à automação - Verifique se o próprio plugin Automation está habilitado em
/admin/plugins
Não recebendo MPs
- Verifique se o nome do grupo está correto no campo “Enviar para”
- Verifique se o grupo de administradores tem permissão para receber MPs
- Revise suas configurações de notificação pessoal para garantir que você receba notificações por e-mail para MPs
Consulta não retorna resultados quando avisos existem
- Teste a consulta manualmente no Data Explorer
- Verifique se o parâmetro de intervalo de tempo corresponde à sua frequência de automação
- Verifique se realmente existem avisos de administrador visitando
/admin