Configuration d'un adaptateur pour la surveillance d'une application

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.

Configurer le composant Outputter.

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 :

  1. Pour éditer le fichier de configuration d'adaptateur, sélectionnez-le dans le panneau Navigateur. Cliquez dessus à l'aide du bouton droit de la souris et sélectionnez Ouvrir avec > Editeur de configuration d'adaptateur. Le fichier s'affiche dans l'éditeur.
  2. Dans la fenêtre de l'éditeur de configuration d'adaptateur, développez le noeud Adaptateur > Configuration > Instance de contexte.
  3. A l'aide du bouton droit de la souris, cliquez sur l'instance de contexte et sélectionnez Ajouter > Outputter. Un nouveau module Outputter est créé dans l'instance de contexte.
  4. Dans la zone Type d'outputter, sélectionnez LoggingAgentOutputter.
  5. Cliquez sur la propriété agentName. Les détails correspondants apparaissent dans le panneau de droite.
  6. Mettez à jour la valeur de la propriété en indiquant le nom de l'agent de consignation souhaité. Il s'agit du nom que vous verrez affiché dans l'analyseur de trace et de journaux pour désigner l'agent de consignation à surveiller.
  7. Si vous souhaitez que le module Outputter patiente avant d'écrire les CBE dans l'agent de consignation, ajoutez une propriété appelée waitUntilLoggingTime et indiquez une durée en millisecondes. Pour ajouter la propriété, cliquez à l'aide du bouton droit de la souris sur le module Outputter nouvellement créé et sélectionnez Ajouter > Propriété. Une nouvelle propriété est créée sous le nouveau noeud Outputter.
  8. Pour activer la classe CBELogOutputter, vous devez créer le composant Outputter associé dans l'implémentation du contexte de base des contextes. Ouvrez Contextes > Context Basic Implementation Context.
  9. A l'aide du bouton droit de la souris, cliquez sur Context Basic Implementation Context et sélectionnez Ajouter > Composant. Un nouveau composant s'ajoute au contexte.
  10. Configurez le nouveau composant à l'aide des valeurs suivantes :
    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.
  11. Sauvegardez les modifications apportées au fichier de configuration d'adaptateur.

Configurer l'instance de contexte

.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.

  1. Pour éditer le fichier de configuration d'adaptateur, sélectionnez-le dans la perspective Navigateur. Cliquez dessus à l'aide du bouton droit de la souris et sélectionnez Ouvrir avec > Editeur de configuration d'adaptateur. Le fichier s'affiche dans l'éditeur.
  2. Dans la fenêtre de l'éditeur, sélectionnez Adaptateur > Configuration > Instance de contexte. Les détails correspondants apparaissent dans le panneau de droite.
  3. Cochez la case Opération continue.
  4. Renseignez les zones Délai d'inactivité maximal et Intervalle d'interruption.
  5. Sauvegardez les modifications apportées au fichier de configuration d'adaptateur.

Lancer un processus Java pour exécuter l'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%" 
POPD


Fichier 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.

Surveiller le journal de l'application

Vous pouvez maintenant surveiller le journal de l'application.

  1. Assurez-vous que la consignation est activée dans les préférences.
    1. Dans la barre d'outils principale, sélectionnez Fenêtre > Préférences. L'assistant Préférences apparaît.
    2. Sélectionnez Profilage et consignation dans le panneau de gauche. Les préférences de profilage et de consignation sont chargées dans le panneau de droite.
    3. Sélectionnez Activer la consignation sous Profilage et consignation.

      Consignation activée dans les préférences de profilage et de consignation

    4. Cliquez sur OK pour appliquer les modifications.
  2. Dans la perspective Profilage et consignation, cliquez sur l'icône Profilage Icône Profilage dans la barre d'outils et sélectionnez Profiler. L'assistant Profiler apparaît.
  3. Sélectionnez Connexion - Processus Java et cliquez sur le bouton Nouveau situé au bas de la liste. Une nouvelle configuration de processus Java est créée.
  4. Cliquez sur l'onglet Hôtes et sélectionnez l'hôte sur lequel réside le journal de l'application.
    Remarque : dans le cadre de la surveillance d'un journal Application, un agent Controller doit être exécuté sur le même système que l'application.
  5. Cliquez sur l'onglet Agents et utilisez les touches fléchées pour sélectionner l'agent de consignation que vous avez configuré.

    Dans l'assistant de préférences de profilage, l'agent de consignation que l'utilisateur a créé se trouve dans le panneau gauche.

  6. Cliquez sur Appliquer.
  7. Cliquez sur Profiler pour effectuer l'association à l'agent de consignation.
  8. Dans la perspective Profilage et consignation de la vue Moniteur de profilage, sélectionnez l'agent de consignation.
  9. A l'aide du bouton droit de la souris, cliquez sur l'agent et sélectionnez Lancer la surveillance.
  10. A l'aide du bouton droit de la souris, cliquez sur l'agent et sélectionnez Ouvrir avec > Vue Journal. Les événements du journal figurant dans le journal de l'application sont chargés dans la vue Journal.
    Remarque : si aucun enregistrement de journal n'est affiché dans la vue Journal, cliquez sur le bouton Actualiser les Vues en haut du panneau Moniteur de profilage.

 

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