Configurar aplicaciones para generar archivos de registro

Las aplicaciones tales como Apache HTTP Server, IBM WebSphere Application Server, IBM DB2 Universal Database e IBM HTTP Server se pueden configurar para generar registros en un formato adecuado para realizar el análisis con los analizadores de registros.

A continuación hallará una lista de las configuraciones de aplicaciones que ayudan a dar formato a los registros para que los analizadores proporcionados con las herramientas puedan analizarlos.

Nota: los sucesos del registro incluidos en estos archivos de registro se pueden analizar con una base de datos de síntomas para interpretar los sucesos conocidos y las condiciones de error. Una base de datos de síntomas permite buscar información detallada sobre la resolución de errores y el significado de los sucesos. Para obtener más información sobre las bases de datos de síntomas e instrucciones acerca de cómo importarlas y utilizarlas, consulte los temas relacionados al final de este archivo.

Configuración para el archivo de registro de actividad y rastreo de Apache HTTP Server para iSeries

El archivo de configuración de Apache se denomina /www/apachedft/conf/httpd.conf en el servidor iSeries. Debe tener las siguientes directrices con el objeto de habilitar correctamente los registros de accesos y errores:

# ErrorLog: The location of the error log file. If this does not start
   # with /, ServerRoot is prepended to it.

ErrorLog ./logs/error.log

   # LogLevel: Control the number of messages logged to the error.log.
# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.

   LogLevel warn

# The following directives define some format nicknames for use with
# a CustomLog directive (see below).

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
LogFormat "%h %l %u %t \"%r\" %>s %b" common
LogFormat "%{Referer}i -> %U" referer
LogFormat "%{User-agent}i" agent

# The location of the access logfile (Common Logfile Format).
   # If this does not start with /, ServerRoot is prepended to it.


CustomLog ./logs/access.log common

Las 2 secciones de texto en negrita anteriores definen la ubicación del registro de errores y los registros de accesos de Apache respectivamente. Por ejemplo, en este caso, con ServerRoot como /www/apachedft, los registros aparecerían en el subdirectorio /www/apachedft/logs/ y se denominarían respectivamente error.log.* y access.log.*. El sufijo final del nombre de archivo dependerá de la fecha (por ejemplo, el primer error.log del 31 de diciembre de 2003 puede denominarse Q103123100).

Cuando haya modificado el archivo de configuración de Apache, deberá reiniciar el servidor Apache para reflejar este cambio. En la línea de mandatos de OS/400, especifique STRTCPSVR SERVER(*HTTP) INSTANCE(APACHEDFT).

Por el contrario, se puede finalizar el servidor Apache con el siguiente mandato en la línea de mandatos de OS/400: ENDTCPSVR SERVER(*HTTP) INSTANCE(APACHEDFT).

Configuración para el archivo de registro de actividad de IBM WebSphere Application Server V4.0

  1. Edite las siguientes entradas del archivo de configuración de registro <INICIO_WAS>\properties\logging.properties:
     #-----------------------------------------------------------------------------------------------
     # Activity Log Properties
     #
     # WARNING Before changing any of the Activity Log properties, all servers on the physical
     # node, including AdminServers must be stopped. 
     #
     # com.ibm.ws.ras.AcvitityLogEnabled : A property used to determine whether or not the servers on 
     # this node will write Ras events to the activity log or not. Valid values are true and false, 
     # with true the default. Turning off this logging may have serious serviceability impacts.
     #
     # com.ibm.ws.ras.ActivityLogSize : Size of the activity log in kilobytes. The default value
     # is 1024, which yields a log size of 1 megabyte. See the Problem Determination guide for
     # guidelines on setting the size of this log.
     #------------------------------------------------------------------------------------------------
    

    com.ibm.ws.ras.ActivityLogEnabled=true
    com.ibm.ws.ras.ActivityLogSize=1024


  2. Guarde los cambios efectuados en el archivo de configuración.
  3. Reinicie el servidor de aplicaciones.

Notas:

Configuración para el archivo de registro de rastreo de IBM WebSphere Application Server V4.0 (consola administrativa autónoma)

  1. Abra la consola administrativa de IBM WebSphere Application Server.
  2. Seleccione Dominio administrativo de WebSphere > Nodos > nombre_nodo > Servidores de aplicaciones > nombre_servidor > Servicios > Servicio de rastreo, donde nombre_nodo es el nombre del nodo y nombre_servidor es el nombre del servidor al que se aplicará la configuración del registro de rastreo.
  3. Efectúe una doble pulsación en nombre_servidor y seleccione la pestaña Servicios.
  4. Resalte el servicio de rastreo y pulse Editar propiedades.
  5. Pulse Examinar y seleccione los grupos o componentes, o una combinación de ambos, que desea rastrear.
  6. Compruebe que los siguientes componentes están habilitados tal como se indica a continuación:

    com.ibm.ws.http.HttpConnection=entry
    Exit=enabled:
    com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry
    Exit=enabled,
    event=enabled


  7. Pulse Aceptar.
  8. Establezca el archivo de rastreo en una vía de acceso de archivo local.
  9. Pulse Aceptar.
  10. Guarde los cambios efectuados en la configuración.
  11. Reinicie el servidor de aplicaciones.

Configuración para el archivo de registro de rastreo de IBM WebSphere Application Server V4.0 (consola administrativa basada en servlets)

  1. Abra la consola administrativa de IBM WebSphere Application Server.
  2. Seleccione Dominio administrativo de WebSphere > Nodos > nombre_nodo > Servidores de aplicaciones > nombre_servidor > Servicio de rastreo, donde nombre_nodo es el nombre del nodo y nombre_servidor es el nombre del servidor al que se aplicará la configuración del registro de rastreo.
  3. Habilite la cadena de rastreo y añada los componentes que desee rastrear.
  4. Compruebe que los siguientes componentes están habilitados tal como se indica a continuación:

    com.ibm.ws.http.HttpConnection=entry
    Exit=enabled:
    com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry
    Exit=enabled,
    event=enabled


  5. Establezca el archivo de rastreo en una vía de acceso de archivo local.
  6. Pulse Aceptar.
  7. Guarde los cambios efectuados en la configuración.
  8. Reinicie el servidor de aplicaciones.

Configuración para el archivo de registro de actividad de IBM WebSphere Application Server V5.0 o V6.0

  1. Abra la consola administrativa de IBM WebSphere Application Server.
  2. Seleccione Resolución de problemas > Registros y rastreo > nombre_servidor > Registros de servicio de IBM, donde nombre_servidor es el nombre del nodo al que se aplicará la configuración del registro de actividad.
  3. Habilite el registro de servicio.
  4. Establezca Nombre de archivo en una vía de acceso de archivo local.
  5. Pulse Aplicar o Aceptar.
  6. Guarde los cambios efectuados en la configuración.
  7. Reinicie el servidor de aplicaciones.

Nota: Por omisión ${LOG_ROOT} es DIR_WAS\logs\ donde DIR_WAS es:

Configuración para el archivo de registro de rastreo de IBM WebSphere Application Server V5.0 o V6.0

  1. Abra la consola administrativa de IBM WebSphere Application Server.
  2. Seleccione Resolución de problemas > Registros y rastreo > nombre_servidor > Registro de diagnósticos, donde nombre_servidor es el nombre del nodo al que se aplicará la configuración del registro de rastreo.
  3. Habilite el rastreo y añada la especificación de rastreo que desee.
  4. Compruebe que los siguientes componentes están habilitados tal como se indica a continuación:

    Para V5.0:

    com.ibm.ws.http.HttpConnection=entry
    Exit=enabled:
    com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry
    Exit=enabled,
    event=enabled

    Para V6.0:

    com.ibm.ws.http.HttpConnection=entry
    Exit=enabled:
    com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry
    Exit=enabled,
       event=enabled
    com.ibm.ws.http.HttpConnection=finer:com.ibm.ws.webcontainer.srp.ServletRequestProcessor=finer
  5. Establezca el archivo de salida de rastreo en una vía de acceso de archivo local.
  6. Pulse Aplicar o Aceptar.
  7. Guarde los cambios efectuados en la configuración.
  8. Reinicie el servidor de aplicaciones.

Nota: Por omisión, ${SERVER_LOG_ROOT} es DIR_WAS\logs\nombre_servidor\ donde nombre_servidor es el nombre del nodo al que se aplicará la configuración de anotación de rastreo y DIR_WAS es:

Configurar el tamaño del archivo de registro de rastreo de WebSphere Application Server.

  1. Abra la consola administrativa de IBM WebSphere Application Server.
  2. Seleccione Resolución de problemas > Registros y rastreo > nombre_servidor > Registro de diagnósticos.
  3. Bajo Salida de rastreo, seleccione Archivo y especifique el tamaño máximo de archivo deseado. El tamaño recomendado para el archivo de registro de rastreo es inferior a 10 MB.
  4. Pulse Aplicar para guardar los cambios.
  5. Reinicie el servidor de aplicaciones.

Configuración para el archivo de registro de errores de IBM WebSphere Application Server for z/OS

IBM WebSphere Application Server for z/OS se puede configurar de modo que se anoten los sucesos del registro de errores en una corriente de registro o en el conjunto de datos SYSOUT del trabajo MVS de WebSphere Application Server. Siga las instrucciones que se facilitan a continuación para copiar los sucesos del registro de errores en un archivo que podrá analizar e importar en el analizador de anotaciones. El analizador de anotaciones puede analizar e importar archivos de registro de errores de WebSphere Application Server for z/OS V4.0 y V5.0.

Nota: los archivos de registro de errores de IBM WebSphere Application Server for z/OS no se pueden importar de conjuntos de datos MVS. Deben estar en el sistema de archivos de UNIX System Services.

Nota: las horas de los sucesos del registro de errores se analizan como horas GMT. Debe configurar WebSphere Application Server for z/OS para escribir horas GMT en los sucesos del registro de errores. Esta es la configuración por omisión. Si se configura de modo que escriba horas locales en los sucesos del registro de errores, puede que la información de huso horario que se muestra en la propiedad creationTime de los sucesos del registro de la vista de registro sea incorrecta.

Nota: los archivos de registro de errores de IBM WebSphere Application Server for z/OS sólo se pueden asociar por hora.

Configuración para el archivo de registro de accesos de IBM HTTP Server V1.3.19.3 en V2.0.42.1

  1. Edite la siguiente entrada del archivo de configuración del servidor HTTP INICIO_IHS\conf\httpd.conf:

       # The location of the access logfile (Common Logfile Format).
       # If this does not start with /, ServerRoot is prepended to it.
       CustomLog logs/access.log common
  2. Guarde los cambios efectuados en el archivo de configuración.
  3. Reinicie el servidor HTTP.

Notas:

Configuración para el archivo de registro de errores de IBM HTTP Server V1.3.19.3 en V2.0.42.1

  1. Edite la siguiente entrada del archivo de configuración del servidor HTTP INICIO_IHS\conf\httpd.conf:
       # ErrorLog: The location of the error log file. If this does not start
       # with /, ServerRoot is prepended to it.
       ErrorLog logs/error.log
       # LogLevel: Control the number of messages logged to the error.log. 
       # Possible values include: debug, info, notice, warn, error, crit, alert, emerg. 
       LogLevel warn
  2. Guarde los cambios efectuados en el archivo de configuración.
  3. Reinicie el servidor HTTP.

Notas:

Configuración para el archivo de registro de diagnósticos de IBM DB2 Universal Database V8.1 en V8.2

La configuración por omisión de DB2 graba todos los mensajes de aviso y error en un archivo de anotación denominado db2diag.log. Este archivo se encuentra en la ubicación siguiente:

Para los entornos con soporte para Windows:

Para entornos basados en UNIX> INSTHOME/sqllib/db2dump, donde INSTHOME es el directorio de inicio del propietario de la instancia.

La variable DIAGPATH, que se especifica en la configuración del gestor de bases de datos, proporciona la vía de acceso completa para el directorio de almacenamiento de la Primera captura de datos de error (FFDC). El valor por omisión para DIAGPATH es una cadena null. Para cambiar el valor DIAGPATH, utilice el mandato siguiente:

DB2 UPDATE DBM CFG USING DIAGPATH vía de acceso

Verificar el nivel de captura de errores de diagnóstico actual

Siga estos pasos:

  1. Abra una ventana de mandatos de DB2.
  2. Escriba
    db2 get dbm cfg
  3. Lea el valor del "nivel de captura de errores de diagnóstico (DIAGLEVEL)".

Configurar la cantidad de información registrada

La cantidad de información registrada en el archivo de registro de diagnósticos (db2diag.log) se puede configurar siguiendo estos pasos:

  1. Abra una ventana de mandatos de DB2.
  2. Escriba:
    db2 update dbm cfg using DIAGLEVEL [nivel]
    donde [nivel] es el valor que controla la cantidad de información que se registra. El valor por omisión es 3. A continuación se indican los valores válidos y sus significados:
    0 = No se captura ningún dato de diagnósticos
    1 = Sólo errores graves
    2 = Todos los errores
    3 = Todos los errores y avisos
    4 = Todos los errores, avisos y mensajes informativos
  3. Si se actualiza el valor, el cambio entrará en vigor de forma inmediata.

Configuración para el archivo de registro de rastreo JCC de IBM DB2 Universal Database V8.1.2 o V8.2 (aplicación web en ejecución en WebSphere Application Server)

La consola administrativa de WebSphere Application Server permite configurar cómo se registra la información relacionada con JDBC. Existen 2 modos de anotar mensajes de registro de JCC:

  1. Dirigir todos los mensajes de JCC al archivo de registro de rastreo de WAS V5.0
  2. Dirigir todos los mensajes de JCC a un archivo de registro aparte

Dirigir los mensajes de JCC al archivo de rastreo de WAS V5.0

Siga estos pasos:

  1. Abra la consola administrativa de IBM WebSphere Application Server V5.0.
  2. Seleccione Resolución de problemas > Registros y rastreo > nombre_servidor > Registro de diagnósticos.
  3. Pulse el botón Modificar bajo Especificación de rastreo. Se abre una ventana.
  4. Bajo la pestaña Grupos, asegúrese de que los siguientes grupos están seleccionados:
    1. WAS.database
    2. WAS.j2c
    3. RRA
  5. Pulse el botón Aplicar. Se cierra la ventana.
  6. Pulse Aplicar en la pestaña de configuración de la ventana principal.
  7. Guarde los cambios efectuados en la configuración.
  8. Seleccione Recursos > Proveedores JDBC > Proveedor de controlador JDBC de DB2 Universal > Orígenes de datos > nombre_origen_datos > Propiedades personalizadas.
  9. En la tabla Propiedades personalizadas, compruebe que la propiedad traceFile no está establecida.
  10. Si hay un nombre de archivo especificado bajo traceFile, pulse en traceFile. Quite el texto del campo Valor y pulse Aceptar.
  11. Guarde los cambios efectuados en las propiedades personalizadas.
  12. Reinicie el servidor de aplicaciones.

Dirección de mensajes JCC a un archivo de anotaciones distinto

Siga estos pasos:

  1. Abra la consola administrativa de IBM WebSphere Application Server V5.0.
  2. Seleccione Resolución de problemas > Registros y rastreo > nombre_servidor > Registro de diagnósticos.
  3. Pulse el botón Modificar bajo Especificación de rastreo. Se abre una ventana. Bajo la pestaña Grupos de la ventana pequeña, compruebe que el grupo RRA está seleccionado.
  4. Pulse el botón Aplicar. Se cierra la ventana.
  5. Pulse Aplicar en la pestaña de configuración de la ventana principal.
  6. Guarde los cambios efectuados en la configuración.
  7. Seleccione Recursos > Proveedores JDBC > Proveedor de controlador JDBC de DB2 Universal > Orígenes de datos > nombre_origen_datos > Propiedades personalizadas.
  8. Bajo la columna Nombre de la tabla Propiedades personalizadas, pulse traceFile.
  9. Escriba la vía de acceso absoluta del archivo de rastreo en el campo Valor y pulse Aceptar.
  10. Bajo la columna Nombre de la tabla Propiedades personalizadas, pulse traceLevel.
  11. Escriba el valor de traceLevel adecuado en el campo Valor. Los niveles de rastreo posibles y sus significados pueden hallarse en la descripción de la propiedad, justo bajo el campo Valor.
  12. Pulse Aceptar.
  13. Guarde los cambios efectuados en las propiedades personalizadas.
  14. Reinicie el servidor de aplicaciones.

Configuración para el archivo de registro de rastreo JCC de IBM DB2 Universal Database V8.1.2 o V8.2 (aplicación autónoma)

Para la conectividad JDBC 2 desde el origen de datos, utilice los métodos setLogWriter() y setTraceLevel() en el objeto com.ibm.db2.jcc.DB2SimpleDataSource. Estos métodos habilitan por completo el nivel de rastreo por omisión.

Puede habilitar el rastreo JDBC 1 con el gestor de controladores java.sql.DriverManager.setLogWriter(), o se puede incorporar un traceFile en un URL de base de datos JDBC 1.
Por ejemplo:
String databaseURL = "jdbc:db2://hal:50000/sample:traceFile=c:/temp/foobar.txt;traceLevel=" + (com.ibm.db2.jcc.DB2BaseDataSource.TRACE_DRDA_FLOWS | com.ibm.db2.jcc.DB2BaseDataSource.TRACE_CONNECTS) + ";";


 

Para la conectividad tanto JDBC 1 como JDBC 2, puede activar y desactivar el rastreo en una conexión con el método propietario DB2Connection.setJCCLogWriter(java.io.PrintWriter logWriter, int traceLevel). También puede emplear este método para cambiar el transcriptor de registro o ajustar el nivel de rastreo en una conexión activa. Si utiliza el método javax.sql.DataSource.setLogWriter(java.io.PrintWriter logWriter) estándar, se emplea el nivel de rastreo por omisión (totalmente habilitado). Puede inhabilitar el rastreo estableciendo el transcriptor de registro en nulo.

Para obtener más información sobre cómo crear información de rastreo para el controlador JDBC universal, consulte la documentación de DB2.

Tras completarse cualquiera de los grupos de tareas anteriores, es posible importar ese archivo de registro concreto en el producto (Archivo > Importar...).

Configuración para el archivo de registro de actividad y rastreo de IBM WebSphere Application Server para iSeries

IBM WebSphere Application Server para iSeries admite varias instancias de servidor, cada una de ella con su propia configuración. El subdirectorio en que se define cada instancia depende de la versión de IBM WebSphere Application Server instalada en el servidor y del nombre de la instancia del servidor.

Por ejemplo, si deseara ver la configuración de registro en una máquina iSeries que ejecuta IBM WebSphere Application Server Express V5.0 para una instancia de servidor denominada default, el archivo server.xml se encontraría en la ubicación siguiente:

/QIBM/UserData/WebASE/ASE5/default/config/cells/myhostname/nodes/mynodename/servers/server1/server.xml. 

Este archivo server.xml contiene las especificaciones del registro.

  1. Active la generación del registro de actividad.
    El registro de actividad está activo por omisión, como se define en la cláusula siguiente:
    <services xmi:type="loggingservice.ras:RASLoggingService" xmi:id="RASLoggingService_1" enable="true" messageFilterLevel="NONE" enableassociationId="true">
    <serviceLog xmi:id="ServiceLog_1" name="${LOG_ROOT}/activity.log" size="2" enabled="true"/>
    </services>
    

    El registro de actividad (según el ejemplo anterior) aparecería en el archivo /QIBM/UserData/WebASE/ASE5/default/logs/activity.log.

  2. Active el registro de rastreo de IBM WebSphere Application Server.
    El registro de rastreo no está activo por omisión. Puede que tenga que editar el archivo server.xml para activar el rastreo añadiendo las 3 líneas siguientes:
    <services xmi:type="traceservice:TraceService" xmi:id="TraceService_1" enable="true" startupTraceSpecification="com.ibm.ws.http.HttpConnection=entryExit=enabled:com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entryExit=enabled,event=enabled" traceOutputType="SPECIFIED_FILE" traceFormat="BASIC" memoryBufferSize="8">
    <traceLog xmi:id="TraceLog_1" fileName="${SERVER_LOG_ROOT}/trace.log" rolloverSize="20" maxNumberOfBackupFiles="1"/>
    </services>
    

    Según el ejemplo anterior, de este modo se creará un archivo de rastreo en el archivo /QIBM/UserData/WebASE/ASE5/default/logs/server1/trace.log.

  3. Detener y reiniciar la instancia de IBM WebSphere Application Server para comprometer los cambios
    Esta operación puede realizarse desde la línea de mandatos o la consola administrativa de IBM WebSphere Application Server. Para detener el servidor desde la línea de mandatos, deben emitirse los mandatos siguientes desde el intérprete QShell de iSeries. 1. Cambie el directorio actual por el directorio bin de IBM WebSphere Application Server correspondiente. 2. Detenga el servidor.
    stopServer -instance default

    3. Reinicie el servidor.

    startServer -instance default

Conceptos relacionados
Determinación de problemas en aplicaciones distribuidas utilizando el Analizador de anotaciones y rastreo
Bases de datos de síntomas de computación automática (Autonomic Computing symptom)

Tareas relacionadas
Importar un archivo de registro
Importación y uso de una base de datos de síntomas AC