File d’attente ECC de Serveur MID

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

Bus de messages asynchrones

Le serveur MID s’abonne aux messages publiés par le bus de messages asynchrones (AMB), 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 « Traitement ». Lorsque l’exécution d’une tâche demandée a été achevée, le serveur MID renvoie 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 connaître le travail, sauf si le Serveur MID est occupé et que le niveau de priorité du message n’est pas Interactif.

Le serveur MID 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 de 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 des problèmes de performances. Pour désactiver AMB dans votre environnement, définissez le paramètre mid.disable_amb sur vrai. 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. Voir mid.poll.time in pour plus d’informations 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 de ces chemins :

• Découverte > Résultats et artefacts > File d'attente ECC
• Découverte > Calendriers de découverte > {nom du calendrier} > {Enregistrement du statut 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 à partir duquel ou vers lequel ce message provient. Si le message provient d’un serveur MID ou est destiné à celui-ci, le nom de l’agent est sous la forme mid.server.xxx, où xxx est le nom d’un serveur MID particulier.
Sujet	Nom de la sonde exécutée par le Serveur MID. Si vous utilisez un modèle pour la détection, la sonde de modèle horizontal Sonde de modèle horizontal s’affiche.
Nom	La 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écouverte, les éléments suivants s’affichent : Lanceur de modèle : suivi du nom du modèle et du numéro de plusieurs pages.
Source	Adresse IP sur laquelle la découverte doit s’exécuter. Quelques sondes s’exécutent sur plusieurs adresses IP ; Dans ce cas, ce champ contient une description lisible par l’homme.
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 de ce champ pour ouvrir l’enregistrement de file d’attente ECC de l’activité qui a engendré l’enregistrement de la sonde ou du capteur actuel.
File d'attente	Un indicateur indiquant si ce message était un message d’entrée ou un message de sortie.
État	État de l’enregistrement actuel de file d’attente ECC. Les états se mettent à jour automatiquement.
Traité	Heure à laquelle ce message a été traité.
Créées	Heure à laquelle ce message a été créé.
Séquence	Numéro de séquence unique pour 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	Le corps du message au format XML. Le XML renvoyé a une balise racine de <results> contenant une ou plusieurs balises <result> et une seule balise <parameters> . Les paramètres sont simplement 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ésultat 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 probes lorsque vous rencontrez un é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écouverte.
Accéder au capteur	Ouvrez l’enregistrement du capteur associé.

Politique des nouveaux essais en file d’attente ECC

Le module d’extension Politique des nouveaux essais de la file d’attente ECC (com.glideapp.ecc_retry_policy) doit être activé pour pouvoir afficher les modules Politique des nouveaux essais de la file d’attente ECC et Activité de nouveaux essais de file d’attente.

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 les statistiques d’un enregistrement individuel du serveur MID.

Avant de commencer

Rôle requis : admin, mid_server

Procédure

1. Envoyer des commandes à distance via un serveur MID à un périphérique d’hébergement directement depuis 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 ces paramètres :
      • Agent : nom du Serveur MID qui exécute la commande.
      • Rubrique : Commande
      • Nom : commande réelle que vous voulez traiter. Pour Windows, cela est exprimé dans une structure de ligne de commande DOS. Pour Linux, la structure pourrait ê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éder 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 Capturer les journaux MID, les fichiers et le vidage des threads.
      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 Serveur MID]

      Seules les entrées agent0.log.0 et wrapper.log s’affichent. Ces journaux sont également accessibles dans le chemin d’accès au 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 les serveurs MID individuels, 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 Statistiques MID.
      Les enregistrements de file d’attente ECC apparaissent dans la liste à l’aide du filtre suivant :

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