Journal binaire Session Initiation Protocol (SIP) et extensions de trace dans Liberty

La journalisation binaire permet aux développeurs d'ajouter des zones d'extension pour des enregistrements de journal et de trace. Vous pouvez aussi l'utiliser pour filtrer les enregistrements de journal et de trace par valeur d'extension.

Les enregistrements de journal et de trace comportent des zones destinées à des informations telles que l'heure de création de l'enregistrement et le contenu du message journalisé. Ces zones sont essentielles et elles sont présentes dans n'importe quel enregistrement de journal et de trace. Par ailleurs, les zones d'extension sont des zones que les développeurs d'application peuvent ajouter aux enregistrements de journal et de trace, que vous pouvez utiliser comme critères de filtre lors de la recherche d'un contenu de journal et de trace spécifique. Ces extensions de journal et de trace sont visibles dans le journal binaire lors de la configuration du format de sortie de texte à utiliser pour le format avancé. Elles sont également visibles lors de l'utilisation de la commande binaryLog dans le format avancé.

Administrateurs

Le serveur d'application crée automatiquement un certain nombre d'extensions que vous pouvez utiliser pour filtrer les enregistrement de journal et de trace. Vous pouvez aussi filtrer les enregistrement de journal et de trace à l'aide d'extensions qui sont ajoutées par vos développeurs d'applications. Vous pouvez utiliser l'outil de ligne de commande binaryLog pour filtrer les enregistrements à partir du contenu des extensions d'enregistrement de journal et de trace. Pour plus d'informations, voir Options de la commande BinaryLog.

Par exemple, pour voir toutes les sessions d'application SIP traitées par le conteneur SIP, vous pouvez utiliser la commande binaryLog suivante :
binaryLog view binaryFile --includeExtension=SIPASId=* --format=advanced
Développeurs

Les développeurs peuvent utiliser la journalisation binaire pour 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, vous pouvez écrire un filtre de servlet pour ajouter des paramètres de requête HTTP importants 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. Cette API 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.

Le tableau ci-après décrit les extensions de journal et de trace, y compris l'identificateur que vous pouvez utiliser pour filtrer les différents aspects de la trace.

Tableau 1. Extensions de journal et de trace
Extension Description
appName

Indique le nom de l'application Java™ Platform, Enterprise Edition (Java EE) auquel est relié, le cas échéant, l'enregistrement de journal ou de trace.

requestID

Indique l'ID unique de la demande à laquelle est relié, le cas échéant, l'enregistrement de journal ou de trace. Pour que le serveur d'application ajoute l'extension requestID aux enregistrements de journal ou de trace, vous devez activer Cross Component Trace (XCT), également référencé dans la console d'administration en tant que corrélation de journal et de trace. Les identificateurs de demande ne sont ajoutés que pour certains types de demande, comme les demandes HTTP ou JMS.

SIPCallId

Spécifie l'identificateur d'appel SIP qui est traité par le serveur proxy SIP ou le conteneur SIP. Ces informations sont communes sur les serveurs proxy SIP et les conteneurs SIP. Vous pouvez utiliser cette extension pour suivre le flux d'appel SIP dans différents environnements. Le serveur proxy SIP et le conteneur SIP ajoutent automatiquement cet identificateur à chaque enregistrement de journal et de trace lorsque la consignation HPEL est activée.

SIPASId

Spécifie l'ID de session d'application SIP qui est traité par le conteneur SIP. Ces informations sont communes sur les conteneurs SIP. Vous pouvez utiliser cette extension pour suivre le flux d'appel SIP. Le conteneur SIP ajoute automatiquement cet identificateur à chaque enregistrement de journal et de trace lorsque la consignation HPEL est activée.

 SIPSessionId

Spécifie l'ID de session d'application SIP qui est traité par le conteneur SIP. Ces informations sont communes sur les conteneurs SIP. Vous pouvez utiliser cette extension pour suivre le flux d'appel SIP. Le conteneur SIP ajoute automatiquement cet identificateur à chaque enregistrement de journal et de trace lorsque la consignation HPEL est activée.

SIPCallId2

Spécifie le second ID d'appel SIP qui est associé à la même session d'application SIP et qui est traité par le conteneur SIP. Ces informations sont communes sur les conteneurs SIP. Vous pouvez utiliser cette extension pour suivre le flux d'appel SIP. Le conteneur SIP ajoute automatiquement cet identificateur à chaque enregistrement de journal et de trace lorsque la consignation HPEL est activée.

Si plus de deux ID d'appel SIP sont associés à une seule session d'application SIP, seuls les deux premiers ID sont enregistrés. Les ID additionnels ne sont pas enregistrés.

SIPSessionId2

Spécifie le second ID de session SIP qui est associé à la même session d'application SIP et qui est traité par le conteneur SIP. Ces informations sont communes sur les conteneurs SIP. Vous pouvez utiliser cette extension pour suivre le flux d'appel SIP. Le conteneur SIP ajoute automatiquement cet identificateur à chaque enregistrement de journal et de trace lorsque la consignation HPEL est activée.

Si plus de deux ID de session SIP sont associés à une seule session d'application SIP, seuls les deux premiers ID sont enregistrés. Les ID additionnels ne sont pas enregistrés.

thread

Spécifie le nom d'unité d'exécution de la de la demande à laquelle est associé chaque enregistrement de journal ou de trace.


Icône indiquant le type de rubrique Rubrique de référence



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=rwlp_sip_logtraceextensions
Nom du fichier : rwlp_sip_logtraceextensions.html