Configuración de rastreo y registro para características en Liberty

Puede utilizar el mecanismo de rastreo y registro de Liberty para características Liberty. El servicio de registro forma parte del kernel de Liberty, de forma que no tiene que especificar una característica en el archivo server.xml para utilizarla.

Acerca de esta tarea

Liberty proporciona las SPI siguientes para integrar el rastreo y el registro en el código de característica personalizado:
com.ibm.websphere.ras
El paquete com.ibm.websphere.ras proporciona clases para registrar registros de mensajes y rastreo, así como algunos puntos de extensión. En general, el código de característica puede utilizar el paquete java.util.logging para registrar el rastreo y mensajes, y para controlar la salida a través de la configuración del registro de Liberty pero, a veces, la prestación ampliada del paquete WebSphere es útil y las protecciones de rastreo son ligeramente más eficientes cuando el rastreo está inhabilitado.
com.ibm.websphere.ras.annotations
El paquete com.ibm.websphere.ras.annotations proporciona anotaciones para utilizarlas con las clases de los otros paquetes. Por ejemplo, una anotación @Sensitive se puede utilizar para impedir que aparezca el contenido de la variable anotada en la salida de rastreo o de mensaje.
com.ibm.ws.ffdc
El paquete com.ibm.ws.ffdc proporciona recursos para grabar los registros de captura de datos en primer error (first failure data capture, FFDC) para ayudar a depurar las excepciones inesperadas.
com.ibm.wsspi.logging
El paquete com.ibm.wsspi.logging proporciona puntos de intercepción de registros de anotaciones y ffdc.

La documentación de la API Java™ de cada SPI de Liberty está disponible en un archivo .zip separado en uno de los subdirectorios javadoc del directorio ${wlp.install.dir}/dev.

Procedimiento

Los pasos siguientes le muestran cómo configurar una característica Liberty de ejemplo, llamada myfeature, para utilizar el mecanismo de rastreo y registro de Liberty:

  1. Especifique la ubicación del archivo de mensaje para la característica myfeature y el nombre del grupo que necesita la clase com.ibm.websphere.ras.TraceComponent.
    import java.util.ResourceBundle;
    
    public class myFeatureConstants {
    
        public static final String TR_RESOURCE_BUNDLE = 
            "com.mycompany.myFeature.internal.resources.FeatureMessages";
    
        public static final String TR_GROUP = "myFeature";
    
        public static final ResourceBundle messages = ResourceBundle.getBundle(TR_RESOURCE_BUNDLE);
    
    }
  2. En la clase de implementación del código de servicio de característica, llame al método register() de la clase com.ibm.websphere.ras.TraceComponent para registrar la clase de implementación con el gestor de rastreo que proporciona Liberty. A continuación, puede configurar el gestor de rastreo para realizar un seguimiento de los métodos de DS de la característica.
    ...
    import com.ibm.websphere.ras.Tr;
    import com.ibm.websphere.ras.TraceComponent;
    
    
    public class myFeatureServiceImpl {
    
        private static final TraceComponent tc = Tr.register(myFeatureServiceImpl.class);
    
    
        protected void activate(ComponentContext cc, Map<String, Object> newProps) {
            if (tc.isDebugEnabled()) {
                Tr.debug(tc, "myFeatureComponentImpl activated"); }
    ...
  3. Utilice la anotación TraceOptions para especificar el nombre del grupo de rastreo y el nombre del paquete de mensajes.
    @TraceOptions(traceGroup = myFeatureConstants.TR_GROUP, messageBundle = 
        myFeatureConstants.TR_RESOURCE_BUNDLE)
    package com.mycompany.myFeature;
    
    import com.ibm.websphere.ras.annotation.TraceOptions;
    import com.mycompany.myfeature.internal.myFeatureConstants;
    ...

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_feat_logging.html