ServiceNow Canal d'alerte de l'application ITSM

Le canal d'alerte de l'application ITSM (gestion des services informatiques) d' ServiceNow permet de transmettre des notifications d'alerte entre Instana et ServiceNow. application.To envoie des notifications d'alerte de Instana vers ServiceNow en temps réel; créez un canal d'alerte pour l'application ITSM d' ServiceNow.

L'application « IBM » ( Instana ), accessible à l'adresse ServiceNow, offre les fonctionnalités suivantes :

  • transmet les événements Instana vers la table d'incidents ServiceNow ou vers les tables intermédiaires IBM et Instana
  • transfère les notes et les résultats de la synthèse des incidents par IA issus d' Instana vers les incidents correspondants d' ServiceNow qui ont été créés par l'application IBM Instana
  • transmet l'état de clôture des événements de Instana vers la table des incidents de ServiceNow ou vers les tables intermédiaires de IBM et Instana
  • reprend les notes de travail, les commentaires supplémentaires et les modifications de champs de la table des incidents d' ServiceNow vers Instana
  • propage la fermeture de l'événement lorsque le statut des incidents passe à Resolved ou Closed

Conditions requises pour l'installation

Instana ne prend actuellement en charge que les déploiements sur SaaS.

L'application « ServiceNow » accède aux tables suivantes de la base de données « ServiceNow » :

  • Incident (incident) Lecture/Écriture
  • Recherche de données de priorité (dl_u_priority) – Lecture seule
  • Utilisateur (sys_user) en lecture seule
  • Groupe (sys_user_group) Lecture seule
  • Membre du groupe (sys_user_grmember) – Lecture seule
  • Table (sys_db_object) en lecture seule
  • Entrée de dictionnaire (sys_dictionary) En lecture seule

Les événements propagés depuis Instana sont stockés dans l'une des tables intermédiaires suivantes : IBM ou Instana, en fonction du type d'événement :

  • IBM Instana pour les incidents (x_ibm_instana_ibm_instana_for_incidents)
  • IBM Instana pour les problèmes (x_ibm_instana_ibm_instana_for_issues)
  • IBM Instana pour le changement (x_ibm_instana_ibm_instana_for_change)
  • IBM Instana pour la gestion des incidents (x_ibm_instana_ibm_instana_for_monitoring_issues)

Pour envoyer des notifications d'alerte depuis Instana vers ServiceNow en temps réel, créez un canal d'alerte pour l'application ITSM ServiceNow.

Création d'un canal d'alerte pour l'application ITSM d' ServiceNow

Configuration de l'application « ServiceNow » sur ServiceNow

L'application « ServiceNow » est désormais disponible sur l'App Store ( ServiceNow ). Vous pouvez télécharger et installer l'application « IBM » Instana depuis la boutique d'applications ServiceNow. Pour plus d'informations sur les instructions d'installation, consultez le guide d'installation.

Configuration de l'utilisateur sur ServiceNow

Vous devez créer un utilisateur que le canal d'alerte de l'application ITSM d' ServiceNow, dans l'instance Instana, utilise pour accéder à l'application IBM Instana sur ServiceNow.

  1. Cliquez sur Tous et recherche Gestion des utilisateurs . Cliquez sur « Administration des utilisateurs » > « Utilisateurs ».
  2. Cliquez sur « Nouveau » pour créer un nouvel utilisateur.
  3. Entrer le ID de l'utilisateur . Il s'agit du nom d'utilisateur lorsque l'utilisateur se connecte à ce site.ServiceNow exemple.
  4. Remplissez les autres champs en fonction des informations utilisateur et cliquez sur Soumettre pour créer l'utilisateur.
  5. Go sur la page de l'utilisateur nouvellement créée, puis cliquez sur « Définir le mot de passe ». Dans la fenêtre contextuelle, cliquez sur Générer qui crée un mot de passe pour l'utilisateur. Copiez et enregistrez le mot de passe, car il est nécessaire lorsque l'utilisateur se connecte pour la première fois.
  6. Par défaut, la case « Réinitialiser le mot de passe » est cochée une fois que le mot de passe a été créé et enregistré avec succès. Décochez cette case.
  7. Sélectionnez « Machine » dans le champ « Type d'identité ». Si le champ « Type d'identité » n'est pas disponible, consultez les pages ServiceNow, KB2420837 et KB2567879 pour plus d'informations.
    Figure 1. ServiceNow Créer un utilisateur
    ServiceNow Créer un utilisateur
  8. Autorisez l'accès à l'application à l'utilisateur en cliquant sur le bouton Rôle languette.
  9. Cliquez sur le bouton Editer. Dans l'onglet « Recherche », recherchez et sélectionnez les x_ibm_instana.user rôles sn_incident_write et. Ajoutez-les ensuite à la liste des rôles.
    Figure 2. ServiceNow ajouter un accès
    ServiceNow ajouter un accès
  10. Cliquez sur Sauvegarder pour sauvegarder les modifications.
  11. Cliquez sur Mise à jour pour enregistrer les mises à jour. Sur la page utilisateur, les rôles sont ajoutés à la liste des rôles. La liste contient plus de trois rôles, car les rôles sn_incident_write et comprennent plusieurs data_lookup_admin sous-rôles. ServiceNow Enregistrer l'utilisateur

Configuration du canal d'alerte dans l' Instana

  1. Pour créer un canal d'alerte dans l' ServiceNow, dans la barre de navigation de gauche de l'interface utilisateur d' Instana, cliquez sur Paramètres > Paramètres généraux > Événements et alertes > Canaux d'alerte.

  2. Cliquez sur « Ajouter un canal d'alerte » et sélectionnez l'application ITSM « ServiceNow ».

  3. Entrez le nom de la nouvelle chaîne.

  4. L'intégration utilise la méthode d'autorisation de base pour interagir avec l'application ServiceNow via le script REST API.

    • Le champ « URL » doit pointer vers le point de terminaison de l'instance « ServiceNow » avec laquelle « Instana » communique. Par exemple, https://example.service-now.com.

    • Le champ Username doit être le nom d'un utilisateur ServiceNow existant qui a les rôles nécessaires pour accéder à l'application ServiceNow, qui est mentionnée et configurée dans la section précédente. Utilisez l'ID de l'utilisateur créé dans ServiceNow comme nom d'utilisateur.

    • Le champ Password doit contenir le mot de passe de l'utilisateur ServiceNow dont l'identifiant a été saisi dans le champ Username.

  5. Cliquez sur Avancé. Utilisez les deux boutons radio suivants pour activer la fonctionnalité de communication bidirectionnelle entre Instana et ServiceNow.

    • Autoriser Instana à envoyer des événements vers la table des incidents ServiceNow (par défaut) : si cette case est cochée après la propagation des événements vers les tables intermédiaires IBM et Instana, l'application IBM Instana met à jour la table des incidents dans ServiceNow. Cette fonctionnalité permet d'ouvrir et de clore les incidents sur ServiceNow en synchronisation avec ceux de Instana, en synchronisant les notes et l'activité entre Instana et ServiceNow. Les règles métier existantes permettant de modifier votre table d'incidents dans l' ServiceNow fonctionnent également normalement. Tous les utilisateurs d' ServiceNow s ayant accès au tableau des incidents ServiceNow doivent disposer des 5 rôles suivants :

      • x_ibm_instana.ibm_instana_for_tenants_user
      • x_ibm_instana.ibm_instana_for_incidents_user
      • x_ibm_instana.ibm_instana_for_change_user
      • x_ibm_instana.ibm_instana_for_issue_user
      • x_ibm_instana.ibm_instana_for_monitoring_issue_user
    • Limiter l' Instana ation à la propagation vers les tables intermédiaires uniquement : si cette case est cochée, Instana ne propage que les données d'événements vers les tables intermédiaires IBM et Instana, sans effectuer d'autres mises à jour dans la table des incidents ServiceNow. Vos règles métier d' ServiceNow peuvent accéder à ces tables intermédiaires IBM Instana.

  6. Cliquez sur Créer pour créer le canal d'alerte « ServiceNow ». ServiceNow Créer un canal d'alerte

Exemples d'alertes

Lorsque l'option « Autoriser Instana à envoyer des événements vers le tableau des incidents d' ServiceNow » est cochée, les informations suivantes sont ajoutées au champ correspondant du ticket d'incident d' ServiceNow :

  • Le champ « Description succincte » de l'incident reprend le titre de l'événement tel qu'il apparaît dans l'interface utilisateur d' Instana.

  • Le champ Etat de l'incident prend la valeur New si le champ Assigné à est vide. Si ce ServiceNow ticket d'incident est assigné à un utilisateur spécifique dans ServiceNow, le State devient In Progress.

  • Le champ « Impact » est défini en fonction de la gravité de l'événement dans « Instana ». Incidents pour les événements détectés avec le typeonline ,offline , etchange avoir la3 - Low impact. Pour les événements de type issue, incident, et monitoring issue, la valeur du champ « Impact » dépend de leur gravité dans Instana. Les événements de niveau « » dans Instana ont un 2 - Medium impact de Warning type « », et les événements de niveau « » Critical ont un 1 - High impact de type « ».

  • Le Description Le champ est défini en fonction du type d’événement. En général, cela comprend la plupart des informations transmises par le biais d'autres canaux d'alerte d' Instana. Les informations sont représentées dansKey: Value format, avec-- indiquant l'imbrication des paires clé-valeur. Les informations suivantes sont ajoutées au champ « Description » du ticket d'incident « ServiceNow » :

    • Le champ « Type » est défini en fonction de la valeur de event type dans l' Instana; il comprend incident, issue, change, monitoring_issue. Chaque type d'événement est enregistré dans la table intermédiaire correspondante.

    • Le Suggestion champ est défini en fonction de la valeur de fixed suggestion dans le Instana.

    • Le champ « Gravité » est défini en fonction de l' Instana de mappage définie : la valeur -1 correspond à Change, 5 correspond à Warning, 10 correspond à Critical, et les autres valeurs correspondent à Info. ServiceNow prend en charge la promotion des niveaux de gravité. Lorsque le niveau de gravité d'un événement d' Instana passe de « Instana » à un niveau supérieur, les champs correspondants de l'incident ServiceNow sont mis à jour, tels que Urgency et Priority. De plus, le Short Description est mis à jour avec un Severity Upgraded - préfixe. ServiceNow Promotion en fonction du niveau de gravité ServiceNow Promotion en fonction du niveau de gravité Comme le Description champ est modifiable, la fonction « Instana » ne met pas à jour la valeur Severity du champ après une reclassification de la gravité. Le Severity champ conserve sa valeur d'origine.

    • Le champ « Lien » contient le lien vers le site web qui vous redirige vers la page de l'incident en cours dans l' Instana.

    • Les charges utiles personnalisées que vous définissez dans Paramètres > Paramètres généraux > Événements et alertes > Alertes servent à remplir les champs d'incident d' ServiceNow. Pour activer ce comportement, le nom de la clé doit commencer par snow.open. ou snow.close.. Utilisez le snow.open. préfixe pour remplir les valeurs au début d'un événement, et le snow.close. préfixe à la fin d'un événement. Le texte qui suit le préfixe identifie le champ cible qui est mis en correspondance avec le champ correspondant dans la table des incidents d' ServiceNow. Par exemple, snow.open.category une valeur est renseignée dans le champ « Catégorie » lorsqu'un événement commence. Si aucun champ correspondant n'existe, la valeur est ajoutée au champ « Description ». Vous pouvez consulter certains de ces champs de données personnalisés sur la page d'informations relative à l'incident ServiceNow. La mise en correspondance des champs ne prend pas en charge les champs « Description succincte », « Description » et « Priorité ». Cette fonctionnalité n'est pas prise en charge pour les événements liés aux problèmes de surveillance.

    • Pour assignment_group sur ServiceNow,, définissez la valeur en utilisant le nom du groupe ou sys_id du nom du groupe.

    • Pour assigned_to sur ServiceNow,, définissez la valeur en utilisant le nom d'utilisateur, l'identifiant ou sys_id de l'utilisateur. Si les champs assignment_groupassigned_to et sont ajoutés dans les charges utiles personnalisées, assurez-vous que assigned_to l'utilisateur fait partie du assignment_group groupe dans ServiceNow. Sinon, seul assigned_to le champ est renseigné et assignment_group est vide. Si une valeur assigned_to valide est définie, l'incident State « Instana » est défini sur In Progress au lieu de New.

    • Pour les autres champs :

      • clé : nom de colonne de la table des incidents d' ServiceName, précédé du préfixe « snow.open ». ou snow.close.
      • valeur : Valeur du champ. La valeur indiquée est convertie au type du champ. Pour spécifier une valeur de type de référence autre que les types utilisateur ou groupe, utilisez sys_id.

      Par exemple, pour définir le DLA « IBM » dans le champ « Configuration Item », utilisez snow.open.cmdb_ci comme clé (qui correspond au nom du champ) et comme valeur (qui correspond à un sys_id DLA de type « IBM ») 46a0583aa9fe1981002a20ec72ca72f3 .

    ServiceNow Charges utiles personnalisées

ServiceNow Pages de l'interface utilisateur

Plusieurs pages de l'interface utilisateur de l'application « ServiceNow » affichent des informations sur les événements de l' Instana.

ServiceNow interface utilisateur du tableau des incidents

Consultez l'exemple suivant d'un incident « Instana » qui correspond à l'événement de type incident affiché dans l'interface utilisateur du tableau des incidents sur ServiceNow :

ServiceNow Interface utilisateur pour les incidents

IBM Instana interface utilisateur à onglets

Dans l'interface utilisateur du tableau des incidents d' ServiceNow, cliquez sur l'onglet intitulé « IBM Instana »; vous pourrez alors consulter les informations dans l'interface utilisateur de l'onglet « IBM Instana » :

ServiceNow IBM Instana Onglet

IBM Instana interface utilisateur de la table intermédiaire

Dans la barre de navigation, cliquez sur « Tout » et recherchez « IBM Instana ». Sélectionnez les options en fonction du type d'événement. Pour signaler un incident, cliquez sur IBM Instana. Vous pouvez voir le tableau intermédiaire.

ServiceNow IBM Table intermédiaire UI

Cliquez sur le lien hypertexte situé dans la colonne « ID d'événement » d' Instana, il vous redirigera vers l'interface utilisateur de la table intermédiaire d' IBM Instana :

ServiceNow IBM Table intermédiaire UI

De la même manière, vous pouvez consulter l'interface utilisateur de la table intermédiaire IBM Instana pour la table des locataires : dans la barre de navigation, cliquez sur « Tout » et recherchez IBM Instana. Cliquez sur IBM Instana pour les locataires. Vous pouvez voir le tableau intermédiaire.

ServiceNow IBM Table des locataires intermédiaire UI

Cliquez sur le lien hypertexte situé dans la colonne « ID d' Instana »; cela vous redirigera vers l'interface utilisateur de la table intermédiaire IBM Instana :

ServiceNow IBM Table des locataires intermédiaire UI

Concernant les problèmes en suspens ou les incidents

Voir l'exemple suivant de Description champ d'un incident qui correspond à l'événement avec leincident taper:

ServiceNow Description de l'incident en ligne

Synchroniser les notes et les activités

Si vous avez sélectionné le bouton radio « Autoriser Instana à envoyer des événements vers le tableau des incidents de ServiceNow » dans le canal d'alerte de l'application ITSM Instana ServiceNow, les notes que vous ajoutez à un incident ouvert sur Instana sont transmises et synchronisées avec l'incident correspondant dans le tableau des incidents de ServiceNow. De plus, les notes de travail, les commentaires supplémentaires et les activités que vous ajoutez ou effectuez dans le tableau des incidents de ServiceNow se synchronisent avec les incidents correspondants de Instana.

Les scénarios suivants décrivent la fonction de synchronisation des notes et des activités :

La note ajoutée à l'adresse Instana est publiée et synchronisée avec ServiceNow

  1. Un incident est créé à l'adresse Instana et une note Note Test (NB Event #3) est ajoutée par l'utilisateur « Kevin Wu » dans la fenêtre « Notes et activité ». ServiceNow Instana notes
  2. Vous pouvez consulter cette note dans l'onglet « Notes » de l'interface utilisateur du tableau des incidents d' ServiceNow, où figurent le contenu de la note, IBM les informations relatives à l'instance Instana, IBM le nom d'utilisateur Instana, ainsi que l'horodatage. ServiceNow notes

Les notes de travail et les activités ajoutées ou générées sur ServiceNow sont publiées et synchronisées sur Instana

  1. Il s'agit de l'incident « ServiceNow » généré par Instana. ServiceNow incidents
  2. Modifiez les champs Impact de 1 - High à 2 - Medium et réaffectez cet incident de Antony Alldis à Tash Dubrovska. Le champ « Priorité » varie également en fonction du champ « Impact », passant de 3 - Moderate à 2 - High. ServiceNow incidents modifiés
  3. Ajoutez une note de travail Work Notes Test by System admin (From ServiceNow) et une autre note de travail pour les modifications que nous avons apportées à l'étape 2 par l'utilisateur System Administrator. Cliquez ensuite sur le bouton « Mettre à jour ». ServiceNow incidents notes de travail
  4. Une fois la mise à jour terminée, le message suivant s'affiche. ServiceNow invite aux incidents
  5. Go vers la page dédiée à cet incident sur Instana. Dans la fenêtre « Notes et activités », vous pouvez consulter les notes de travail et les activités synchronisées. ServiceNow Instana synchronisation

Concernant les problèmes ou incidents récents

Si vous sélectionnez le bouton radio « Autoriser Instana à envoyer des événements vers la table d'incidents ServiceNow » dans le canal d'alerte de l'application ITSM Instana ServiceNow, les incidents ServiceNow sont automatiquement clôturés lorsque les événements correspondants sont clôturés dans Instana. De plus, les incidents ou problèmes liés à l' Instana sont clôturés lorsque les incidents correspondants sont résolus ou clôturés manuellement dans le tableau des incidents d' ServiceNow.

Les scénarios suivants décrivent la fonction de clôture des incidents :

Un incident clôturé dans Instana est répercuté dans ServiceNow

  1. Un incident est créé dans Instana, et son statut est « actif ».

    ServiceNow incident en cours

  2. Vous pouvez trouver cet incident avec l'état Nouveau dans la table des incidents ServiceNow.

    ServiceNow incident en cours dans l'État de New

  3. Lorsque l'incident est clôturé dans l' Instana, son statut est synchronisé dans le tableau des incidents de l' ServiceNow.

    ServiceNow Incident clôturé par Instana

  4. Le même incident Instana est clôturé sur ServiceNow, les informations relatives à sa résolution ayant été renseignées.

    ServiceNow Synchronisation des incidents clôturés

Vous pouvez choisir l'état de clôture que vous souhaitez attribuer à un incident ServiceNow lorsque les événements correspondants sont clôturés dans Instana. Actuellement, les états de fermeture suivants sont pris en charge : 6 - Resolved, 7 - Closed, et 8 - Canceled. Vous pouvez configurer l'état de la fermeture de mappage dans IBM Instana for Tenants le tableau.

Go pour IBM Instana for Tenants trouver l'enregistrement correspondant dans la table via Instana ID la colonne, qui utilise {tenant unit}-{tenant} le format (par exemple, si le tenant de l' Instana est instana et que l'unité du tenant est test, le Instana ID devrait être test-instana). Il y a une rubrique intitulée Map Instana Closure Event. Vous pouvez définir l'état de clôture d'un incident dans l' ServiceNow en utilisant le numéro d'état : 6 pour Resolved, 7 pour Closed, et 8 pour Canceled. La valeur par défaut est 7 - Closed.

Par exemple, si vous modifiez la Map Instana Closure Event valeur par défaut 7 - Closed et 6 - Resolved que l'incident est clôturé dans Instana, l'état de l'incident dans ServiceNow passe alors de New à Resolved.

ServiceNow Synchronisation des incidents clôturés

Vous trouverez des informations détaillées sur la mise à jour de l'état dans la Notes section.

ServiceNow Synchronisation des incidents clôturés

Vous pouvez désactiver la mise à jour de l'état de l'incident « ServiceNow » lorsqu'un événement « Instana » est clôturé. Vous pouvez également désactiver la mise à jour de l'état de l'incident dans ServiceNow lorsqu'un utilisateur d' ServiceNow modifie l'incident après sa création par Instana. Cette fonction empêche ServiceNow de marquer automatiquement l'incident comme « résolu » tant qu'un utilisateur de ServiceNow est en train de traiter l'incident.

Go Rendez-vous sur IBMInstana pour les locataires, puis recherchez l'enregistrement correspondant dans le tableau à l'aide de la colonne « ID » de Instana, qui utilise {tenant unit}-{tenant} le format. Par exemple, si le locataire de l' Instana est instana et que l'unité du locataire est test, le Instana ID apparaît sous la forme test-instana. Cochez la case « Conserver l'état en cas de mise à jour » pour empêcher « ServiceNow » de mettre à jour le champ d'état de l'incident lorsque « Instana » clôt l'événement.

Un incident clôturé dans ServiceNow est répercuté dans Instana

  1. Un incident est créé sur Instana, et son statut est Active.

    ServiceNow incident en cours

  2. Vous pouvez trouver cet incident avec l'état New dans la table des incidents ServiceNow.

    ServiceNow Incident en cours avec New State dans l'État d' ServiceNow

  3. Un utilisateur de ServiceNow change l'état de l'incident en Closed ou Resolved avec les informations de résolution et met à jour l'incident.

    ServiceNow résoudre ou clore un incident

  4. L'incident est clôturé dans l'instance ServiceNow et l'instance Instana est informée de cette clôture d'incident, comme vous pouvez le voir dans les messages suivants :

    ServiceNow incident de près

  5. L'état de l'incident est modifié et devient fermé.

    ServiceNow Incident clôturé dans l' Instana

  6. Les informations relatives à la résolution de l'incident clôturé que l'utilisateur a saisies dans le tableau des incidents d' ServiceNow sont renvoyées à Instana.

    ServiceNow Informations sur la clôture de l'incident sur Instana

En ligne, hors ligne ou lors d'événements de modification

Voir l'exemple suivant de Description champ d'un incident qui correspond à l'événement avec lechange taper:

ServiceNow Description de l'incident en ligne

Désinstallation

Une fois que vous avez désinstallé l'application Instana ServiceNow de l'instance ServiceNow, rendez-vous sur Instana et supprimez manuellement le canal d'alerte ITSM correspondant ServiceNow.

Pour supprimer le canal d'alerte :

  1. Accédez à Paramètres > Paramètres généraux > Événements et alertes > Canaux d'alerte.
  2. Recherchez le canal d'alerte ITSM « ServiceNow ».
  3. Cliquez sur l'icône de la corbeille située à droite pour supprimer le canal d'alerte.

Si vous réinstallez l'application Instana ServiceNow, reconfigurez l'application nouvellement installée en suivant les étapes de configuration décrites précédemment.

Dépannage des erreurs d'intégration ITSM d' ServiceNow

Erreur 1 : 503 Service indisponible

Message :

Failed to save: failed to send message to ServiceNow ITSM Application Integration {{ServiceNow instance URL}} with status code: 503. Reason: Service Unavailable
 

Cause : cette erreur se produit lorsqu'une requête d' HTTP, envoyée depuis Instana vers l'instance ServiceNow configurée, échoue. Cela est généralement dû à la mise à jour d'une instance d' ServiceNow URL et à la suppression ou à la désactivation de l'instance d'origine.

Résolution :

  • Si l'instance ServiceNow URL a été mise à jour récemment, vous pouvez ignorer cette erreur.
  • Essayez d'enregistrer à nouveau la configuration mise à jour.

Erreur 2 : accès entre périmètres non autorisé

Message :

Error: /api/x_ibm_instana/instana_manager, Unable to create incident JavaException: com.glide.script.fencing.CrossScopeAccessNotAllowedException: Access to ScopedGlideRecordSecure from scope x_ibm_instana not allowed
 

Étapes de résolution :

  1. Dans la console d' ServiceNow, passez de la portée « Global » à « IBM » Instana.
  2. Ouvrez la table « Accès inter-domaines des applications » (sys_scope_privilege.list).
  3. Ajoutez une nouvelle entrée avec les informations suivantes :
    • Source Scope: IBM Instana (non modifiable)
    • Target Scope: Mondial
    • Target Name: ScopedGlideRecordSecure
    • Target Type: Programmable
    • Application: IBM Instana (non modifiable)
    • Operation: Exécutez la commande « API »
    • Status: Autorisé

ServiceNow Dépannage