Intégrer les événements Grafana à l’authentification de base

Intégrez Grafana à Gestion des événements en ajoutant un webhook standard dans la console Grafana.

Avant de commencer

• Assurez-vous que le module d’extension Gestion des événements Connecteurs (sn_em_connector) est installé sur l’instance ServiceNow AI Platform .
• Le Gestion des événements module d’extension doit être installé sur l’instance ServiceNow AI Platform .
• La liaison de CI se produit via l’adresse IP, les instances doivent être découvertes en tant que serveurs pour initier la liaison. Les CI découverts via le cloud ou les CI dans cmdb_ci_vm_object ne sont pas limités, car Grafana ne fournit aucune information pour les ID d’objets.
• Rôle requis : evt_mgmt_integration

Pourquoi et quand exécuter cette tâche

Configurez l’environnement Gestion des événements pour la collecte des événements à partir de Grafana. Dans votre console Grafana, définissez votre ServiceNow AI Platform instance en tant que point de terminaison REST à l’aide d’un webhook standard.

Remarque :

Effectuez les étapes 1 et 2 pour Grafana v7.4.3. Pour Grafana v9.3.2. Passez à l’étape 3.

Procédure

Grafana v7.4.3

1. Dans la console Grafana, créez un canal de notification.
   1. Accédez à la Alerte > Canaux de notification.
   2. Cliquez sur Nouveau canal et sélectionnez le type Webhook.
   3. Entrez une URL.
      Par exemple, utilisez https://<nom-instance>.service-now.com/api/sn_em_connector/em/inbound_event?source=grafana.
   4. Sous les paramètres WebHook facultatifs , sélectionnez la méthode HTTP, POST, et entrez le nom d’utilisateur et le mot de passe de l’utilisateur concerné ServiceNow .
      Remarque :

      Assurez-vous que l’utilisateur sélectionné est affecté au rôle evt_mgmt_integration. pour garantir une authentification appropriée, utilisez l'utilisateur le moins privilégié disposant du rôle evt_mgmt_integration, plutôt qu'un utilisateur possédant des privilèges élevés.
   5. Cliquez sur Test pour vérifier la connexion.
2. Dans la console Grafana, créez des règles d'alerte.
   1. Cliquez sur Modifier dans le panneau requis, puis sur Créer une alerte.
   2. Dans l’onglet Alerte , ajoutez les balises suivantes :

      Étiquettes	Description
      Gravité	(Cette balise est facultative et doit être en minuscules.) Gravité avec laquelle l’alerte doit être créée.
      Nombre	(Cette balise est requise, sinon les alertes ne se ferment pas automatiquement dans ServiceNow.) Nombre d’appareils, d’hôtes ou de serveurs surveillés par cette règle d’alerte.

   3. Ajoutez le canal de notification sous Notifications dans la règle d’alerte.
   4. Cliquez sur Enregistrer.
   5. Accédez à la Alerte > Règles d'alerte pour accéder à la règle créée.

Grafana v9.3.2.

3. Dans la console Grafana, créez un point de contact.
   1. Accédez à la Alerte > Contact Points.
   2. Sélectionnez Nouveau point de contact, entrez un nom et sélectionnez le type Webhook.
   3. Entrez une URL.
      Par exemple, utilisez https://<nom-instance>.service-now.com/api/sn_em_connector/em/inbound_event?source=grafana.
   4. Dans les paramètres Webhook facultatifs , définissez la méthode HTTP sur POST et entrez le nom d’utilisateur et le mot de passe de l’utilisateur ServiceNow approprié.
      Remarque :

      Assurez-vous que l’utilisateur sélectionné est affecté au rôle evt_mgmt_integration. pour garantir une authentification appropriée, utilisez l'utilisateur le moins privilégié disposant du rôle evt_mgmt_integration, plutôt qu'un utilisateur possédant des privilèges élevés.
   5. Cliquez sur Enregistrer et tester pour vérifier la connexion.
4. Dans la console Grafana, créez une politique de notification.
   1. Accédez à la Alerte > Politiques de notification.
   2. Sélectionnez Nouvelle politique, ajoutez des correspondances.
      Les correspondances sont des étiquettes qui dirigent les règles d’alerte vers le point de contact.
   3. Sélectionnez votre point de contact.
   4. Sélectionnez Enregistrer la politique.
5. Dans la console Grafana, créez des règles d’alerte.
   1. Accédez à la Alerte > Règle d'alerte.
   2. Sélectionnez New Rule (Nouvelle règle).
   3. Définissez la requête et la condition d’alerte.
   4. Définissez la source de données, les mesures et les filtres nécessaires.
   5. Définissez le comportement d’évaluation des alertes.
   6. Entrez le nom de la règle.
   7. Dans la section Résumé et annotations, ajoutez un résumé ou une description.
   8. Dans le défilement vers le bas, sélectionnez +Ajouter nouveau.
   9. Saisissez les informations sur le nœud, la ressource et la mesure.
      Ces informations sont requises pour les champs nœud, ressource et metric_name de l’événement.

      Remarque :

      Utilisez la chaîne de valeur pour transmettre ces valeurs. Par exemple, un nœud peut être {{ $values. C0. Étiquettes.instance }}.
   10. Sous Étiquettes personnalisées, fournissez les étiquettes requises pour diriger vos notifications vers le point de contact approprié.
       Remarque :

       Vous pouvez également transmettre la gravité sous des étiquettes personnalisées. La même chose est utilisée pour les événements. Les options de gravité disponibles sont : critique, majeure, mineure, avertissement.
   11. Cliquez sur Enregistrer.

Résultats

L’envoi des alertes depuis Grafana au module d’extension Gestion des événements commence. Le module d’extension extrait les informations du message d’alerte Grafana d’origine pour renseigner les champs d’événement requis et insère l’événement dans la base de données. Dans votre ServiceNow AI Platform instance, naviguez vers Tous les événements pour consulter les événements.

Remarque :

• Pour Grafana v7.4.3, vous pouvez voir des événements très clairs qui ServiceNow ne sont pas liés à une alerte. Ignorez-les, car ils sont créés pour surmonter le problème selon lequel Grafana n’a pas envoyé d’informations dans la notification claire.
• Un paramètre de gravité est ajouté et n’est utilisé que pour Grafana 8 et versions ultérieures. La valeur fournie est utilisée comme gravité d’un événement si la gravité n’est pas transmise dans les étiquettes personnalisées.