Et si vous pouviez connecter votre compte Uptrends au logiciel de gestion de votre organisation. Intégrer vos données d’alerte d’Uptrends avec vos processus de gestion d’incidents existants permet un fonctionnement transparent dans les procédures quotidiennes que vos équipes utilisent déjà.
Si votre logiciel DevOps ne se trouve pas dans nos types d’intégration prédéfinis, alors vous pouvez utiliser l’option d’intégration personnalisée pour créer l’intégration vous-même. La clé pour construire une intégration réussie est de connaître le type de message attendu par l’autre système. La documentation de l’API du tiers vous indique quelle URL utiliser et quel contenu y envoyer. Souvent appelées intégrations webhook, elles permettent à Uptrends de se connecter à l’autre système avec des appels directs. Uptrends peut initier un appel à l’intégration dès qu’une alerte pertinente apparaît.
Les articles de cette section traiteront de la construction du bon contenu de message (y compris le formatage correct), de la création de différentes règles pour différents types de messages et de la manière de tester votre intégration personnalisée une fois que vous avez terminé sa mise en place.
Configuration d’une intégration personnalisée
Pour commencer à utiliser les intégrations personnalisées, suivez ces étapes :
- Ajoutez un modèle d’intégration personnalisé à votre compte. Pour ce faire, cliquez sur le bouton + à côté de Intégrations dans le menu déroulant Alerte, dans l’application Uptrends.
- Une fenêtre popup apparaîtra, vous invitant à choisir un type d’intégration. Pour une intégration personnalisée, faites défiler jusqu’au bas de la liste et sélectionnez Intégration Uptrends.
- Indiquez l’URL de l’API à laquelle vous vous connectez, à l’aide de la variable ApiUrl sous Variables prédéfinies. Vous trouverez cette URL dans la documentation ou l’interface utilisateur du système externe auquel Uptrends sera connecté.
- N’oubliez pas de donner à l’intégration un nom approprié dans le champ Nom d'intégration.
- Si nécessaire, personnalisez votre intégration en visitant l’onglet Personnalisations. Les autres chapitres de cet article vous guideront tout au long du processus.
- Lorsque vous avez terminé la configuration, cliquez sur Enregistrer pour enregistrer vos paramètres. Vous pouvez à tout moment revenir à l’intégration pour terminer la personnalisation si nécessaire.
Créer le bon contenu de message
Cette intégration sera un modèle prédéfini : un corps de message (personnalisable) au format JSON contenant toute la gamme des variables d’alerte disponibles. Ce format de message par défaut vous permet de traiter toutes les informations disponibles relatives à chaque alerte ; cependant vous pouvez supprimer les données dont vous n’avez pas besoin, ajouter vos propres données ou modifier le format du message. Vous trouverez le corps de message prédéfini sous l’onglet Personnalisations, ainsi que d’autres options pour personnaliser davantage votre intégration.
- Pour comprendre comment commencer à configurer le contenu du message souhaité et comment utiliser les variables, nous vous recommandons de lire d’abord notre article sur la construction du bon contenu de message.
- Vous trouverez une description complète des variables d’alerte disponibles dans notre liste de variables du système d’alerte.
- Gardez à l’esprit que votre message sortant doit être formaté correctement. Lisez notre guide sur le formatage des messages pour éviter des erreurs inutiles dans votre application externe.
Types de messages
Il y a différents types de messages d’alerte. Uptrends fait la distinction entre les messages d’erreur, les messages de rappel et les messages OK. Par défaut, tous ces types de messages sont créés avec la même configuration. Toutefois, lors de la mise en place d’une intégration personnalisée ou de la personnalisation d’une intégration existante, vous pouvez créer différents ensembles d’actions pour chaque type de message. Consultez notre article sur les types de messages pour en savoir plus.
Tester votre intégration personnalisée
Une fois que vous avez créé ou modifié une intégration personnalisée, il est recommandé de la tester avant de l’utiliser en production. Notre article sur le test de votre intégration personnalisée couvrira les moyens de tester l’intégration nouvellement mise en place.
Ajout de l’intégration à une définition d’alerte dans Uptrends
Une définition d’intégration seule ne fait rien. Vous devez l’associer à un ou plusieurs niveaux d’escalade pour recevoir des alertes via l’intégration. Pour associer une définition d’intégration à un niveau d’escalade :
- Allez à la définition d’alerte souhaitée dans Uptrends (Alerte > Définitions d'alerte).
- Cliquez pour ouvrir une définition existante, ou créez-en une nouvelle à l’aide du bouton Ajouter une définition d'alerte en haut à droite.
- Cliquez sur un onglet Niveau d'escalade.
- Dans la section Alertes par intégrations, cochez les cases correspondant à vos définitions d’intégration personnalisées.
- Cliquez sur Enregistrer lorsque vous avez terminé.
Et c’est tout ! Vous avez configuré avec succès une intégration personnalisée.
Comme toujours, si vous avez des questions, n’hésitez pas de contacter notre équipe de Support.