Aller au contenu

Envoi d'événement avec Dynatrace

Description

Convertir des webhooks Dynatrace en alarmes Canopsis.

Fonctionnement

Il n'existe pas réellement de connecteur entre Dynatrace et Canopsis. Pour créer des alarmes depuis dynatrace nous allons utiliser l'envoi de webhook vers l'api de création d'alarme.

Configuration

Canopsis

Pour mettre en place la création d'alarme depuis Dynatrace, il va falloir créer un utilisateur avec un rôle contenant la permission de se connecter à l'API. Il faut dans un premier temps aller dans l'onglet Administration > Rôles, puis créer un nouveau rôle avec les propriétés suivantes:

Paramètre Valeur
Nom Connecteur API

Puis on donne à ce rôle le droit adéquat sur l'API dans Administration > Droits. Dans l'onglet API, il faut sélectionner la permission pour Événements (uniquement pour le rôle Connecteur API ) puis sauvegarder la configuration.

Une fois cette configuration réalisée, il faut ensuite créer un utilisateur dédié à la communication Dynatrace / Canopsis. Pour cela, il faut aller dans Administration > Utilisateurs

Paramètre Valeur
Identifiant Dynatrace
Email adresse@ema.il
Mot de passe motdepassefort
Rôles Connecteur API

On va ensuite appuyer sur l'icone de crayon à côté du nom de l'utilisateur pour afficher le profil et récupérer sa Clé d'authentification ( cette authkey servira ensuite dans la configuration côté Dynatrace ).

Dynatrace

Pour envoyer les webhooks depuis Dynatrace, il faut dans un premier temps les configurer. Pour se faire, depuis votre instance Dynatrace il faut se rendre dans :

Settings > Analyze and alert > Notifications > Problem notifications

Puis remplir les champs suivants :

Option Utilisation
Notification type Le type de notification, dans notre cas nous utiliserons Custom Integration.
Display name Le nom de notre connecteur, dans notre cas nous utiliserons Canopsis
Webhook url L'URL vers le endpoint des événements Canopsis, il doit avoir le format suivant: https://url-de-canopsis/api/v4/events?authkey=[votreauthkey]. La authkey doit être fournie dans l'URL.
Custom payload Le custom payload va nous permettre de donner toutes les informations dont nous avons besoin pour créer notre alarme dans Canopsis.

Exemple de payload: 

{
  "event_type": "check",
  "connector": "Dynatrace",
  "connector_name": "Dynatrace",
  "component": "{ProblemImpact}",
  "resource": "{ImpactedEntity}",
  "source_type": "resource",
  "author": "Dynatrace",
  "state": 3,
  "debug": true,
  "output": "{ProblemTitle}"
}

Résultat

Si tout fonctionne correctement, vous devriez voir vos alarmes dans votre Canopsis

Dynatrace