Il est recommandé de vérifier que le Service de messagerie Hermes est opérationnel à l’aide de l’outil de diagnostic, qui s’affiche Hermes à l’écran pendant cette étape. Si vous voyez une erreur « Page introuvable » sur cette page, n’est Hermes pas installé et vous devez contacter votre administrateur système.

• Informations de configuration : les informations d’amorce suivantes permettent de se connecter à Service de messagerie Hermes. Le « Producer Bootstrap » est la connexion utilisée pour envoyer des messages dans Hermes et le « Consumer Bootstrap 1 & 2 » est utilisé pour récupérer des messages dans Hermes.
  • Amorce du créateur
  • Amorce de consommateur 1
  • Amorce de consommateur 2
• PKI d’instance : le composant d’infrastructure de clé publique d’instance (PKI) permet à une instance ServiceNow d’agir en tant qu’émetteur dans une hiérarchie de confiance X.509.
• Connectivité d’amorce : cliquez sur Exécuter le test pour confirmer que le client externe est en mesure de se connecter aux ports d’instance définis (producteur et consommateur).
• Connectivité de l’instance : cliquez sur Exécuter le test pour confirmer que l’instance est en mesure d’envoyer et de recevoir des messages.
• Afficher les rubriques : cliquez sur la rubrique répertoriée pour récupérer l’horodatage du dernier message connu.

Configurez une connexion sécurisée au service de messagerie Hermes. Consultez Set up a secure connection to the Hermes Messaging Service pour plus d'informations. Vous aurez besoin de ces certificats pour l’authentification et l’autorisation dans le client qui extraira les journaux d’Hermes.

• Configurer les sources de journal à exporter : créez un enregistrement source pour chacune des sources de journal que vous souhaitez exporter.
  Remarque :

  Les rôles administrateur ou sn_logstoanalytics.admin sont requis pour terminer cette étape
  1. Cliquez sur Nouveau dans le coin supérieur droit
  2. Sélectionner un type de source
  3. Sélectionnez les filtres appropriés pour le type de source sélectionné
     Remarque :

     Les filtres sont différents selon le type de source sélectionné
  4. Cliquez sur Mettre à jour
  Une fois créée, elle affiche le nom de la rubrique Hermes vers laquelle cette source de journal sera exportée. Notez le nom de la rubrique, vous en aurez besoin ultérieurement lors de la configuration de votre système de consommateur de journaux. Le champ Actif contrôle si cette source de journal va être exportée ou non. Si des erreurs s’affichent, revenez à la tâche Vérifier les diagnostics Hermes et vérifiez l’état Hermes.
• Valider le producteur de journaux : une fois que vous avez créé une source à partir de laquelle produire des journaux, vous pouvez afficher les enregistrements de journaux en direct dans la rubrique à l’aide de Service de messagerie Hermes > Inspecteur de rubrique Hermes.
  1. Sélectionner des rubriques externes
  2. Cliquer sur Répertorier les rubriques
  3. Sélectionnez la ligne correspondant à votre rubrique de l’étape précédente (répertoriée dans Sources)
  4. Ajuster la date de début du message si nécessaire
  5. Cliquez sur Afficher pour afficher un message du journal qui a été exporté vers la rubrique

• Installer un serveur MID dédié : le serveur MID utilisé par le service d’exportation de journaux doit être dédié uniquement à cette fin et n’est pas censé exécuter d’autres processus. Ceci est important pour garantir la remise en temps opportun des messages de journal exportés à votre point de terminaison REST. Vous pouvez installer le nouveau serveur MID à l’aide de la Use MID Server guided setup commande ou en l’installant manuellement. Pour l’installation manuelle, suivez d’abord la Configure MID Server network connectivity documentation, puis la Installing the MID Server documentation ensuite.
• Valider le serveur MID : vous devez valider manuellement le serveur MID après son installation pour lui permettre d’exécuter des tâches d’automatisation. Pour valider le Serveur MID que vous dédiez au LES, consultez Validate the MID Server

• Ajouter des propriétés MID : vous devez ajouter des propriétés au serveur MID afin qu’il puisse se connecter à Hermès. Accédez aux > propriétésde Serveur MID et définissez les valeurs appropriées pour chacune des propriétés énumérées ci-dessous.

  Nom	Valeur
  mid.les.kafka.ssl.truststore.password	<mot de passe>
  mid.les.kafka.ssl.keystore.password	<mot de passe>
  mid.les.kafka.ssl.key.mot de passe	<mot de passe>
  mid.les.kafka.ssl.truststore.location	<your_path>/<truststore>.p12
  mid.les.kafka.ssl.keystore.location	<your_path>/<magasin de clés>.p12
  mid.les.kafka.ssl.truststore.type	PKCS12
  mid.les.kafka.ssl.keystore.type	PKCS12
  mid.les.kafka.client.id	<instance_name>
  mid.les.kafka.group.id	snc.<instance_name>.group1
  mid.les.kafka.bootstrap.servers	<instance_name>.servicenow.com:4100,<instance_name>.servicenow.com:4101,<instance_name>.servicenow.com:4102,<instance_name>.servicenow.com:4103
  mid.les.kafka.set2.bootstrap.servers	<instance_name>.servicenow.com:4200,<instance_name>.servicenow.com:4201,<instance_name>.servicenow.com:4202,<instance_name>.servicenow.com:4203

  Suivez ces notes pour obtenir certaines des valeurs ci-dessus

  • <mot de passe> est le mot de passe que vous définissez pour le magasin de clés et le magasin de clés de confiance.
  • <your_path> s’agit du chemin d’accès au répertoire dans lequel vous conservez le keystore et les fichiers du truststore que vous avez téléchargés. Les certificats doivent se trouver sur le serveur sur lequel vous exécutez le MID
  • <instance_name> s’agit du nom de votre instance ServiceNow. Si vous n’êtes pas sûr, vous pouvez le trouver dans le tableau sys_properties
  • Vous pouvez obtenir les valeurs pour mid.les.kafka.bootstrap.servers et mid.les.kafka.set2.bootstrap.servers à partir de la page Diagnostics Hermes. Accédez à la Service de messagerie Hermes > Diagnostics et copiez les chaînes sous Consumer Bootstrap 1 et Consumer Bootstrap 2 respectivement.
• Configurer la destination : créez un nouvel enregistrement de configuration de destination, qui définit le point de terminaison REST vers lequel cette extension transfère les journaux.
  Remarque :

  les rôles administrateur ou sn_logstoanalytics.admin sont requis pour terminer cette étape.
  1. Accédez à la Service d’exportation de journaux (LES) > Destination Configurations 
  2. Créer un enregistrement de configuration
  3. Spécifier l’URL du point de terminaison souhaité pour les sources de journaux exportées
  4. Recherchez ou créez des informations d’identification pour vous connecter à votre point de terminaison. Lors de la création d’informations d’identification pour votre point de terminaison, notez que seuls les types d’informations d’identification suivants sont valides avec LES : auth. de base, OAuth, clé API
  5. Recherchez ou créez un script de transformation. Nous sommes livrés avec le script pré-écrit, SplunkTransform pour Splunk

• Configurer le contexte de consommateur LES : Au cours de cette étape, vous allez mettre à jour l’enregistrement de consommateur LES pour qu’il s’exécute sur le MID Server dédié que vous venez d’installer pour le service d’exportation de journaux. Accédez à la Serveur MID > Extensions > Contexte de consommateur LES et mettez à jour l’enregistrement de consommateur LES en définissant les champs suivants :
  • Cliquez sur « Consommateur LES » pour ouvrir l’enregistrement de contexte du Serveur MID
  • Sélectionner un Serveur MID spécifique pour le champ « Exécuter sur »
  • Saisissez le nom du MID que vous avez validé à l’étape précédente pour le champ « Serveur MID »
  Cliquez sur Mettre à jour pour enregistrer.
  Remarque :

  Nous livrons avec un contexte préconstruit. N’en créez pas un deuxième. Cela peut avoir des conséquences inattendues.
• Configurer le consommateur : créez un nouvel enregistrement de consommateur, qui représente le processus faisant partie de l’extension Serveur MID du service d’exportation de journaux. Accédez à la Service d’exportation de journaux (LES) > Consommateurs et créez un nouvel enregistrement de configuration en spécifiant la rubrique Hermes à partir de laquelle récupérer les messages du journal et la destination vers laquelle les relayer. Lorsque vous sélectionnez le module Consommateurs , il affiche des informations sur le nom du consommateur et la configuration de destination.
  1. Créer un enregistrement de consommateur
  2. Choisir une rubrique source dans la liste déroulante
  3. Choisir une configuration de destination
  4. Démarrer le consommateur
• Vérifier l’intégration du serveur MID : accédez à Service d’exportation de journaux (LES) > État du consommateur et affichez les champs État et Détails de l’état de l’enregistrement défini. Les informations contenues dans ces champs signalent l’état actuel du processus en cours d’exécution sur le MID Server, y compris les erreurs qui ont pu se produire lors du relais de messages au point de terminaison REST. Il s’agit uniquement d’une page d’affichage d’état. Accédez à la Service d’exportation de journaux (LES) > Consommateurs si vous souhaitez créer un enregistrement de consommateur.  Si l’état du consommateur indique que le processus a démarré, vous devez être en mesure d’inspecter votre point de terminaison pour afficher les journaux qui lui ont été relayés. En outre, vous pouvez consulter les journaux sur le serveur MID pour voir s’il existe des détails supplémentaires sur les erreurs qui peuvent être rencontrées. Vous pouvez également activer la journalisation de débogage sur le serveur MID pour obtenir des informations supplémentaires si nécessaire.
  Remarque :

  Si vous apportez une modification à l’un des enregistrements de consommateur, elle s’affiche sur la page d’affichage de l’état du consommateur. Si vous sélectionnez un nom d’enregistrement de consommateur sur la liste État du consommateur, le formulaire Consommateur de l’enregistrement sélectionné s’ouvre. Vous pouvez ensuite mettre à jour le nom et la configuration de destination de l’enregistrement sélectionné.