Configuration des alertes de notification d'administrateur automatisées

[meghna (Meghna Jalan)]

Ce guide vous montre comment configurer un système de surveillance automatisé qui envoie des messages privés à votre groupe d’administration lorsque de nouvelles notices d’administration sont détectées sur votre site Discourse.

Niveau d’utilisateur requis : Administrateur

Aperçu

Les notices d’administration alertent les administrateurs des problèmes importants du site, tels que les mises à jour de plugins, les problèmes de compatibilité de thèmes ou les préoccupations de sécurité. Ce guide vous aide à configurer un système automatisé pour notifier de manière proactive votre équipe d’administration chaque fois que de nouvelles notices d’administration apparaissent sur votre site, garantissant ainsi que vous ne manquerez jamais de mises à jour critiques.

Le système de surveillance se compose de deux éléments clés :

• Une requête Data Explorer qui compte les nouvelles notices d’administration créées au cours des dernières 24 heures
• Une Automatisation Discourse qui exécute la requête périodiquement et envoie un message privé à votre groupe d’administration lorsque des notices sont trouvées

Prérequis

Avant de commencer, assurez-vous que les plugins suivants sont activés sur votre site :

• Data Explorer - Disponible sur les plans hébergés Business et Enterprise, ou peut être installé sur des instances auto-hébergées
• Automatisation Discourse - Inclus avec le cœur de Discourse (aucune installation séparée requise)

Hébergé par Discourse ?

Les plugins Automations et Data Explorer sont disponibles à partir du forfait Business et supérieur.

Créer la requête Data Explorer

La première étape consiste à créer une requête qui identifie les nouvelles notices d’administration.

1. Accédez à /admin/plugins/discourse-data-explorer sur votre site Discourse
2. Cliquez sur Add (Ajouter) pour créer une nouvelle requête
3. Nommez votre requête « Admin Notices Count - Last 24 Hours » (Nombre de notices d’administration - Dernières 24 heures)
4. Ajoutez la requête SQL suivante :

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

Cette requête compte les notices d’administration créées au cours des dernières 24 heures.

5. Cliquez sur Save (Enregistrer) pour stocker la requête
6. Testez la requête en cliquant sur Run (Exécuter) pour vous assurer qu’elle renvoie correctement les résultats

Configurer l’automatisation

Ensuite, vous allez configurer une automatisation qui exécute cette requête périodiquement et envoie des notifications.

Créer l’automatisation

1. Accédez à /admin/plugins/automation/
2. Cliquez sur Add automation (Ajouter une automatisation)
3. Pour Script, sélectionnez Schedule a PM with Data Explorer results (Planifier un MP avec les résultats de Data Explorer)
4. Entrez un nom comme « Alert on New Admin Notices » (Alerte sur les nouvelles notices d’administration)
5. Pour Trigger (Déclencheur), sélectionnez Recurring (Récurent)

Configurer le déclencheur

Dans la section Déclencheur :

1. Définissez Recurrence pour qu’elle s’exécute selon votre calendrier préféré (par exemple, « Every 24 hours » (Toutes les 24 heures))
2. Activez Start date (Date de début) et choisissez quand vous souhaitez que la surveillance commence

Configurer le script

Dans la section Script, configurez les champs suivants :

Send to User, Group or Email (Envoyer à l’utilisateur, au groupe ou à l’e-mail) : Entrez le nom de votre groupe d’administration (généralement admins)

Data Explorer Query (Requête Data Explorer) : Sélectionnez « Admin Notices Count - Last 24 Hours » (le nom de la requête que vous avez créée précédemment)

Skip sending PM if there are no results (Ignorer l’envoi de MP s’il n’y a pas de résultats) : Activez cette option pour éviter d’envoyer des MP lorsque le compte est de 0

Cliquez maintenant sur le bouton « Update automation » (Mettre à jour l’automatisation).

Activer l’automatisation

Après avoir configuré tous les paramètres :

1. Examinez votre configuration
2. Cliquez sur le bascule Enable automation (Activer l’automatisation) en haut de la page pour activer l’automatisation
3. Optionnellement, cliquez sur Trigger now (Déclencher maintenant) pour tester l’automatisation immédiatement

Comment cela fonctionne

Une fois activé, le système fonctionne comme suit :

1. Toutes les 24 heures (ou l’intervalle configuré), l’automatisation se déclenche automatiquement
2. La requête Data Explorer s’exécute et compte les notices d’administration créées au cours des dernières 24 heures
3. Si le compte est supérieur à 0, un MP est envoyé au groupe d’administration avec le nombre de notices
4. Si aucune nouvelle notice n’est trouvée, aucun MP n’est envoyé (en raison du paramètre « Skip sending PM if there are no results »)

Cela garantit que votre équipe d’administration reçoit des notifications opportunes concernant les nouvelles notices d’administration sans être submergée par des messages inutiles.

Dépannage

L’automatisation ne s’exécute pas

• Vérifiez que l’automatisation est activée - vérifiez la bascule en haut de la page de l’automatisation
• Consultez /logs pour tout message d’erreur lié à l’automatisation
• Assurez-vous que le plugin Automation lui-même est activé sur /admin/plugins

Vous ne recevez pas de MP

• Vérifiez que le nom du groupe est correct dans le champ « Send to » (Envoyer à)
• Vérifiez que le groupe d’administration a l’autorisation de recevoir des MP
• Consultez vos paramètres de notification personnels pour vous assurer que vous recevez des notifications par e-mail pour les MP

La requête ne renvoie aucun résultat alors que des notices existent

• Testez la requête manuellement dans Data Explorer
• Vérifiez que le paramètre d’intervalle de temps correspond à votre fréquence d’automatisation
• Vérifiez qu’il existe réellement des notices d’administration en visitant /admin

Ressources supplémentaires

• Discourse Automation
• Discourse Data Explorer