Intégrer Grafana à l’authentification OAuth

  • Rversion finale: Australia
  • Mis à jour 16 juin 2026
  • 4 minutes de lecture

    • Intégrez Grafana à Gestion des événements ServiceNow à l’aide de l’authentification OAuth.

    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.

    Procédez comme suit pour que Grafana v9.3.2 envoie l’événement à ServiceNow.

    Procédure

    1. Configuration sur l’instance ServiceNow .
      1. Créez une glide.oauth.inbound.client.credential.grant_type.enabled propriété système pour utiliser le type d’accord Informations d’identification du client pour les intégrations entrantes OAuth.
        • Type : Vrai/Faux
        • Valeur : vrai
        Remarque :
        Un administrateur doit créer cette propriété système, car le rôle evt_mgmt_admin ne dispose pas de l’autorisation requise pour le faire.
      2. Créez un point de terminaison d'entité OAuth pour permettre aux clients d'accéder à l'instance.
        1. Accédez à la Tous > OAuth système > Registre d'application puis sélectionnez New.
        2. Sur la page de l’intercepteur, sélectionnez Créer un point de terminaison d’API OAuth pour les clients externes , puis remplissez le formulaire.
        3. Pour créer un enregistrement client OAuth, sélectionnez Soumettre.
      3. Ajoutez l'utilisateur de l'application OAuth et le type d'accord par défaut à l'enregistrement client OAuth créé.
        1. Dans le formulaire Entité OAuth, ajoutez les champs Utilisateur de l’application OAuth et Type d’accord par défaut pour utiliser le type d’accord Informations d’identification du client pour les intégrations entrantes OAuth.
        2. Ouvrez l'enregistrement client OAuth créé.
        3. Dans l’en-tête de la page, sélectionnez l’icône Autres options.
        4. Sélectionner Configurer > Mise en page
        5. Sur la page Mise en page, ajoutez Utilisateur de l’application OAuth et Type d’accord par défaut dans la liste des champs.
        6. Enregistrez ou mettez à jour le formulaire.
        7. Pour le champ Utilisateur de l’application OAuth , sélectionnez l’utilisateur.
          L’utilisateur doit avoir le rôle evt_mgmt_integration qui sera utilisé pour créer les événements envoyés par Grafana.
          Remarque :
          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.
        8. Définissez la valeur du champ Type d’accord par défaut sur Informations d’identification du client.
    2. Dans la console Grafana, créez un point de contact.
      1. Accédez à la Alertes et IRM > 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.
      5. Dans Configuration HTTP, sélectionnez +Ajouter.
      6. Dans OAuth2, sélectionnez +Ajouter.
      7. Fournissez l’URL du jeton en tant que : https://<instance_name>.servicenow.com/oauth_token.do.
      8. Fournissez la valeur de l’ID client avec l’ID client du client de l’entité OAuth créé dans l’instance ServiceNow.
      9. Fournissez le secret du client avec le secret du client de l’entité OAuth créé dans l’instance ServiceNow.
      10. Sélectionnez Enregistrer le point de contact.
    3. 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.
    4. 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.

    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.