File d’attente ECC de Serveur MID

Rversion finale: Washingtondc

Mis à jour 1 févr. 2024

6 minutes de lecture

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 MID Server doit effectuer sont enregistrées dans cette file d’attente jusqu’à ce que le MID Server soit prêt à les gérer.

Bus de messages asynchrone

Le MID Server s’abonne aux messages publiés par Asynchronous Message Bus (AMB), qui informe le MID Server 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 MID Server, ce dernier définit l’état sur « En cours de traitement ». Lorsqu’il a fini de travailler sur une tâche demandée, le MID Server envoie un rapport à la file d’attente ECC avec les résultats.

Le MID Server ouvre une connexion persistante à 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 MID Server. Le MID Server reçoit ce message et interroge immédiatement la table de ecc_queue pour le travail, sauf si le MID Server 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 Server 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 au cas où la connexion AMB serait abandonnée.

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

Remarque :

Le client AMB sur le MID Server ne fonctionne pas dans tous les environnements et doit peut-être ê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 MID Server ne reçoit plus de notifications pour chaque nouvel enregistrement de sortie de file d’attente ECC. Voir mid.poll.time dans Paramètres du MID Server pour plus d’informations.

Informations sur la file d’attente ECC

Vous pouvez accéder à la file d’attente ECC via l’un de ces chemins :

Détection > Résultats et artefacts > File d'attente ECC
Détection > Calendriers de Détection > {nom du calendrier} > {Enregistrement de l’état de détection}
ECC > File d'attente
{Enregistrement d’état de détection} > 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ù provient ou de destination ce message. Si le message provient de ou à destination d’un MID Server, le nom de l’agent est de la forme `mid.server.xxx`, où xxx est le nom d’un MID Server particulier.
Sujet	Nom de la sonde exécutée par le MID Server. Si vous utilisez un modèle pour la détection, la sonde Modèle horizontal La sonde Modèle horizontal s’affiche.
Nom	Commande active exécutée par la sonde. Par exemple, si la rubrique est SSHCommand, le champ Nom contient la commande shell active à exécuter. Si vous utilisez un modèle de détection, les éléments suivants s’affichent : Lanceur de modèle : suivi du nom du modèle et du numéro multipage.
Source	Adresse IP sur laquelle la détection doit s’exécuter. 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. Discovery fait un usage intensif de ce champ pour suivre la hiérarchie des messages résultant d’une détection planifiée donnée. Cliquez sur l’icône d’enregistrement de la valeur dans ce champ pour ouvrir l’enregistrement File d’attente ECC pour l’activité qui a généré 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 renvoyé a une balise racine `de < résultats >` contenant une ou plusieurs balises `<result>` 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 de nouveau	Exécute à nouveau la sonde. Vous pouvez réexécuter les sondes en cas d’échec de détection ou d’autres résultats inattendus.
Accéder à l'élément CMDB	Ouvrez l’enregistrement CI du CI qui a été mis à jour lors de la détection.
Accéder au capteur	Ouvrez l’enregistrement du capteur associé.

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 MID Server et de récupérer des statistiques à partir d’un enregistrement individuel du MID Server.

Avant de commencer

Rôle requis : admin, mid_server

Procédure

Envoyez des commandes distantes via un MID Server à un appareil d’hébergement directement à partir de la file d’attente ECC sans exécuter Détection.
1. Accédez à la file d’attente ECC et cliquez sur Nouveau.
2. Créez un message avec ces paramètres :
  - Agent : nom du MID Server qui exécute la commande.
  - Sujet : Commande
  - Nom : commande 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>
```
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 MID Server individuel.
1. Ouvrez un enregistrement de MID Server.
2. Sous Liens connexes, cliquez sur Récupérer 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] [SystemCommand]
  - [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éé .
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 MID Server.
2. Sous Related Links (Liens connexes), cliquez sur MID Statistics (Statistiques MID).
  Les enregistrements de file d’attente ECC apparaissent dans la liste à l’aide du filtre suivant :
  - [Sujet] [est] [files d’attente.stats]
  - [Agent] [est] [votre MID Server]