Utilisation de l'exemple de journalisation JSR-047
Cet exemple illustre la prise en charge par TPTP de la journalisation de Common Base Events en utilisant les interfaces de journalisation API JSR-047 implémenté dans JDK 1.4.0 ou supérieur (cf. java.util.logging). Les utilisateurs expérimentent la journalisation de Common Base Events vers la console et un agent de journalisation.
Si vous ne l'avez pas encore fait, créez l'exemple en cliquant sur Fichier >
Nouveau > Exemple... > Exemple de consignation JSR-047.
L'exemple comprend le code source Java et les dépendances (à l'exception des classes java.util.logging) et les fichiers de configuration nécessaires pour consigner les Common Base Events vers un consignateur JSR-047 implémenté dans JDK 1.4.0 ou supérieur (cf. java.util.logging).
Pour compiler et exécuter cet exemple, vous devez posséder JRE 1.4.0, ou une version supérieure (cf.java.util.logging).
Hypothèses
- Au lancement de cette application depuis la perspective Profilage et consignation du plan de travail, le service ou l'application Moteur de collecte de données Hyades sont configurés pour utiliser JRE 1.4.0, ou une version supérieure.
- La variable d'environnement 'java.util.logging.config.file' est affectée du nom et du chemin d'accès absolu (HyadesLoggingJava14Sample.properties) du fichier de configuration de consignation (java.util.logging) JSR-047. Par exemple, <workspace>/LoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties.
Lancement
Pour exécuter cet exemple et définir une liaison vers l'agent de consignation, procédez comme suit :
- Si le JRE par défaut du plan de travail n'est pas une version 1.4.0 ou supérieure, modifiez le nouveau projet Java (CF. LoggingJava14Project) pour compiler et exécuter avec JRE 1.4.0 ou une version supérieure (Projet > Propriétés > Chemin de génération Java > Bibliothèques > JRE_LIB > Supprimer > Ajouter une bibliothèque... > Bibliothèque système JRE > Suivant > Alternate JRE > JRE installés... > Ajouter... > Répertoire initial JRE > Parcourir... > [JRE 1.4.0 ou supérieure] > OK > OK > OK > Terminer > OK).
- Confirmez que toutes les erreurs de compilation ont été corrigées.
- Si vous utilisez une installation autonome du contrôleur d'agent (AC - Agent Controller), vérifiez qu'il est démarré (facultatif). Autrement, vous pouvez utiliser une connexion directe, c'est-à-dire un nombre limité de services AC inclus avec le plan de travail.
- Ouvrez la perspective Profilage et consignation (Fenêtre > Ouvrez la perspective > Autres... > Profilage et consignation).
-
Exécutez l'exemple de classe depuis la perspective Profilage et consignation (Exécuter > Profil... > Créez une configuration de lancement de type
Application Java > Donnez au projet le nom du projet de l'exemple > Définissez la classe Main par 'HyadesLoggingJava14Sample' >
Basculez dans l'onglet Arguments et définissez la propriété JVM suivante :
-Djava.util.logging.config.file="<workspace>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties"
>Basculez dans l'onglet Moniteur > Désélectionnez "Profilage Java" et sélectionnez "Application de recherche de l'agent" > Profil).
- Après quelques secondes, l'agent de consignation doit être automatiquement détecté et connecté. Sélectionnez l'agent de consignation détecté et ouvrez la vue Journal de la perspective Profilage et consignation pour visualiser les enregistrements de journaux Common Base Event (Fenêtre > Afficher la vue > Autres... > Profilage et consignation > Vue Journal > OK).
- Actualisez la vue Journal dans la perspective Profilage et consignation (avec le bouton droit de votre souris, cliquez sur l'agent de consignation 'HyadesLoggingJava14Sample' > Actualiser).
Autrement, pour exécuter cet exemple et établir une liaison manuelle à l'agent de consignation, procédez comme suit :
- Si le JRE par défaut du plan de travail n'est pas une version 1.4.0 ou supérieure, modifiez le nouveau projet Java (CF. LoggingJava14Project) pour compiler et exécuter avec JRE 1.4.0 ou une version supérieure (Projet > Propriétés > Chemin de génération Java > Bibliothèques > JRE_LIB > Supprimer > Ajouter une bibliothèque... > Bibliothèque système JRE > Suivant > Autre JRE > JRE installés... > Ajouter... > Répertoire initial JRE > Parcourir... > [JRE 1.4.0 ou supérieure] > OK > OK > OK > Terminer > OK).
- Confirmez que toutes les erreurs de compilation ont été corrigées.
- Si vous utilisez une installation autonome du contrôleur d'agent (AC - Agent Controller), vérifiez qu'il est démarré (facultatif). Autrement, vous pouvez utiliser une connexion directe, c'est-à-dire un nombre limité de services AC inclus avec le plan de travail.
-
Exécutez l'exemple de classe depuis la perspective Java (Exécuter > Exécuter... > Créez une configuration de lancement de type Application Java >
Classe Main > Chercher... > HyadesLoggingJava14Sample > OK > Basculez dans l'onglet Arguments et définissez la propriété JVM suivante :
-Djava.util.logging.config.file="<workspace>/HyadesLoggingJava14Project/cfg/HyadesLoggingJava14Sample.properties"
> Exécuter).
- Ouvrez la perspective Profilage et consignation (Fenêtre > Ouvrir la perspective > Autres... > Profilage et consignation).
- Créez une liaison vers l'agent de consignation 'HyadesLoggingJava14Sample' dans la perspective Profilage et consignation (Exécuter > Profil... > Connexion - Processus Java > Nouveau > Onglet Hôtes > Utilisez 'Connexion directe locale' si vous n'utilisez pas une installation autonome du contrôleur d'agent (Agent Controller). Autrement, indiquez un nom d'hôte et un numéro de port valides. > Onglet Agents > Faites un double clic sur l'agent HyadesLoggingJava14Sample > Cliquez sur l'onglet Destination > Projet de profilage > Parcourir... > 'HyadesLoggingJava14Sample' > OK > Profil).
- Commencez la surveillance de l'agent de consignation "HyadesLoggingJava14Sample" (<cliquez avec le bouton droit de la souris sur l'agent "HyadesLoggingJava14Sample" > > Lancer la surveillance).
- Ouvrez la vue Journal de la perspective Profilage et consignation pour visualiser les enregistrements de journaux Common Base Event (Fenêtre > Afficher la vue > Autres... > Profilage et consignation > Vue Journal > OK).
- Actualisez la vue Journal de la perspective Profilage et consignation (<cliquez avec le bouton droit de la souris sur l'agent "HyadesLoggingJava14Sample" > > Régénérer).
(C) Copyright IBM Corporation 2000, 2006.