Intégrer Dynatrace à l’authentification OAuth

Intégrez Dynatrace en Gestion des événements authentifiant Dynatrace les jetons V1 ou V2 dans le Dynatrace moniteur.

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 .

Vérifiez que les éléments de configuration relatifs aux hôtes gérés par Dynatrace existent dans ServiceNow. Ces CI peuvent être physiques ou virtuels, et peuvent être créés manuellement ou découverts à l’aide de la découverte d’adresses IP ou la découverte dans le cloud.

Rôle requis : evt_mgmt_integration

Pourquoi et quand exécuter cette tâche

Dynatrace L’intégration à l’authentification OAuth est disponible à partir de la version de la Washington DC plateforme ou d’une version ultérieure.

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 disposer du rôle evt_mgmt_integration qui sera utilisé pour créer les événements envoyés par Dynatrace.

         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 Dynatrace console, définissez les paramètres d’intégration.
   1. Accédez à la Paramètres > Intégration > Notifications de problèmes > Configurez les notifications..
   2. Dans le formulaire Configurer l'intégration personnalisée, URL Webhook.

      https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=dynatrace

   3. Activez Utiliser OAuth 2.0 pour l’authentification.
   4. Dans la section Informations d'identification OAuth 2.0, procédez comme suit.
      1. Fournissez l’URL du jeton d’accès en tant que https://<instance_name>.service-now.com/oauth_token.do.
      2. Fournissez la valeur de l’ID client avec l’ID client du client de l’entité OAuth créé dans ServiceNow l’instance.
      3. Fournissez le « Secret du client » avec le secret du client de l’entité OAuth créé dans ServiceNow l’instance.
      4. Sélectionnez Enregistrer.
   5. Dans la section Charge utile personnalisée, ajoutez la structure de charge utile suivante pour les événements qui seront générés. Assurez-vous que ImpactedEntities et ProblemDetailsJSONv2 sont transmis en tant qu’objets JSON et non en tant que chaînes.

      { 
        "ImpactedEntities": {ImpactedEntities}, 
        "ImpactedEntity": "{ImpactedEntity}", 
        "PID": "{PID}", 
        "ProblemDetailsHTML": "{ProblemDetailsHTML}", 
        "ProblemDetailsJSONv2": {ProblemDetailsJSONv2},  
        "ProblemDetailsMarkdown": "{ProblemDetailsMarkdown}", 
        "ProblemDetailsText": "{ProblemDetailsText}", 
        "ProblemID": "{ProblemID}", 
        "ProblemImpact": "{ProblemImpact}", 
        "ProblemSeverity": "{ProblemSeverity}", 
        "ProblemTitle": "{ProblemTitle}", 
        "ProblemURL": "{ProblemURL}", 
        "State": "{State}", 
        "Tags": "{Tags}" 
      }

Résultats

L’envoi des alertes depuis les agents au module d’extension DynatraceGestion des événements commence. Le module d’extension extrait les informations du message d’alerte d’origine Dynatrace 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 :

Par défaut, la liaison d’hôte est activée pour Dynatrace les événements des fournisseurs (AWS/Azure/GCP). Si tous les hôtes de l’environnement sont détectés à l’aide des informations d’identification Découverte dans le cloud fournies et que les ressources découvertes figurent dans la liste des cmdb_ci_vm_object, la liaison de VM peut ne pas avoir lieu. Pour résoudre ce problème, vous devez activer la règle d’événement Dynatrace - Généralités. Pour en savoir plus sur les règles d’événement, reportez-vous à .Règles d’événements