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 necessário: Administrador
Visão Geral
Os 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 em 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 os 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 os avisos são encontrados
Pré-requisitos
Antes de começar, certifique-se de que os seguintes plugins estejam ativados em seu site:
- Data Explorer - Disponível em planos hospedados Business e Enterprise, ou pode ser instalado em instâncias auto-hospedadas
- Discourse Automation - Incluído no core 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/explorerem seu site Discourse - Clique em Add para criar uma nova consulta
- Nomeie sua consulta como “Admin Notices Count - Last 24 Hours”
- Adicione a seguinte consulta SQL:
SELECT 'There are new admin notices on dashboard.' 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 Save para salvar a consulta
- Teste a consulta clicando em Run 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 Add automation
- Para Script, selecione Schedule a PM with Data Explorer results
- Insira um nome como “Alert on New Admin Notices”
- Para Trigger, selecione Recurring
Configurar o gatilho
Na seção de gatilho:
- Defina Recurrence para executar de acordo com sua programação preferida (por exemplo, “Every 24 hours”)
- Ative Start date e escolha quando você deseja que o monitoramento comece
Configurar o script
Na seção Script, configure os seguintes campos:
Send to User, Group or Email: Insira o nome do seu grupo de administradores (geralmente admins)
Query: Selecione “Admin Notices Count - Last 24 Hours” (a consulta que você criou anteriormente)
Skip if no results: Ative esta opção para evitar o envio de PMs quando a contagem for 0
Agora clique no botão “Update automation”.
Habilitar a automação
Após configurar todas as configurações:
- Revise sua configuração
- Clique no alternador Enable automation na parte superior da página para ativar a automação
- Opcionalmente, clique em Trigger now para testar a automação imediatamente
Como funciona
Uma vez ativada, o sistema opera da seguinte forma:
- A cada 24 horas (ou o 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 PM é enviado ao grupo de administradores com a contagem de avisos
- Se nenhum novo aviso for encontrado, nenhum PM é enviado (devido à configuração “Skip if no results”)
Isso garante que sua equipe de administração receba notificações oportunas sobre novos avisos de administrador sem ser sobrecarregada por mensagens desnecessárias.
Solução de problemas
Automação não está sendo executada
- Verifique se a automação está habilitada - verifique o alternador na parte superior da página de automação
- Verifique
/logsem busca de quaisquer mensagens de erro relacionadas à automação - Certifique-se de que o próprio plugin Automation esteja habilitado em
/admin/plugins
Não recebendo PMs
- Verifique se o nome do grupo está correto no campo “Send to”
- Verifique se o grupo de administradores tem permissão para receber PMs
- Revise suas configurações pessoais de notificação para garantir que você receba notificações por e-mail para PMs
Consulta não retorna resultados quando existem avisos
- Teste a consulta manualmente no Data Explorer
- Verifique se o parâmetro de intervalo de tempo corresponde à frequência da sua automação
- Verifique se os avisos de administrador realmente existem visitando
/admin/dashboard/problems