Configuration du traçage et de la journalisation des fonctions dans Liberty
Vous pouvez utiliser le mécanisme de traçage et de journalisation de Liberty pour les fonctions Liberty. Le service de journalisation fait partie du noyau Liberty ; par conséquent, il n'est pas nécessaire de spécifier une fonction dans votre fichier server.xml pour pouvoir l'utiliser.
Pourquoi et quand exécuter cette tâche
Liberty fournit les interfaces SPI suivantes pour intégrer le traçage et la journalisation à votre code de fonction personnalisé :
- com.ibm.websphere.ras
- Le package com.ibm.websphere.ras fournit des classes pour la journalisation des messages et des enregistrements de trace, ainsi que des points d'extension. En général, le code de la fonction peut utiliser le package java.util.logging pour journaliser la trace et les messages, et pour contrôler la sortie via la configuration de journalisation Liberty ; toutefois, la capacité étendue du package WebSphere est parfois utile et les protections des données sensibles dans la trace sont légèrement plus efficaces lorsque la trace est désactivée.
- com.ibm.websphere.ras.annotations
- Le package com.ibm.websphere.ras.annotations fournit des annotations pouvant être utilisées avec des classes dans d'autres packages. Par exemple, une annotation @Sensitive peut être utilisée pour empêcher le contenu de la variable annotée d'apparaître dans la sortie de trace ou de message.
- com.ibm.ws.ffdc
- Le package com.ibm.ws.ffdc fournit des fonctions permettant d'écrire des enregistrements d'outil de diagnostic de premier niveau pour contribuer au débogage des exceptions inattendues.
- com.ibm.wsspi.logging
- Le package com.ibm.wsspi.logging fournit des points d'interception d'enregistrements de journal et ffdc.
La documentation d'API Java™ pour chaque interface SPI Liberty est disponible dans un fichier .zip distinct dans l'un des sous-répertoires javadoc du répertoire ${wlp.install.dir}/dev.
Procédure
Les étapes suivantes permettent de configurer un exemple de fonction Liberty appelé myfeature afin d'utiliser le mécanisme de traçage et de journalisation de Liberty :