L'analyseur de traces et de journaux fournit un support plug-in autonome pour les utilitaires de journalisation suivants :
Ce support implique :
Ce support est fourni par les plug-ins suivants :
Utilitaire de journalisation |
Archive Java du plug-in |
---|---|
Consignation Java (JSR-047) |
org.eclipse.hyades.logging.core\hl14.jar |
Consignation Apache Jakarta Commons |
org.eclipse.hyades.logging.core\hlcommons.jar |
Consignation Apache Jakarta Log4J |
org.eclipse.hyades.logging.core\hllog4j.jar |
EMF Common Base Event version 1.0.1 |
org.eclipse.hyades.logging.core\hlcbe101.jar |
Vous trouverez ci-dessous les détails de chaque type d'utilitaire de consignation, ainsi que des pointeurs vers des exemples d'utilisation.
Une extension de la classe java.util.logging.LogRecord dans le package org.eclipse.hyades.logging.java14 permet de créer un enregistrement de journal personnalisé pour la consignation d'un événement org.eclipse.hyades.logging.events.cbe.CommonBaseEvent dans un enregistrement de journal java.util.logging.LogRecord. Cet enregistrement de journal org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord est une extension de l'enregistrement java.util.logging.LogRecord et fait référence à un événement org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Toutes les propriétés de l'enregistrement de journal java.util.logging.LogRecord sont mappées sur les propriétés de un ou plusieurs événements CBE afin de maintenir la réflexivité pour les gestionnaires et les formateurs conscients de leur environnement et non associés à un événement CBE.
L'implémentation de l'interface java.util.logging.Filter dans le package org.eclipse.hyades.logging.java14 uniquement permet la consignation réussie des enregistrements de journaux org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord.
L'extension de la classe abstraite java.util.logging.Formatter dans le package org.eclipse.hyades.logging.java14 vous permet de configurer les gestionnaires afin qu'ils puissent formater en XML les messages de journal org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord et java.util.logging.LogRecord. Ce formateur org.eclipse.hyades.logging.java14.XmlFormatter convertit au format XML le message de journal org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord ou java.util.logging.LogRecord en fonction du schéma de Common Base Event version 1.0.1. Au cours du formatage, on vérifie que le message de journal implémente l'interface org.eclipse.hyades.logging.core.IExternalizableToXml (par exemple org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Si tel est le cas, l'API (interface de programmation d'application) externalizeCanonicalXmlString() est appelée à la place de la sérialisation XML. Sinon, le message de journal java.util.logging.LogRecord est converti en un objet Common Base Event en utilisant le même mappage que pour l'événement CBE org.eclipse.hyades.logging.events.cbe.CommonBaseEvent et est sérialisé en XML en faisant appel à l'API externalizeCanonicalXmlString().
L'extension de la classe abstraite java.util.logging.Handler
dans le package org.eclipse.hyades.logging.java permet de configurer les consignateurs afin qu'ils puissent effectuer la consignation des messages de journal
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent et
java.util.logging.LogRecord à destination d'un agent.
Ce gestionnaire org.eclipse.hyades.logging.java.LoggingAgentHandler vérifie si le message de journal org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord ou java.util.logging.LogRecord enregistré dans le consignateur peut être consigné en fonction du filtre du gestionnaire ou du consignateur et du niveau de consignation. Si le message du journal doit être consigné, un agent de consignation est créé avec le même nom que celui du consignateur qui consigne le message. Sinon, vous pouvez faire appel au gestionnaire org.eclipse.hyades.logging.java.SingleLoggingAgentHandler, qui crée un agent de consignation et qui est nommé Gestionnaire de l'Agent de Consignation. Le message est formaté en XML à l'aide de org.eclipse.hyades.logging.java.XmlFormatter et enregistré dans un agent de consignation.
Exemple explicatif
Cet exemple montre comment tirer le meilleur parti du support de consignation Java JSR-047 en illustrant la configuration et l'instrumentation nécessaires aux nouveaux utilisateurs du support plug-in autonome pour la consignation. Pour plus d'informations, cliquez sur Fichier > Nouveau > Exemple... > Exemple de consignation JSR-047.
L'implémentation de l'interface org.apache.commons.logging.Log dans le package org.eclipse.hyades.logging.commons vous permet de créer un consignateur pour la consignation des messages org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object et java.lang.Throwable. Ce consignateur org.eclipse.hyades.logging.commons.Logger vérifie si le message du journal org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ou java.lang.Throwable peut être consigné en fonction de son niveau de consignation. Si le message peut être consigné, le message de journal org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ou java.lang.Throwable est formaté et consigné. L'implémentation de la classe abstraite org.apache.commons.logging.LogFactory représente la fabrique proxy spécifique aux instances org.eclipse.hyades.logging.commons.Logger. Cette fabrique proxy org.eclipse.hyades.logging.commons.LoggerFactory est utile en cas de chargeurs de classes multiples, pour lesquels un ou plusieurs types de consignateurs et de fabriques sont nécessaires pour chaque classe du chargeur, tou(te)s utilisant les mêmes fichiers binaires Apache Commons.
Le consignateur org.eclipse.hyades.logging.commons.Logger formate en XML les messages de journal org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object et java.lang.Throwable en fonction du schéma Common Base Event version 1.0.1. Au cours du formatage, on vérifie que le message du journal implémente l'interface org.eclipse.hyades.logging.core.IExternalizableToXml interface (par exemple, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Si tel est le cas, l'API (interface de programmation d'application) externalizeCanonicalXmlString() est appelée à la place de la sérialisation XML. Sinon, le message de journal java.lang.Object ou java.lang.Throwable est converti en un objet Common Base Event à l'aide des méthodes org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() puis est sérialisé en XML à l'aide de l'API externalizeCanonicalXmlString().
Le consignateur org.eclipse.hyades.logging.commons.Logger enregistre les messages de journal org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object et java.lang.Throwable dans un agent de consignation. Si le message du journal doit être consigné, un agent de consignation est créé avec le même nom que celui du consignateur qui consigne le message. Le message est formaté en XML et enregistré dans l'agent de consignation.
L'implémentation de l'interface org.apache.commons.logging.Log dans le package org.eclipse.hyades.logging.commons pour permet de créer un consignateur pour la consignation des messages de journal org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object et java.lang.Throwable dans un fichier local. Ce consignateur org.eclipse.hyades.logging.commons.FileLogger vérifie si le message org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ou java.lang.Throwable peut être consigné en fonction de son niveau de consignation. Si le message doit être consigné, le message de journal org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ou java.lang.Throwable est formaté en XML et consigné dans un fichier local. L'implémentation de la classe abstraite org.apache.commons.logging.LogFactory représente la fabrique proxy spécifique aux instances org.eclipse.hyades.logging.commons.FileLogger. Cette fabrique proxy org.eclipse.hyades.logging.commons.FileLoggerFactory est utile en cas de chargeurs de classes multiples, pour lesquels un ou plusieurs types de consignateurs et de fabriques sont nécessaires pour chaque classe du chargeur, tou(te)s utilisant les mêmes fichiers binaires Apache Commons.
Exemple explicatif
Cet exemple montre comment tirer le meilleur parti du support de consignation Apache Jakarta Commons en illustrant la configuration et l'instrumentation nécessaires aux nouveaux utilisateurs du support plug-in autonome pour la consignation. Pour plus d'informations, cliquez sur Fichier > Nouveau > Exemple... > Exemple de consignation Apache Commons.
La propriété du message de journal org.apache.log4j.spi.LoggingEvent vous permet de consigner un événement CBE org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Une extension de la classe abstraite org.apache.log4j.spi.Filter dans le package org.eclipse.hyades.logging.log4j uniquement permet la consignation réussie des org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
L'extension de la classe abstraite org.apache.log4j.Layout dans le package org.eclipse.hyades.logging.log4j permet de configurer des annexeurs afin de formater en XML les messages de journal org.eclipse.hyades.logging.events.cbe.CommonBaseEvent et org.apache.log4j.spi.LoggingEvent. Ce formateur org.eclipse.hyades.logging.log4j.XmlLayout convertit en XML le message org.eclipse.hyades.logging.events.cbe.CommonBaseEvent ou org.apache.log4j.spi.LoggingEvent en fonction du schéma Common Base Event version 1.0.1. Au cours du formatage, on vérifie que les propriétés du message de org.apache.log4j.spi.LoggingEvent implémente l'interface org.eclipse.hyades.logging.core.IExternalizableToXml (par exemple, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Si tel est le cas, l'API (interface de programmation d'application) externalizeCanonicalXmlString() est appelée à la place de la sérialisation XML. Sinon, le message de journal org.apache.log4j.spi.LoggingEvent est converti en un objet Common Base Event à l'aide des méthodes org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() puis est sérialisé en XML à l'aide de l'API externalizeCanonicalXmlString().
L'extension de la classe abstraite org.apache.log4j.AppenderSkeleton
dans le package org.eclipse.hyades.logging.log4j permet de configurer les consignateurs afin qu'ils puissent effectuer la consignation des messages de journal
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent et
org.apache.log4j.spi.LoggingEvent à destination d'un agent.
Cet annexeur org.eclipse.hyades.logging.log4j.LoggingAgentAppender vérifie que les messages org.eclipse.hyades.logging.events.cbe.CommonBaseEvent et org.apache.log4j.spi.LoggingEvent peuvent être consignés en fonction du filtre du consignateur et de l'annexeur et du niveau de consignation. Si le message du journal doit être consigné, un agent de consignation est créé avec le même nom que celui du consignateur qui consigne le message. Sinon, vous pouvez faire appel à l'annexeur org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender, qui crée un agent de consignation et qui est nommé Annexeur de l'Agent de Consignation. Le message est formaté en XML à l'aide de org.eclipse.hyades.logging.log4j.XmlLayout et enregistré dans l'agent de consignation.
Exemple explicatif
Cet exemple montre comment tirer le meilleur parti du support de consignation Apache Jakarta Log4J en illustrant la configuration et l'instrumentation nécessaires aux nouveaux utilisateurs du support plug-in autonome pour la consignation. Pour plus d'informations, cliquez sur Fichier > Nouveau > Exemple... > Exemple de consignation Apache Log4J.
Exemple explicatif
Cet exemple montre comment tirer le meilleur parti du support des événements EMF CBE (Common Base Event) en créant et en configurant ces événements à l'aide de la fabrique d'événements du modèle de fichier XML d'événement. Pour plus d'informations, cliquez sur Fichier > Nouveau > Exemple... > Exemple EMF Common Base Event version 1.0.1.
Concepts connexes
Modèle Common Base Event
(C) Copyright IBM Corporation 2000, 2006. Tous droits réservés.