Configuración del rastreo y el registro para las características en el perfil Liberty

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

Acerca de esta tarea

El perfil Liberty proporciona las siguientes SPI 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 anotar el rastreo y los mensajes, y para controlar la salida mediante la configuración del registro cronológico de Liberty, pero la posibilidad ampliada del paquete de WebSphere es a veces útil y las protecciones de rastreo son ligeramente más eficientes cuando está inhabilitado el rastreo.
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™ para cada API de perfil Liberty se detalla en la sección Interfaces de programación (API) del Information Center, y también está disponible como un archivo .zip aparte en uno de los subdirectorios javadoc del directorio ${wlp.install.dir}/dev.

Procedimiento

En los pasos siguientes se muestra cómo configurar una característica de Liberty de ejemplo, denominada myfeature, para utilizar el mecanismo de rastreo y registro cronológico del perfil 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, invoque el 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 el perfil 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

Términos y condiciones para centros de información | Comentarios


Icono de indicación de fecha y hora Última actualización: 15 de junio de 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_feat_logging
Nombre de archivo:twlp_feat_logging.html