Notifications du projet
redirection.io propose un centre de notifications, qui peut aider vos collaborateurs à être informés de tout événement survenant dans votre projet :
- un crawl de site web est démarré ou terminé ;
- un nom de domaine est ajouté ou supprimé du projet, ou sa configuration DNS devient valide ou invalide ;
- une nouvelle instance est détectée (ou passe au statut "disparue") dans le projet ;
- un nouveau jeu de règles est publié ;
- une anomalie de trafic se produit ;
- un import de règles est terminé ;
- le certificat SSL pour l'un des domaines du projet a été renouvelé ou n'a pas pu l'être.
Configuration des canaux de notification
Les notifications peuvent être envoyées via plusieurs canaux de notification :
- une adresse e-mail ;
- un canal Slack ;
- une URL de webhook.
Les types de canaux de notification Slack et webhook sont uniquement disponibles dans les projets du plan "Pro".
Canal de notification par e-mail
L'utilisation d'un canal de notification par e-mail peut être utile, par exemple, pour partager la survenue d'événements avec une liste de diffusion d'entreprise.
Canal de notification Slack
Le canal Slack affichera un message joliment formaté dans le canal de votre choix au sein de votre espace de travail Slack d'entreprise.
Canal de notification Webhook
Le canal Webhook peut être utilisé pour permettre une certaine automatisation. Par exemple, vous voudrez peut-être vider un proxy inverse de mise en cache lorsqu'un nouvel ensemble de règles est publié. Ou, vous pourriez vouloir consigner tous les imports de règles dans un tableau de bord de journalisation personnalisé.
Lorsque vous utilisez le canal webhook, les notifications sont envoyées sous forme de requêtes HTTP POST à l'URL du webhook spécifiée, et sont accompagnées d'une charge utile au format JSON qui contient des informations utiles sur l'événement. N'hésitez pas à tester ces hooks pour découvrir le format de la charge utile - elle ne contient que des champs d'information très compréhensibles.
Par exemple, une charge utile de publication de règles ressemble à ceci :
{
"successful": true,
"status": "published",
"level": "info",
"channelId": "69d248d4-40ea-44ae-8686-ebebe2a12b65",
"context": {
"url": "https:\/\/redirection.io\/manager\/acme-inc\/example-com\/versions\/2cc1c743-83bf-4b41-aa09-900944fe6337",
"projectName": "example.com"
},
"rulesCount": 22718,
"added": 387,
"updated": 0,
"deleted": 22,
"summary": "Added new redirects for the june archived products",
"authorName": "John Doe"
}
Ajout d'un nouveau canal de notification
La création d'un canal de notification ne prend que quelques étapes :
- Cliquez sur le bouton "Ajouter un canal de notification"
- Configurez les propriétés du canal. Chaque canal doit avoir un nom, que vous pourrez utiliser ultérieurement pour vous aider à identifier le canal lors de la configuration des notifications d'événements.
Bien entendu, vous pouvez créer plusieurs canaux du même type, si vous avez besoin de notifier différents groupes de personnes. Par exemple, vous pouvez créer un canal de notification de type "e-mail" qui envoie des e-mails à "tech@example.com" et un autre canal de notification "e-mail" qui envoie des e-mails à "marketing@example.com".
Ajout d'une notification d'événement
Une fois qu'au moins un canal de notification a été configuré, vous pouvez ajouter une notification d'événement à votre projet. Cette notification sera envoyée chaque fois que l'événement se produira.
- Cliquez sur le bouton "Ajouter une notification d'événement"
- Choisissez le type d'événement
- Configurez l'événement
- Choisissez le ou les canaux de notification vers lesquels cette notification doit être envoyée
- Activez ou désactivez la notification. Si la notification est désactivée, elle ne sera tout simplement pas exécutée.
Vous souhaitez plus d'événements ou de canaux de notification ? N'hésitez pas à nous le faire savoir !
Types de notifications pris en charge
redirection.io prend en charge les notifications pour de nombreux types d'événements, ce qui peut être utile pour surveiller le cycle de vie de votre projet et être informé de tout dysfonctionnement sur votre site web.
Notifications du crawler
Ce type de notification est uniquement disponible dans les projets du plan "Pro".
Les notifications du crawler sont envoyées chaque fois qu'un événement lié à un crawl se produit :
- lorsqu'un crawl commence ;
- lorsqu'un crawl s'est arrêté avec un état d'échec (le site web n'était pas joignable, il y a eu de nombreuses erreurs, etc.) ;
- lorsque le crawl s'est terminé avec succès.
Notifications d'instances managées
Ce type de notification est disponible dans tous les plans, même le plan gratuit.
Les instances managées sont un moyen très rapide et pratique de déployer redirection.io sur votre site web. Cependant, tout comme tout autre composant d'infrastructure, leur configuration est sensible, et un petit changement dans les paramètres DNS de votre nom de domaine pourrait empêcher les instances gérées de fonctionner comme prévu.
C'est la raison pour laquelle redirection.io propose le type de notification "Instances managées". Cela couvre plusieurs événements associés aux instances managées :
- une nouvelle instance managée est créée dans le projet : une notification sera envoyée chaque fois qu'un nouveau domaine est configuré dans le projet.
- une instance managée est supprimée dans le projet : une notification sera envoyée chaque fois qu'un domaine est supprimé du projet.
- la configuration DNS devient invalide : une notification sera envoyée lorsque nous détectons que la configuration DNS d'un domaine a changé d'une manière qui pourrait empêcher le trafic d'être correctement acheminé via redirection.io, ou le certificat SSL de se renouveler correctement.
- la configuration DNS devient valide : une notification sera envoyée lorsque nous détectons que la configuration DNS d'un domaine est devenue valide.
- le renouvellement du certificat SSL a échoué : une notification sera envoyée lorsque le renouvellement SSL d'un domaine n'a pas pu être effectué. Cela ne nécessite pas nécessairement une action de votre part (nous renouvelons les certificats SSL 3 semaines avant leur expiration) mais vous pouvez toujours vérifier que les paramètres DNS sont corrects. Si cette notification se produit plusieurs jours de suite, veuillez nous contacter afin que nous puissions résoudre le problème.
- le renouvellement du certificat SSL s'est terminé avec succès : une notification sera envoyée lorsqu'un certificat SSL a été généré ou renouvelé avec succès.
Notifications d'instances
Ce type de notification est uniquement disponible dans les projets du plan "Pro".
Tout comme les notifications d'instances gérées ci-dessus, le type de notification "Instances" est destiné à vous aider à surveiller de près l'agent redirection.io installé sur votre infrastructure.
- une nouvelle instance est détectée dans le projet : une notification sera envoyée lorsqu'une nouvelle instance est détectée dans le projet, c'est-à-dire si c'est la première fois que cette instance demande les règles ou envoie des journaux.
- une instance passe au statut "disparue" : une notification sera envoyée chaque fois qu'une instance passe au statut "disparue".
Veuillez noter que le type de notification "Instances" ne rapportera pas les événements concernant les instances gérées. Si c'est ce que vous souhaitez, vous devez également créer un type de notification "instance gérée".
Notification d'anomalie de trafic
Ce type de notification est uniquement disponible dans les projets du plan "Pro".
Le type de notification "Anomalie de trafic" est très puissant et aide à surveiller le trafic qui se produit sur le site web. Ce type de notification peut être configuré de nombreuses manières pour surveiller les erreurs HTTP, les baisses de trafic sur l'ensemble du trafic ou seulement sous certaines conditions.
Vous pouvez configurer une notification "Anomalie de trafic" en choisissant une Vue de journal à surveiller, et en définissant les seuils qui déclencheront la notification d'événement.
Par exemple, vous pouvez configurer une notification pour qu'elle soit déclenchée :
- lorsque le nombre de journaux dans la vue de journal "Toutes les erreurs 4xx" dépasse 10% de tout le trafic du site web sur une période de 10 minutes ;
- lorsque le trafic total passe en dessous d'un nombre donné de requêtes au cours des 5 dernières minutes ;
- chaque fois qu'une erreur 5xx se produit ;
- lorsque le trafic provenant d'un pays ou d'une adresse IP donnée dépasse un seuil donné ;
- etc.
Vous recevrez une notification lorsque l'anomalie de trafic est détectée et lorsqu'elle s'arrête.
Pour configurer une notification d'anomalie de trafic :
Au cours de la deuxième étape, nous vous conseillons de "jouer" avec les seuils et la période de prévisualisation, afin de choisir des niveaux appropriés et d'éviter d'être notifié trop fréquemment :
Import de règles CSV ou JSON
Ce type de notification est uniquement disponible dans les projets du plan "Pro".
Les notifications d'import sont envoyées chaque fois qu'un import de règles est exécuté dans le projet et peuvent être utiles si vous avez besoin de suivre le moment où les imports ont été lancés, ou simplement pour informer les autres membres de votre équipe d'un import. L'import de règles étant généralement un processus assez rapide, le but de ce type de notification n'est pas de vous informer de la fin de l'import, mais plutôt de partager cette information avec vos collègues.
Cet événement est déclenché lorsqu'un import est terminé et contient un résumé de l'import (combien de règles ont été créées, combien de lignes ont été ignorées car elles contiennent des erreurs, etc.). Veuillez noter que l'auteur d'un import peut également recevoir un e-mail, car cela peut être configuré dans ses propres paramètres de compte.
Publication de règles
Ce type de notification est uniquement disponible dans les projets du plan "Pro".
Cet événement est déclenché chaque fois qu'un nouveau jeu de règles est publié et contient des informations (le nom de l'auteur de la publication, le nombre de règles ajoutées, modifiées ou supprimées, la durée de la publication, etc.).