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 à
ResolvedouClosed
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.
- Cliquez sur Tous et recherche Gestion des utilisateurs . Cliquez sur « Administration des utilisateurs » > « Utilisateurs ».
- Cliquez sur « Nouveau » pour créer un nouvel utilisateur.
- Entrer le ID de l'utilisateur . Il s'agit du nom d'utilisateur lorsque l'utilisateur se connecte à ce site.ServiceNow exemple.
- Remplissez les autres champs en fonction des informations utilisateur et cliquez sur Soumettre pour créer l'utilisateur.
- 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.
- 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.
- 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 
- Autorisez l'accès à l'application à l'utilisateur en cliquant sur le bouton Rôle languette.
- Cliquez sur le bouton Editer. Dans l'onglet « Recherche », recherchez et sélectionnez les
x_ibm_instana.userrôlessn_incident_writeet. Ajoutez-les ensuite à la liste des rôles.Figure 2. ServiceNow ajouter un accès 
- Cliquez sur Sauvegarder pour sauvegarder les modifications.
- 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_writeet comprennent plusieursdata_lookup_adminsous-rôles.
Configuration du canal d'alerte dans l' Instana
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.
Cliquez sur « Ajouter un canal d'alerte » et sélectionnez l'application ITSM « ServiceNow ».
Entrez le nom de la nouvelle chaîne.
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.
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.
Cliquez sur Créer pour créer le canal d'alerte « ServiceNow ».

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
Newsi le champ Assigné à est vide. Si ce ServiceNow ticket d'incident est assigné à un utilisateur spécifique dans ServiceNow, le State devientIn 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 type
online,offline, etchangeavoir la3 - Lowimpact. Pour les événements de typeissue,incident, etmonitoring issue, la valeur du champ « Impact » dépend de leur gravité dans Instana. Les événements de niveau « » dans Instana ont un2 - Mediumimpact deWarningtype « », et les événements de niveau « »Criticalont un1 - Highimpact 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 dans
Key: Valueformat, 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 typedans l' Instana; il comprendincident,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 suggestiondans le Instana.Le champ « Gravité » est défini en fonction de l' Instana de mappage définie : la valeur
-1correspond àChange,5correspond àWarning,10correspond à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 queUrgencyetPriority. De plus, leShort Descriptionest mis à jour avec unSeverity Upgraded -préfixe.
Comme le Descriptionchamp est modifiable, la fonction « Instana » ne met pas à jour la valeurSeveritydu champ après une reclassification de la gravité. LeSeveritychamp 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.ousnow.close.. Utilisez lesnow.open.préfixe pour remplir les valeurs au début d'un événement, et lesnow.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.categoryune 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_groupsur ServiceNow,, définissez la valeur en utilisant le nom du groupe ousys_iddu nom du groupe.Pour
assigned_tosur ServiceNow,, définissez la valeur en utilisant le nom d'utilisateur, l'identifiant ousys_idde l'utilisateur. Si les champsassignment_groupassigned_toet sont ajoutés dans les charges utiles personnalisées, assurez-vous queassigned_tol'utilisateur fait partie duassignment_groupgroupe dans ServiceNow. Sinon, seulassigned_tole champ est renseigné etassignment_groupest vide. Si une valeurassigned_tovalide est définie, l'incidentState« Instana » est défini surIn Progressau lieu deNew.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_cicomme clé (qui correspond au nom du champ) et comme valeur (qui correspond à unsys_idDLA de type « IBM »)46a0583aa9fe1981002a20ec72ca72f3.

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 :

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 » :

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.

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 :

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.

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 :

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:

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
- 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é ».
- 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.

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
- Il s'agit de l'incident « ServiceNow » généré par Instana.

- Modifiez les champs Impact de
1 - Highà2 - Mediumet réaffectez cet incident deAntony AlldisàTash Dubrovska. Le champ « Priorité » varie également en fonction du champ « Impact », passant de3 - Moderateà2 - High.
- 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'utilisateurSystem Administrator. Cliquez ensuite sur le bouton « Mettre à jour ».
- Une fois la mise à jour terminée, le message suivant s'affiche.

- 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.

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
Un incident est créé dans Instana, et son statut est « actif ».

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

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

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

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.

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

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
Un incident est créé sur Instana, et son statut est
Active.
Vous pouvez trouver cet incident avec l'état
Newdans la table des incidents ServiceNow.
Un utilisateur de ServiceNow change l'état de l'incident en
ClosedouResolvedavec les informations de résolution et met à jour l'incident.
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 :

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

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.

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:

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 :
- Accédez à Paramètres > Paramètres généraux > Événements et alertes > Canaux d'alerte.
- Recherchez le canal d'alerte ITSM « ServiceNow ».
- 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 :
- Dans la console d' ServiceNow, passez de la portée « Global » à « IBM » Instana.
- Ouvrez la table « Accès inter-domaines des applications » (
sys_scope_privilege.list). - Ajoutez une nouvelle entrée avec les informations suivantes :
Source Scope: IBM Instana (non modifiable)Target Scope: MondialTarget Name: ScopedGlideRecordSecureTarget Type: ProgrammableApplication: IBM Instana (non modifiable)Operation: Exécutez la commande « API »Status: Autorisé
