L'adaptateur de journal générique fournit une classe Outputter qui permet l'envoi des objets CBE générés par l'adaptateur à un agent de consignation. Vous pouvez utiliser l'analyseur de trace et de journaux pour l'association à l'agent de consignation ainsi que pour contrôler et pour analyser le journal de l'application en temps réel.
Conditions prérequises :Pour configurer l'adaptateur en vue de la surveillance, procédez comme indiqué ci-après.
Remarque : lorsqu'il est créé, le fichier de
configuration d'adaptateur est configuré pour utiliser la
classe CBELogOutputter par défaut. Si vous n'avez pas modifié ce
paramètre, vous pouvez ignorer cette procédure.
Il est nécessaire de mettre à jour le composant Outputter du fichier
de configuration d'adaptateur pour qu'il utilise la classe
CBELogOutputter, qui écrit les objets CBE sur un agent de
consignation. Vous pouvez soit mettre à jour le composant Outputter
existant, soit ajouter un nouveau composant Outputter.
Pour ajouter un nouveau composant Outputter :
Nom : | Nom du module Outputter dans le contexte |
Description : | Description de la fonction du module Outputter |
Classe de l'exécutable : | org.eclipse.hyades.logging.adapter.outputters.CBELogOutputter |
Niveau de consignation : | Niveau de consignation interne que le composant Outputter doit utiliser.
Une valeur égale à 99 signifie que le composant Outputter ne consigne aucun message. Une valeur de 0 signifie que le composant Outputter consigne les messages quel que soit leur niveau de sévérité. La valeur conseillée est de 50 et signifie que seuls les messages d'erreurs internes de niveau critique ou fatal du composant Outputter sont consignés. |
Rôle : | Outputter |
ID unique : | Doit pointer vers le module Outputter défini dans l'instance de contexte à l'étape 3. Cliquez sur le bouton Parcourir pour sélectionner l'ID correct. |
.Si vous souhaitez que le programme d'analyse syntaxique de journal surveille le fichier journal en continu, vous devez mettre à jour les propriétés de l'instance de contexte du fichier de configuration d'adaptateur.
L'adaptateur de journal créé peut être exécuté en externe à partir
d'un fichier de commande dans un environnement Windows ou à
partir d'un script shell dans les autres environnements. Vous
trouverez ci-après des exemples de fichiers pouvant être utilisés
pour lancer le processus Java qui exécute l'adaptateur de journal.
Remarque : pour associer et surveiller l'agent de consignation créé par l'adaptateur de journal générique, vous devez installer un Agent Controller Hyades sur le système sur lequel l'adaptateur de journal générique va s'exécuter et il doit être lancé avant que l'adaptateur de journal générique ne soit lancé.
Fichier de commande Windows :
@rem USAGE: runregex @rem BUT : illustre les capacités d'exécution de l'adaptateur de journal générique (GLA) @rem en utilisant un exemple de fichier d'adaptateur et un échantillon de fichier journal. @rem HYPOTHESES : ce fichier de commandes suppose que les fichiers d'exécution du GLA et les fichiers requis @rem sont stockés dans l'arborescence suivante : @rem %GLA_HOME%\config - fichiers de configuration du GLA @rem %GLA_HOME%\lib - fichiers d'exécution du GLA et archives Java requises @rem %GLA_HOME%\schema - fichiers schéma de configuration du GLA @rem INSTRUCTIONS: @rem Si les fichiers d'exécution du GLA et les fichiers requis sont stockés dans l'arborescence indiquée dans @rem la partie Hypothèses, changez la valeur de la variable d'environnement %GLA_HOME% @rem par le chemin d'accès absolu de l'endroit où les fichiers d'exécution du GLA et les fichiers requis @rem sont stockés. @rem Si les fichiers d'exécution du GLA sont stockés dans un environnement plug-in (par ex. Eclipse), @rem effectuez les opérations suivantes : @rem 1) Créez un répertoire temporaire pour stocker les fichiers d'exécution du GLA et les fichiers requis. @rem 2) Créez les répertoires config, lib, et schema dans le répertoire temporaire @rem créé à l'étape 1) @rem 3) Changez la valeur de la variable d'environnement %GLA_HOME% par @rem le chemin d'accès absolu du répertoire temporaire créé à l'étape 1) @rem 4) Copiez les fichiers de l'adaptateur que vous désirez exécuter dans le répertoire %GLA_HOME%\config. @rem Par exemple, si vous désirez exécuter les fichiers de l'adaptateur Apache, copiez le @rem répertoire Apache du plug-in org.eclipse.hyades.logging.adapter.config et @rem son contenu dans le répertoire %GLA_HOME%\config. @rem 5) Copiez le contenu du répertoire schema du plug-in @rem org.eclipse.hyades.logging.adapter dans le répertoire %GLA_HOME%\schema. @rem 6) Copiez les fichiers jar suivants dans le répertoire %GLA_HOME%\lib @rem Plug-in | JAR @rem --------------------------------------------------- @rem org.eclipse.hyades.logging.adapter | hgla.jar @rem org.eclipse.hyades.logging.core | hlcbe101.jar @rem org.eclipse.hyades.logging.core | hlcore.jar @rem org.eclipse.hyades.execution.remote | hexr.jar @rem org.eclipse.emf.ecore | ecore.jar @rem org.eclipse.emf.common | common.jar SET GLA_HOME=d:\GenericLogAdapter SET CONFIG_FILE=%GLA_HOME%\config\my.adapter @PUSHD %GLA_HOME%\config\ java -DGLA_HOME="%GLA_HOME%" -classpath "%GLA_HOME%\lib\hgla.jar;%GLA_HOME%\lib\hexr.jar;%GLA_HOME%\lib\hlcbe101.jar;%GLA_HOME%\lib\ecore.jar;%GLA_HOME%\lib\common.jar;%GLA_HOME%\lib\hlcore.jar" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%" POPDFichier de commande pour des environnements autres que Windows :
#!/bin/sh # USAGE: runregex.sh # BUT : illustre les capacités d'exécution de l'adaptateur de journal générique (GLA) # en utilisant un exemple de fichier d'adaptateur et un échantillon de fichier journal. # HYPOTHESES : ce fichier shell suppose que les fichiers d'exécution du GLA et les fichiers requis # sont stockés dans l'arborescence suivante : # %GLA_HOME%\config - fichiers de configuration du GLA # %GLA_HOME%\lib - fichiers d'exécution du GLA et archives Java requises # %GLA_HOME%\schema - fichiers schéma de configuration du GLA # INSTRUCTIONS: # Si les fichiers d'exécution du GLA et les fichiers requis sont stockés dans l'arborescence indiquée dans # la partie Hypothèses, changez la valeur de la variable d'environnement %GLA_HOME% # par le chemin d'accès absolu de l'endroit où les fichiers d'exécution du GLA et les fichiers requis # sont stockés. # Si les fichiers d'exécution du GLA sont stockés dans un environnement plug-in (par ex. Eclipse) # effectuez les opérations suivantes : # 1) Créez un répertoire temporaire pour stocker les fichiers d'exécution du GLA et les fichiers requis. # 2) Créez les répertoires config, lib, et schema dans le répertoire temporaire # créé à l'étape 1) # 3) Changez la valeur de la variable d'environnement %GLA_HOME% par # le chemin d'accès absolu du répertoire temporaire créé à l'étape 1) # 4) Copiez les fichiers de l'adaptateur que vous désirez exécuter dans le répertoire %GLA_HOME%\config. # Par exemple, si vous désirez exécuter les fichiers de l'adaptateur Apache, copiez le # répertoire Apache du plug-in org.eclipse.hyades.logging.adapter.config et # son contenu dans le répertoire %GLA_HOME%\config. # 5) Copiez le contenu du répertoire schema du plug-in # org.eclipse.hyades.logging.adapter dans le répertoire %GLA_HOME%\schema. # 6) Copiez les fichiers jar suivants dans le répertoire %GLA_HOME%\lib # Plug-in | JAR # --------------------------------------------------- # org.eclipse.hyades.logging.adapter | hgla.jar # org.eclipse.hyades.logging.core | hlcbe101.jar # org.eclipse.hyades.logging.core | hlcore.jar # org.eclipse.hyades.execution.remote | hexr.jar # org.eclipse.emf.ecore | ecore.jar # org.eclipse.emf.common | common.jar GLA_HOME=/home/eclipse/GenericLogAdapter export GLA_HOME CONFIG_FILE="$GLA_HOME/config/my.adapter" export CONFIG_FILE CUR_DIR=`pwd` export CUR_DIR cd "$GLA_HOME/config" java -DGLA_HOME="$GLA_HOME" -classpath "$GLA_HOME/lib/hgla.jar:$GLA_HOME/lib/hexr.jar:$GLA_HOME/lib/hlcbe101.jar:$GLA_HOME/lib/ecore.jar:$GLA_HOME/lib/common.jar:$GLA_HOME/lib/hlcore.jar" org.eclipse.hyades.logging.adapter.Adapter -ac "$CONFIG_FILE" -cc "$CONFIG_FILE" cd "$CUR_DIR"Configurez le fichier de manière appropriée pour lancer le processus Java qui exécutera l'adaptateur.
Vous pouvez maintenant surveiller le journal de l'application.
Concepts connexes
Présentation de l'adaptateur de journal générique
Spécification du format Common Base Event
Tâches connexes
Création d'un programme d'analyse syntaxique de journal
Références connexes
Structure du fichier de configuration d'adaptateur
Editeur de configuration d'adaptateur
Syntaxe d'une expression régulière
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.