File d’attente ECC de Serveur MID

La file d’attente ECC (canal de communication externe) est un point de connexion entre une instance et le serveur MID. Les tâches que le MID Server doit exécuter sont enregistrées dans cette file d’attente jusqu’à ce que le MID Server soit prêt à les gérer.

Bus de message asynchrone

Le serveur MID s’abonne aux messages publiés par l’AMB (Asynchronous Message Bus), qui informe le serveur MID qu’il a des enregistrements de tâches en attente dans la file d’attente ECC. Si une tâche existe dans la file d’attente ECC pour ce serveur MID, le serveur MID définit l’état sur « En cours de traitement ». Lorsqu’il a terminé de travailler sur une tâche demandée, le MID Server envoie un rapport à la file d’attente ECC avec les résultats.

Le serveur MID ouvre une connexion permanente à l’instance via le client AMB et écoute sur le canal AMB /mid/server/<mid_sys_id> . Lorsqu’un enregistrement de sortie est inséré dans la table File d’attente [ecc_queue], un message AMB est envoyé au canal du serveur MID. Le serveur MID reçoit ce message et interroge immédiatement la table ecc_queue pour le travail, sauf si le serveur MID est occupé et que le niveau de priorité du message n’est pas interactif.

Le MID Server interroge la file d’attente ECC à l’intervalle régulier maximal défini dans le paramètre de configuration mid.poll.time (40 secondes par défaut), quelle que soit l’activité du message AMB. Si le MID est occupé et reçoit un message AMB avec un niveau de priorité autre qu’interactif, le temps d’interrogation de la file d’attente passe à mid.poll.time.standard (5 secondes par défaut). Cette interrogation de la file d’attente ECC à intervalles réguliers est effectuée en cas d’interruption de la connexion AMB.

Figure 1. Processus d’interrogation de file d’attente ECC pour Serveur MID

Remarque :

Le client AMB sur le serveur MID ne fonctionne pas dans tous les environnements et peut devoir être désactivé pour éviter les problèmes de performances. Pour désactiver AMB dans votre environnement, définissez le paramètre mid.disable_amb sur true. Lorsque vous désactivez AMB, le serveur MID ne reçoit plus de notifications pour chaque nouvel enregistrement de sortie de file d’attente ECC. Pour plus d’informations, consultez mid.poll.time in Paramètres de Serveur MID .

Informations sur la file d’attente ECC

Vous pouvez accéder à la file d’attente ECC en empruntant l’un des chemins d’accès suivants :

• Découverte > Résultats et artefacts > File d'attente ECC
• Découverte > Calendriers de découverte > {nom du calendrier} > {Enregistrement de l’état de découverte}
• ECC > File d'attente
• {Enregistrement du statut de découverte} > File d'attente ECC

Une file d’attente ECC fournit les informations suivantes :

Champ	Valeur d'entrée
Agent	Nom du système externe d’où proviennent ou de destination les messages. Si le message provient ou est destiné à un MID Server, le nom de l’agent est sous la forme mid.server.xxx, où xxx est le nom d’un MID Server particulier.
Rubrique	Nom de la sonde exécutée par le MID Server. Si vous utilisez un modèle pour la détection, la sonde de modèle horizontal La sonde de modèle horizontal s’affiche.
Nom	Commande réelle exécutée par la sonde. Par exemple, si la rubrique est SSHCommand, le champ Nom contient la commande shell réelle à exécuter. Si vous utilisez un modèle pour la détection, le message suivant apparaît : Pattern Launcher : suivi du nom du pattern et du numéro multipage.
Source	Adresse IP par rapport à laquelle la détection doit être exécutée. Quelques sondes s’exécutent sur plusieurs adresses IP ; Dans ce cas, ce champ contient une description explicite.
Réponse à	Ce champ facultatif contient une référence (sys_id) au message de file d’attente ECC auquel ce message répond. La découverte fait un usage intensif de ce champ pour suivre la hiérarchie des messages qui résultent d’une découverte planifiée donnée. Cliquez sur l’icône d’enregistrement de la valeur dans ce champ pour ouvrir l’enregistrement de file d’attente ECC pour l’activité qui a engendré l’enregistrement de sonde ou de capteur actuel.
File d'attente	Un indicateur indiquant si ce message était est un message d’entrée ou un message de sortie.
État	État de l’enregistrement de file d’attente ECC actuel. Les états se mettent à jour automatiquement.
Traité	Heure à laquelle ce message a été traité.
Créé	Heure à laquelle ce message a été créé.
Séquence	Numéro de séquence unique de ce message. Cette valeur est automatiquement générée lorsqu’un enregistrement de file d’attente ECC est inséré. Son utilisation est déconseillée.
Message d'erreur	Un message d’erreur, si une erreur s’est produite pendant le traitement. Ce champ est masqué dans le formulaire standard, sauf en cas d’erreur.
Charge utile	Corps du message au format XML. Le XML retourné a une balise racine de < résultats > contenant une ou plusieurs balises <résultat> et une seule balise <paramètres> . Les paramètres ne sont qu’un écho de ceux envoyés au MID Server dans la sonde ; Ils varient d’une sonde à l’autre, mais en général, ils indiquent à la sonde les détails de ce qu’elle doit faire et comment elle doit se comporter. Les balises de résultats sont les plus intéressantes : elles contiennent les données réelles générées par la sonde.

Contrôles de file d’attente ECC

Le formulaire File d’attente ECC contient les liens connexes suivants :

Lien connexe	Description
Exécuter à nouveau	Exécute à nouveau la sonde. Vous pouvez réexécuter des sondes en cas d’échec de découverte ou d’autres résultats inattendus.
Accéder à l'élément CMDB	Ouvrez l’enregistrement de CI du CI qui a été mis à jour lors de la détection.
Accéder au capteur	Ouvrez l’enregistrement du capteur associé.

Politique des nouveaux essais de file d’attente ECC

Le module d’extension suivant doit être activé pour pouvoir afficher les modules ECC Politique de nouvelle tentative en file d’attente et Activité de nouvelle tentative en file d’attente :

• Nom du module d’extension : ECC Queue Retry Policy

• Identifiant : com.glideapp.ecc_retry_policy

Gérer le contenu de file d'attente ECC pour un MID Server

La File d’attente ECC vous permet de créer des messages de file d’attente ECC, d’accéder aux entrées de journal du Serveur MID et de récupérer des statistiques à partir d’un enregistrement individuel du Serveur MID.

Avant de commencer

Rôle requis : admin, mid_server

Procédure

1. Envoyez des commandes à distance via un MID Server à un périphérique d’hébergement directement à partir de la file d’attente ECC sans exécuter .Découverte
   1. Accédez à la file d’attente ECC et cliquez sur Nouveau.
   2. Créez un message avec les paramètres suivants :
      • Agent : nom du MID Server qui exécute la commande.
      • Rubrique : Commande
      • Nom : commande réelle que vous souhaitez traiter. Pour Windows, cela est exprimé dans une structure de ligne de commande DOS. Pour Linux, la structure peut être une entrée de ligne de commande bash.
      • File d’attente : sortie
      • Charge utile : avec les balises XML appropriées, vous pouvez spécifier la commande ici plutôt que dans le champ Nom . L’avantage est que la commande n’est pas limitée par la longueur du champ Nom de 120 caractères. Utilisez le format XML suivant pour la commande :

      <parameters>
         <parameter name="name" value="ACTUAL_COMMAND_LINE"/>
      </parameters>

2. Accédez aux entrées dans la file d’attente ECC qui affichent les journaux agent0.log.0 et les journaux wrapper.log pour un serveur MID individuel.
   1. Ouvrez un enregistrement de Serveur MID.
   2. Sous Liens connexes, cliquez sur Récupérer les journaux MID, les fichiers et le vidage de thread.
      Les enregistrements de file d’attente ECC apparaissent dans la liste à l’aide du filtre suivant :

      • [Sujet] [est] [Commande système]
      • [La source] [est] [grabLog]
      • [Agent] [est] [votre MID Server]

      Seules les entrées agent0.log.0 et wrapper.log s’affichent. Ces logs sont également accessibles dans le chemin d’accès du fichier ~\agent\logs\ .

   3. Pour ouvrir une entrée de journal, cliquez sur le lien sous la colonne Créé .
3. Accédez à la rubrique queue.stats pour obtenir des informations utiles sur chaque MID Server, telles que les données d’utilisation de la mémoire et du processeur.
   1. Ouvrez un enregistrement de Serveur MID.
   2. Sous Liens connexes, cliquez sur MID Statistics.
      Les enregistrements de file d’attente ECC apparaissent dans la liste à l’aide du filtre suivant :

      • [Sujet] [est] [queue.stats]
      • [Agent] [est] [votre MID Server]