Configuración del interceptor de registrador del sistema de archivos de z/OS Connect

El interceptor de registrador del sistema de archivos permite a los usuarios de z/OS Connect registrar información de solicitud en un archivo de sistema de archivos.

Acerca de esta tarea

Esta función está disponible cuando se configuran las características zosConnect-1.0 o zosConnect-1.2 y requiere configuración.

Tabla 1. Descripciones de las entradas que están en el archivo de registro generado
Entrada Descripción
DateTime La fecha y hora que se calcula mediante el interceptor de registrador antes de la invocación de servicio
ThreadID El ID de la hebra bajo el cual se está procesando la solicitud de servicio.
UserName El nombre de usuario para el cual se está procesando la solicitud.
RequestID El ID de rastreo de solicitud generado por z/OS Connect
RemoteAddress La dirección de Protocolo Internet (IP) del cliente que ha originado la solicitud o el último proxy que ha enviado la solicitud
LocalAddress La dirección de Protocolo Internet (IP) de la interfaz en la cual se ha recibido la solicitud
MessageType Identifica si la carga útil procede de una solicitud o una respuesta
MessageSize El tamaño de carácter de la carga útil
MessageData La carga útil de solicitud o respuesta
*****************************************************************************
ServerName: com.ibm.ws.zos.connect.interceptor.logger.fs
*****************************************************************************
DateTime:2015-07-19_12-14-02 | ThreadId:47 | UserName:Fred | RequestID:0000000000000001000000000000000000000000000000 | 
RemoteAddress:127.0.0.1 | LocalAddress:127.0.0.1
MessageType:REQUEST
MessageSize:27
MessageData:{"payload":"HELLO_SERVICE"}

DateTime:2015-07-19_12-14-02 | ThreadId:47 | UserName:Fred | RequestID:0000000000000001000000000000000000000000000000 | 
RemoteAddress:127.0.0.1 | LocalAddress:127.0.0.1
MessageType:RESPONSE
MessageSize:26
MessageData:{"payload":"HELLO_CALLER"}

Procedimiento

  1. Configure el elemento fileSystemloggerInterceptor de forma global.
    <fileSystemloggerInterceptor id="globalFileSystemLogger" logName="globalLog_%SERVERNAME%"/>
    <zosConnectInterceptors id="globalInterceptorList" interceptorRef="globalFileSystemLogger" />
    <zosConnectManager globalInterceptorsRef="globalInterceptorList/>

    En el ejemplo, todas las solicitudes de servicio de z/OS Connect se registran en un archivo que se llama globalLog_myServer1_aaaa-MM-dd_HH_mm_ss_SSS.log donde myServer1 es el nombre del servidor. El único elemento de configuración necesario es la definición de atributo logName. EL elemento de configuración acepta una serie %SERVERNAME% que se sustituye con el nombre del servidor cuando se crea el registro. La ubicación predeterminada de la ubicación del archivo de registro es ${server.output.dir}/logs/zosConnect. Si desea más información sobre los atributos de configuración disponibles y los valores predeterminados, consulte la documentación para z/OS Connect 1.0 y z/OS Connect 1.2.

    También puede configurar el elemento fileSystemloggerInterceptor para servicios específicos.
     <fileSystemloggerInterceptor id="serviceYFileSystemLogger" 
                                     logName="service1Log" 
                                     logPath="/zosConnect/logs"
                                     logOption="RESPONSE"
                                     maxPayloadSize="30720"/>
    <zosConnectInterceptors id="serviceYInterceptorList" interceptorRef="serviceYFileSystemLogger" />
    <zosConnectService serviceName="serviceY" serviceRef="serviceY" interceptorsRef="serviceYInterceptorList"/>
    <usr_myService id="serviceY"/>

    En el ejemplo, todas las solicitudes del servicio z/OS Connect se registran en un archivo que se llama service1Log_aaaa-MM-dd_HH_mm_ss_SSS.log y se encuentra en la vía de acceso /zosConnect/logs. La vía de acceso de registro es una vía de acceso completa. Solo se registran los datos de respuesta para todas las solicitudes de entrada que tienen como destino el servicio. Puesto que la carga útil máxima de JSON se ha configurado para que tenga 30.720 caracteres, cualquier carga útil JSON (respuesta) que es superior a 30.720 caracteres se trunca en el tamaño máximo de carga útil configurado.

  2. (Opcional) Configure las definiciones de atributo bufferedLogging y bufferSize para habilitar el registro almacenado en la memoria intermedia. El tamaño del almacenamiento intermedio predeterminado es 8 kilobytes. Todos los registros del almacenamiento intermedio se vacían en el disco cuando el almacenamiento intermedio se llena. La utilización de la anotación cronológica con almacenamiento intermedio resulta apropiada cuando el rendimiento es importante y cuando se tolera la pérdida de registros no vaciados durante una condición de anomalía.
     <fileSystemloggerInterceptor id="globalFileSystemLogger" 
                                     logName="globalLog_%SERVERNAME%"
                                     bufferedLogging="true"
                                     bufferSize="16384"/>
  3. (Opcional) Configure el atributo rollOffLogPolicy. Esta política establece que cuando el archivo de registro activo alcanza el tamaño de archivo especificado o predeterminado de 50 megabytes, se crea un archivo nuevo. También se puede crear un archivo nuevo cuando el tiempo especificado o predeterminado de 24 horas caduca desde la creación del archivo de registro activo. En el ejemplo siguiente, se crea un archivo cuando el tamaño alcanza los 16 kilobytes de tamaño. El esquema de denominación es el mismo: globalLog_myServer1_aaaa-MM-dd_HH_mm_ss_SSS.log. La diferencia entre los nombres de los archivos de registro creados es la indicación de fecha y hora que se utiliza cuando se crea un archivo determinado:
    <fileSystemloggerInterceptor id="globalFileSystemLogger" 
                                     logName="globalLog_%SERVERNAME%"
                                     rollOffLogPolicy="SIZE"
                                     rollOffLogPolicySize="16384"/>

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_zconnect_file_sys_log_int.html