Intégrer les événements Grafana

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 minutes de lecture

    • 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 Now Platform .
    • Le module d'extension Gestion des événements doit être installé sur l'instance Now Platform.
    • La liaison de CI se produit via l'adresse IP, les instances devant être détectées en tant que serveurs pour initier la liaison. Les CI détectés 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 d'événements à partir de Grafana. Dans votre console Grafana, définissez votre instance Now Platform 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 en tant que Webhook.
      3. Saisissez 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 saisissez le nom d’utilisateur et le mot de passe de l’utilisateur concerné ServiceNow .
        Remarque :
        assurez-vous que le rôle evt_mgmt_integration est affecté à l'utilisateur sélectionné ; 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 Tester 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 :
        Balises Description
        Gravité (Cette balise est facultative et doit être en minuscules.) Sévérité avec laquelle l’alerte doit être créée.
        Count (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.
    1. Dans la console Grafana, créez un point de contact.
      1. Accédez à la Alerte > Contact Points.
      2. Cliquez sur Nouveau point de contact, saisissez un nom et sélectionnez le type en tant que Webhook.
      3. Saisissez 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 saisissez le nom d’utilisateur et le mot de passe de l’utilisateur concerné ServiceNow .
        Remarque :
        assurez-vous que le rôle evt_mgmt_integration est affecté à l'utilisateur sélectionné ; 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.
    2. Dans la console Grafana, créez une politique de notification.
      1. Accédez à la Alerte > Politiques de notification.
      2. Sélectionnez Nouvelle stratégie, ajoutez des correspondances.
        Les marqueurs 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 stratégie.
    3. Dans la console Grafana, créez des règles d’alerte.
      1. Accédez à la Alerte > Règle d4alerte.
      2. Sélectionnez Nouvelle règle.
      3. Définissez la condition de requête et 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, Ressources 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. Labels.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 de Grafana au module d'extension Event Management 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 instance Now Platform, accédez à Tous les événements pour afficher les événements.

    Remarque :
    • Pour Grafana v7.4.3, vous pouvez voir arriver des événements ServiceNow très clairs qui 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 les versions ultérieures. La valeur fournie est utilisée comme gravité pour un événement si la gravité n’est pas transmise dans les étiquettes personnalisées.