Liberty : Journalisation binaire

La journalisation binaire est une fonction de journalisation et de trace à hautes performances qui repose sur la technologie HPEL (High Performance Extensible Logging) de WebSphere Application Server Traditional.

Présentation

Remarque : Vous devez activer la fonction de journalisation binaire pour pouvoir l'utiliser.

La journalisation binaire est un mécanisme pratique de stockage et d'accès aux informations de journal, de trace, System.err et System.out générées par le serveur d'applications ou vos applications. Il s'agit d'une alternative à la fonction de journalisation et de trace par défaut, qui fournit les journaux de la machine virtuelle Java ainsi que les fichiers de trace de diagnostic communément appelés messages.log et trace.log.

Stockage des fichiers journaux et des fichiers de trace

La journalisation binaire fournit un référentiel pour les données de journal et un référentiel pour les données de trace. Reportez-vous à la figure suivante pour comprendre la manière dont les applications et le serveur d'applications stockent les informations de journalisation et de trace.

Stockage de journal et de trace pour la consignation HPEL et de base.

Référentiel des données de journal

Le référentiel de données de journal est une fonction de stockage pour les enregistrements de journal. Les données de journal sont généralement destinées à être vérifiées par des administrateurs. Elles comprennent toutes les informations que les applications ou le serveur écrivent dans System.out, System.err, le service de journalisation OSGi au niveau LOG_INFO ou supérieur (y compris LOG_INFO, LOG_WARNING et LOG_ERROR), ou java.util.logging au niveau Détails ou supérieur (y compris Détail, Config, Info, Audit, Avertissement, Grave et Critique, ainsi que tous les niveaux personnalisés au niveau Détails ou supérieur).

Référentiel des données de trace

Le référentiel de données de trace est une fonction de stockage pour les enregistrements de trace. Les données de trace sont généralement destinées à être utilisées par les programmeurs d'application ou l'équipe de support WebSphere Application Server. Elles comprennent toutes les informations que les applications ou le serveur écrivent dans le service de journalisation OSGi au niveau LOG_DEBUG ou dans java.util.logging à des niveaux inférieurs à Détail (y compris Fin, Plus fin, Le plus fin et tout niveau personnalisé sous le niveau Détail).

Performances de journalisation et de trace

La journalisation binaire a été conçue et testée pour être plus efficace que la fonction de journalisation et de trace par défaut. L'incidence sur les performances de l'exécution du serveur d'applications avec la fonction de trace activée est considérablement améliorée en utilisant la journalisation binaire au lieu de la structure de journalisation et de trace par défaut. En outre, les applications qui écrivent souvent dans les journaux s'exécutent plus rapidement avec la journalisation binaire.

Les événements de journalisation et de trace sont stockés dans un seul emplacement

Les événements de journalisation, System.out et System.err sont stockés dans le référentiel de données de journal. Les événements de trace sont stockés dans le référentiel de données de trace. Le stockage de chaque type d'événement dans un seul endroit garantit que les performances ne sont pas dégradées par un stockage de données redondant.

Remarque : Le journal de la console doit être désactivé si les performances de la journalisation sont une considération importante. Tout contenu écrit dans le journal de la console sera déjà stocké dans le référentiel de données de journal.

Image affichant le serveur d'applications se connectant aux référentiels de données de journal et de trace.

Les données ne sont pas formatées sauf si c'est nécessaire

Le formatage des données pour permettre à un utilisateur de les lire monopolise du temps UC. Au lieu d'être formatées en phase d'exécution, les données de journal et de trace sont stockées plus rapidement dans une représentation binaire propriétaire. Les performances de la fonction de journalisation et de trace sont ainsi améliorées. En différant le formatage des données de journal et de trace jusqu'à l'exécution de la commande binaryLog, les sections du journal ou de la trace qui ne sont jamais affichées ne sont jamais formatées.

Les données de journal et de trace sont placées en mémoire tampon avant d'être écrites sur le disque

L'écriture de grands blocs de données sur un disque est plus efficace que l'écriture de la même quantité de données en blocs plus petits. La fonction de journalisation binaire permet de placer en mémoire tampon les données de journal et de trace avant leur écriture sur le disque. Par défaut, ces données sont stockées dans une mémoire tampon de 8 Ko avant d'être écrites sur le disque. Si la mémoire tampon est remplie dans un intervalle de 10 secondes, la mémoire tampon est écrite sur disque. Si la mémoire tampon n'est pas remplie dans cet intervalle, son contenu est automatiquement écrit sur disque pour garantir que les journaux contiennent les informations les plus à jour.

Administration de la journalisation et la trace

La journalisation binaire a été conçue pour être facile à configurer et à comprendre. Ainsi, des administrateurs peuvent facilement configurer la quantité d'espace disque à dédier aux journaux ou à la trace, ou la durée de conservation des enregistrements de journal et de trace, et laisser la gestion du contenu de journalisation et de trace au serveur. Comme autre exemple, tout le contenu de journal, de trace, de System.out et de System.err est accessible à l'aide d'une commande facile à utiliser (binaryLog), ce qui évite toute confusion quant au fichier auquel accéder pour un certain contenu.

Lecture dans les référentiels de données de journal et de données de trace

Les référentiels de données de journal et de données de trace sont stockés dans un format propriétaire de WebSphere Application Server et ne peuvent pas être lus à l'aide d'éditeurs de fichier texte comme Notepad ou VI. Vous pouvez copier les référentiels des données de journal et de trace dans un format texte ordinaire en utilisant la commande binaryLog.

Image illustrant l'afficheur de journal qui extrait des données des référentiels de données de journal et de trace dans un journal au format texte.
La commande binaryLog

La commande binaryLog est un outil de ligne de commande facile à utiliser fourni pour aider les utilisateurs à gérer les référentiels de données de journal et de données de trace. Elle propose des options de filtrage et de formatage qui facilitent la recherche de contenu important dans les référentiels de données de journal et de données de trace. Par exemple, un utilisateur peut filtrer les erreurs et les avertissements, puis filtrer toutes les entrées de journal et de trace générées à moins de 10 secondes d'un message d'erreur clé de la même unité d'exécution.

Filtrage à l'aide du contenu des extensions d'enregistrement de journal et de trace

La fonction de journalisation binaire permet aux développeurs d'ajouter des extensions personnalisées aux enregistrements de journal et de trace à l'aide d'une API de contexte d'enregistrement de journal (com.ibm.websphere.logging.hpel.LogRecordContext). Vous pouvez utiliser l'outil de ligne de commande binaryLog pour filtrer les enregistrements en fonction du contenu des extensions d'enregistrement de journal et de trace.

Ressources de développement

La journalisation binaire a été conçue pour rendre l'utilisation du contenu de journal et de trace plus souple et plus efficace que via la fonction de journalisation par défaut. Le contenu de journalisation et de trace peut être facilement filtré pour n'afficher que les enregistrements qui vous intéressent. Vous pouvez utiliser la ligne de commande (voir la description de la commande binaryLog), ou les développeurs peuvent créer des programmes de traitement de journal puissants à l'aide de l'API HPEL.

Image illustrant les référentiels de données de journal et de trace se connectant à l'API com.ibm.websphere.logging.hpel.
Lecture des données de journal et des données de trace

Une API a été mise à disposition pour permettre aux développeurs de développer facilement des outils afin de consommer le contenu des référentiels de journalisation binaire et de trace. Par exemple, un développeur peut écrire un programme Java™ pour rechercher dans le contenu de journalisation et de trace les messages dont les ID correspondent à une liste connue d'ID de messages importants. Cette API se trouve dans le package com.ibm.websphere.logging.hpel. Pour plus d'informations sur l'API de lecture de journal HPEL, reportez-vous à la documentation sur les API.

Extensibilité d'enregistrement de journal et de trace

Les développeurs peuvent ajouter des extensions personnalisées aux enregistrements de journal et de trace par le biais d'une API de contexte d'enregistrement de journal (com.ibm.websphere.logging.hpel.LogRecordContext). Lorsque la journalisation binaire stocke des enregistrements de journal et de trace, elle inclut toutes les extensions présentes dans le contexte d'enregistrement de journal sur la même unité d'exécution. Par exemple, un développeur peut écrire un filtre de servlet pour ajouter des paramètres de requête HTTP importantes dans le contexte d'enregistrement de journal. Lors de l'exécution de ce servlet, l'API HPEL ajoute ces extensions dans tous les enregistrements de journal et de trace créés sur la même unité d'exécution.

Comme pour les autres zones d'enregistrement de journal et de trace, les développeurs peuvent accéder aux extensions d'enregistrement à l'aide de l'API HPEL. Cela est utile lors de l'écriture d'outils de lecture à partir de référentiels de journal et de trace. Les développeurs peuvent également utiliser l'API de contexte d'enregistrement de journal pour accéder, au moment de l'exécution, aux extensions figurant dans les gestionnaires, filtres et formateurs de journaux personnalisés.


Icône indiquant le type de rubrique Rubrique de concept



Icône d'horodatage Dernière mise à jour: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwlp_HPELOverview
Nom du fichier : cwlp_HPELOverview.html