Consommateur de MID Server

Utilisez la configuration guidée pour passer par la configuration initiale des LES. La configuration guidée vous aide à planifier le déploiement du produit et à effectuer la configuration de base pour la mise en service.

Guided Setup organise les activités de configuration en catégories. Chaque catégorie fournit des informations, telles que des conseils de planification, des étapes de pré-configuration et des liens d'accès à des contenus d'aide utiles. Les catégories fournissent également un ensemble de liens vers les pages de votre instance où vous effectuez la configuration. Le processus de configuration guidée conserve une trace de ce que vous avez terminé, de sorte que vous pouvez arrêter et recommencer là où vous vous étiez arrêté.

Page d’accueil de la configuration guidée

La page d’accueil de la configuration guidée contient une vue d’ensemble des types de configuration pour votre configuration guidée. Vous pouvez sélectionner votre type de configuration guidée et sélectionner Continuer pour ouvrir les étapes de configuration guidée et commencer la configuration.

Les trois configurations de cette page, Démarrage rapide/Meilleure expérience/Personnalisé, fournissent les mêmes tâches et fonctionnalités. Un MID Server dédié est nécessaire pour diffuser en continu les journaux de votre instance vers votre système d’analyse des journaux. Le MID Server a besoin d’une configuration unique pour établir une connexion sécurisée au service de messagerie Hermes. Même si vous avez marqué une tâche comme terminée, vous pouvez revenir en arrière et la décocher pour la remettre à l’état en cours. Pour ce faire, cliquez d’abord sur la zone Modifier dans le coin supérieur droit de la catégorie. Cliquez ensuite sur la zone Modifier de la tâche que vous souhaitez décocher. La case Marquer comme terminé ne sera plus marquée.

Page des catégories de configuration guidée

La page des catégories contient une vue d’ensemble et une description des catégories et des tâches associées. Vous pouvez cliquer sur la flèche déroulante pour afficher les informations sur la catégorie ou cliquer sur Démarrer pour ouvrir les étapes de configuration guidée et commencer la configuration.

Effectuez les tâches de chaque catégorie en suivant les instructions de configuration.

Configuration guidée pour les consommateurs de Serveur MID

Implémentez les étapes suivantes pour une configuration guidée complète pour les consommateurs de Serveur MID.

Avant de commencer

Accédez à la Service d’exportation de journaux (LES) > Consommateur de Serveur MID > Configuration guidée. Sélectionnez le type de configuration que vous souhaitez configurer, puis cliquez sur Continuer.

Rôle requis : admin

Procédure

1. Passer en revue le service de messagerie Hermes : vérifiez les informations suivantes pour réussir les diagnostics Hermes.
   • Informations de configuration : les informations d’amorce suivantes sont utilisées pour se connecter à Hermes Messaging Service. 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 du 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.
2. Générez des certificats pour une connexion sécurisée à Hermes Messaging Service et extrayez les événements de journal à partir de celui-ci.

   Établissez une connexion sécurisée à 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’Hermès.

   Remarque :

   Les rôles administrateur ou Hermes_admin sont requis pour cette étape.
3. Configurer le générateur de journaux : choisissez des sources de journaux à exporter et configurez leurs filtres.
   Effectuez les tâches suivantes pour configurer le générateur de journaux.

   • Configurer les sources de journal pour l’exportation : 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 détermine 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 créateur 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 avec 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 de journal qui a été exporté vers la rubrique
4. Installer un MID Server : vous devez installer et configurer un MID Server dédié exécutant Vancouver ou une version ultérieure.
   Effectuez les tâches suivantes pour installer le MID Server.

   • Installez un MID Server dédié : le MID Server utilisé par le service d’exportation de journaux ne doit être dédié qu’à cette fin et n’est pas censé exécuter d’autres processus. Ceci est important pour garantir la livraison en temps opportun des messages de journal exportés vers votre point de terminaison REST. Vous pouvez installer le nouveau MID Server à l’aide de la commande ou Use MID Server guided setup 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.
   • Valider le MID Server : vous devez valider manuellement le MID Server après son installation pour lui permettre d’exécuter des tâches d’automatisation. Pour valider le MID Server que vous dédiez pour LES, consultez Validate the MID Server
5. Configurer la destination push REST du journal : configurez le MID Server pour qu’il puisse transmettre les journaux par push à votre système d’analyse des journaux (tel que Splunk).
   Effectuez les tâches suivantes pour configurer la destination push REST du journal.

   • Ajouter des propriétés MID : vous devez ajouter des propriétés MID Server afin qu’il puisse se connecter à Hermes. Accédez à Serveur MID> Propriétés 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>/<magasin de confiance>.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.&lt;instance_name>.group1
     mid.les.kafka.bootstrap.servers	&lt;instance_name>.&lt;domaine> :4100,&lt;instance_name>.&lt;domaine> :4101,&lt;instance_name>.&lt;domaine> :4102,&lt;instance_name>.&lt;domaine> :4103
     mid.les.kafka.set2.bootstrap.servers	&lt;instance_name>.&lt;domaine> :4200,&lt;instance_name>.&lt;domaine> :4201,&lt;instance_name>.&lt;domaine> :4202,&lt;instance_name>.&lt;domaine> :4203

     Suivez ces notes pour savoir comment obtenir certaines des valeurs ci-dessus

     • <password> 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 les fichiers keystore et 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>'agit du nom de votre instance ServiceNow. Si vous n’êtes pas sûr, vous pouvez le trouver dans la table 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érera 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 de votre point de terminaison souhaité pour les sources de journal exportées
     4. Recherchez ou créez de nouvelles 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 : authentification de base, OAuth, clé API
     5. Recherchez ou créez un script de transformation. Nous livrons avec le script pré-écrit, SplunkTransform pour Splunk
6. Configurer le consommateur de journaux : suivez ces tâches pour configurer votre extension de serveur MID à des fins de service d’exportation de journaux.
   • Configurer le contexte de consommateur LES : dans cette étape, vous allez mettre à jour l’enregistrement de consommateur LES à exécuter 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 MID Server 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 qui fait partie de l’extension du 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 de journal et la destination vers laquelle les relayer.
     1. Créer un enregistrement de consommateur
     2. Choisir une rubrique source dans la liste déroulante
     3. Choisir la configuration de destination
     4. Démarrer le consommateur
   • Vérifier l’intégration du MID Server : accédez à Service d’exportation de journaux (LES) > Consommateurs et afficher les champs État et Détail 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 éventuelles qui ont pu se produire lors du relais de messages au point de terminaison REST.  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 afficher les journaux sur le MID Server 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 MID Server pour obtenir des informations supplémentaires si nécessaire.