Surveillance de données à l'aide d'un socket

Vous pouvez définir une source de données pour qu'elle collecte les données d'une application externe à l'aide d'un socket TCP. L'application doit établir la connexion TCP à l'agent et envoyer les données au format XML structuré. Selon l'application, la source de données peut produire un ensemble de données comprenant une ligne, plusieurs lignes ou des données d'événement.

Pourquoi et quand exécuter cette tâche

Utilisez la source de données du socket pour fournir des données à l'agent à partir d'une application externe qui s'exécute sur le même système que l'agent. L'application externe peut envoyer des données à l'agent à tout moment. Par exemple, vous pouvez développer une interface de ligne de commande qui permet à un utilisateur de publier des données dans un groupe d'attributs lors de son exécution. L'autre option consiste à modifier une application surveillée de manière à envoyer des mises à jour à l'agent. L'agent ne démarre pas ou n'arrête pas l'application qui envoie des données au socket ; cette opération est contrôlée par l'utilisateur.

Il existe certaines limitations avec la source de données du socket :

Par défaut, vous ne pouvez établir des connexions qu'à l'hôte local (127.0.0.1). Pour plus d'informations sur la façon de configurer votre agent pour accepter les connexions à partir d'un hôte distant, voir Connexion de port de socket distant.
L'interface de programme d'application du socket n'intègre aucun mécanisme permettant au client de déterminer quels sous-noeuds sont disponibles. Le client peut envoyer des données pour un sous-noeud spécifique, mais il doit déjà connaître le nom du sous-noeud.

Pour créer un groupe d'attributs afin de collecter des données à l'aide d'un socket TCP (Transmission Control Protocol), procédez comme suit.

Procédure

Sur la page Source de données initiale de l'agent ou Emplacement de la source de données, cliquez sur Programmes personnalisés dans la zone Catégories de données de surveillance.
Dans la zone Sources de données, cliquez sur Socket.
Cliquez sur Suivant.
Dans la page Informations relatives au socket, entrez un nom de groupe d'attributs.
Entrez un texte d'aide pour le groupe d'attributs.
Indiquez si le groupe d'attributs Génère une ligne de données unique, Peut générer plusieurs lignes de données ou Génère des événements. Pour plus d'informations, voir Envoi de données.
Dans la section Informations relatives au socket, sélectionnez une page de codes. Pour plus d'informations, voir Jeux de caractères.
Facultatif : Cliquez sur Avancé pour modifier les propriétés avancées du groupe d'attributs. L'option Avancé est active lorsque vous indiquez que le groupe d'attributs Peut générer plusieurs lignes de données ou Génère des événements.
Cliquez sur Suivant.
Sur la page Informations d'attribut, indiquez le premier attribut du groupe d'attributs. Pour plus d'informations sur la création d'attributs, voir Création d'attributs.
Cliquez sur Suivant.
Facultatif : Sur la page Informations globales relatives à la source de données du socket, dans la section des codes d'erreur, vous pouvez définir les codes d'erreur que le client du socket peut envoyer lorsqu'il n'arrive pas à collecter des données. Pour plus d'informations, voir Envoi d'erreurs au lieu de données. Pour définir un code d'erreur, procédez comme suit :
1. Dans la section des codes d'erreur, cliquez sur Ajouter. Un code d'erreur est limité à 256 caractères. Seuls les lettres, les chiffres et les traits de soulignement ASCII sont admis. Les espaces ne sont pas autorisés.
2. Dans la fenêtre Définition du code d'erreur du socket, entrez la valeur qui s'affichera dans le groupe d'attributs Statut de l'objet de performances.
3. Entrez une valeur interne. La valeur interne doit être un entier compris entre 1 000 et 2 147 483 647.
4. Vous devez définir un texte de message pour chaque erreur. Vous pouvez utiliser un texte précédemment entré en le sélectionnant dans la liste. Cliquez sur OK pour revenir à la page Informations globales relatives à la source de données du socket. Le texte du message est utilisé dans le fichier journal de l'agent.
  Si aucun texte de message approprié n'est disponible, cliquez sur Parcourir pour définir le texte du message. La fenêtre (liste) Messages s'ouvre. La zone de messages montre les messages définis dans l'agent. La liste reste vide jusqu'à ce que vous définissiez des messages. Vous pouvez utiliser Modifier pour modifier un message défini et Supprimer pour supprimer un ou plusieurs messages que vous avez définis.
5. Dans la fenêtre (liste) Messages, cliquez sur Ajouter pour afficher une fenêtre Définition de message. Dans la fenêtre Définition de message, tapez le texte indiquant la signification du nouveau message et sélectionner le type du message.
  Remarque : L'identificateur de message est automatiquement généré pour vous.
6. Cliquez sur OK.
7. La fenêtre (liste) Messages s'affiche avec le nouveau message. Pour vérifier le message et revenir à la page Informations globales relatives à la source de données du socket, cliquez sur OK.

Facultatif : Dans la section Fichiers supplémentaires de la page Informations globales relatives à la source de données du socket, vous pouvez ajouter des fichiers qui sont intégrés à l'agent. Ces fichiers sont copiés dans le système d'agent une fois l'agent installé.

La colonne Type de fichier décrit comment chaque fichier doit être utilisé. Trois utilisations possibles sont décrites dans le tableau suivant :

Tableau 1. Types des fichiers supplémentaires
Type de fichier	Description
Exécutable	Sélectionnez cette option pour inclure un fichier exécutable à l'agent. L'agent n'utilise pas ces fichiers.
Bibliothèque	Sélectionnez cette option si vous voulez inclure une bibliothèque à l'agent. L'agent n'utilise pas ces fichiers.
Ressource Java™	Sélectionnez cette option pour inclure des ressources Java à l'agent. L'agent n'utilise pas ces fichiers.

Pour plus d'informations sur l'emplacement où sont installés les fichiers supplémentaires avec l'agent, voir (Nouveaux fichiers sur votre système).

Cliquez sur Modifier pour modifier le fichier importé. Pour plus d'informations, voir Modification d'une définition de fichier de commandes.

Facultatif : Vous pouvez tester ce groupe d'attributs en cliquant sur Tester. Pour plus d'informations sur le test, voir Test des groupes d'attributs de socket.
Facultatif : Si la source de données est échantillonnée, vous pouvez créer un filtre pour limiter les données renvoyées par ce groupe d'attributs en cliquant sur Avancé. La source de données est échantillonnée si vous n'avez pas sélectionné "Génère des événements" dans la page Informations relatives au socket. Pour plus d'informations sur le filtrage de données à partir d'un groupe d'attributs, voir Filtrage des groupes d'attributs.
Effectuez l'une des opérations suivantes :
1. Si vous utilisez l'assistant d'agent, cliquez sur Suivant.
2. Cliquez sur Terminer pour sauvegarder la source de données et ouvrir l'éditeur d'agent.
  Sélectionnez les systèmes d'exploitation sur lesquels l'agent est en écoute des données provenant des clients du socket dans la section Systèmes d'exploitation de la page Paramètres du fournisseur du socket. Pour ouvrir cette page, cliquez sur Paramètres du fournisseur du socket dans la vue Structure ou sur Paramètres globaux dans l'éditeur d'agent de n'importe quelle page de groupe d'attributs du socket.
  Remarque : Les codes d'erreurs et les fichiers supplémentaires peuvent être mis à jour dans les sections Codes d'erreur et Fichiers supplémentaires de la page Paramètres du fournisseur du socket.