Consommateur de MID Server

Utilisez la configuration guidée pour passer par la configuration initiale du LES. La configuration guidée vous assiste dans la planification du déploiement du produit et dans l’exécution de la configuration de base pour la mise en service.

La configuration guidée 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 la trace de ce que vous avez terminé, de sorte que vous pouvez arrêter et reprendre là où vous vous étiez arrêté.

Page d’accueil de la configuration guidée

La page d’accueil de Guided Setup 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 de journaux. Le serveur MID 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 ramener à 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 de la liste 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.

Remarque :

Pendant l’installation de l’application Service d'exportation de journal , ServiceNow l’infrastructure sous-jacente sera mise en Service de messagerie Hermes service. Sachez que ce processus peut prendre jusqu’à deux heures à partir du moment où vous demandez l’installation de l’application Service d'exportation de journal .

Rôle requis : administrateur

Procédure

1. Examinez Service de messagerie Hermes les diagnostics.

   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.

   Remarque :

   Vous pourrez accéder Hermes aux diagnostics à l’avenir pour résoudre d’éventuels problèmes de connectivité en revenant à cette étape de la configuration guidée ou en naviguant vers Tout > Service de messagerie Hermes > Diagnostics.
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.

   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.

   Remarque :

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

   • 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
4. Installer le serveur MID : vous devez installer et configurer un serveur MID dédié exécutant Vancouver ou une version ultérieure.
   Effectuez les tâches suivantes pour installer le serveur MID.

   • 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
5. Configurer la destination push REST des journaux : configurez le serveur MID pour qu’il puisse transmettre les journaux par push à votre système d’analyse de 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 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
6. Configurer le consommateur LOG : suivez ces étapes pour configurer votre extension de serveur MID pour le service d’exportation de journaux.
   • 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é.