Archivos de registro para Rational DOORS y Rational DOORS Web Access

Puede utilizar archivos de registro para resolver los problemas que se producen en el servidor de base de datos, el cliente y el servidor de interoperación de IBM® Rational DOORS y en el servidor y el intermediario de mensajes de Rational DOORS Web Access.
En función de la configuración, están disponibles estas herramientas de registro para diagnosticar un comportamiento inesperado:
  • Registro de diagnóstico para el cliente
  • Registro de transacciones del servidor de base de datos
  • Registro de transacciones del cliente
  • Registro de intermediario de mensajes, servidor de interoperación y servidor de Rational DOORS Web Access
  • Registro de mensajes de aplicación y programa de utilidad de recopilación de datos

Registro de diagnóstico para el cliente de Rational DOORS

El cliente tiene un mecanismo incorporado que registra los sucesos inusuales que se producen como resultado de un error interno durante la sesión. Para ver el registro de diagnóstico, pulse Ayuda > Mostrar registro de diagnóstico. Si es necesario, puede copiar la información de la ventana de salida y guardarla como un archivo de texto local.

Para registrar un registro más detallado, también puede habilitar un registro basado en transacciones adicional en el cliente y el servidor de base de datos. Para obtener más información, consulte las siguientes secciones.

Registro del servidor de base de datos para Rational DOORS

El servidor de base de datos proporciona una funcionalidad de registro que puede registrar la actividad en diferentes niveles de detalle. De forma predeterminada, este registro no está habilitado porque puede aumentar el uso de procesador y disminuir la velocidad para completar una función solicitada o afectar negativamente el rendimiento general. Los detalles del registro de salida se basan en el valor de nivel de registro que se ha establecido. El rango de valores va del nivel 1, el más escueto, al nivel 6, el más detallado. Antes de activar un registro del servidor, póngase en contacto con el soporte de software de IBM para determinar el nivel necesario para resolver el problema.

Tabla 1. Niveles de registro
Nivel de registro Detalles de información de registro
1 Conexiones, desconexiones y paquetes de problemas
2 Conexiones, desconexiones y tipos de paquete
3 Conexiones, desconexiones, tipos de paquete y argumentos de paquete en formato compacto
4 Conexiones, desconexiones, tipos de paquete y argumentos de paquete en formato detallado
5 Sólo operaciones de memoria caché de datos
6 Conexiones, desconexiones, operaciones de memoria caché de datos, tipos de paquete y argumentos de paquete en formato detallado
Para ayudar a identificar un error no especificado, puede que necesite iniciar el registro en el nivel 6 para capturar toda la actividad. Después de habilitar el registro de base de datos y reproducir el comportamiento, envíe el archivo de registro generado al soporte de software de IBM e inhabilite el registro tal como se describe en el tema de ayuda de registro del servidor. Habilitación del registro de transacciones en el servidor de base de datos de Rational DOORS
Nota: Habilite el registro de base de datos sólo para periodos de diagnóstico limitados. Para desactivar el registro sin cerrar el servidor, establezca el valor de nivel de registro en 0 utilizando el mandato -serverlogging dbadmin; por ejemplo, dbadmin -d 36677@IBMEDSERV -serverlogging 0.

Registro de cliente para Rational DOORS

Puede habilitar una funcionalidad de registro para resolver los problemas de conexión con el servidor de base de datos. Desde el sistema que tiene el problema, abra el cliente de Rational DOORS y ejecute un mandato DXL para habilitar el registro de cliente y generar un archivo de registro local. Cuando reproduzca el comportamiento, envíe el archivo de registro generado al soporte de software de IBM e inhabilite el registro tal como se describe en el tema de ayuda de registro del cliente. Habilitación del registro de transacciones en el cliente de Rational DOORS Rational DOORS
Nota: El registro no contiene datos de objeto o de módulo que puedan ser información de contenido confidencial; sólo contiene los detalles de la transacción de archivos. Si la seguridad DXL está habilitada, debe ser un usuario con permiso para editar y ejecutar DXL.../../com.ibm.doors.configuring.doc/topics/t_setupdxlsecurity.html#t_setupdxlsecurity

Registro para el servidor de interoperación de Rational DOORS y el servidor y el intermediario de mensajes de Rational DOORS Web Access

De forma predeterminada, los componentes de Rational DOORS Web Access proporcionan registros de nivel de información. En el nivel de información, los registros contienen mensajes informativos que describen el progreso de la aplicación en un nivel alto. Para diagnosticar problemas de la instalación, puede habilitar los componentes para que se ejecuten en modalidad de depuración. En el nivel de depuración, los registros contienen sucesos informativos más detallados que resultan útiles para depurar una aplicación.

El servidor de interoperación de Rational DOORS y el servidor y el intermediario de mensajes de Rational DOORS Web Access proporcionan registros de nivel de información en estos directorios:
  • DIR_INSTALACIÓN_DWA\broker\data\activemq.log
  • DIR_INSTALACIÓN_DWA\server\festival\logs

    Si necesita información más detallada para diagnosticar problemas, habilite el registro de nivel de depuración. Para configurar un registro ampliado, consulte los enlaces relacionados para Rational DOORS Web Access. Hay numerosos archivos de registro en el directorio de registros.

    Para diagnosticar un problema, empiece con estos archivos:
    • festival.log contiene los mensajes de registro grabados por el servidor de Rational DOORS Web Access.
    • request.log se utiliza para verificar si las solicitudes se han recibido realmente. Esto es útil cuando se trabaja con procesos que incluyen varias aplicaciones.
    • response.log se utiliza para confirmar si las respuestas se han devuelto a la aplicación que realiza la invocación. Esto es útil para confirmar si la solicitud recibida ha finalizado y devuelto un resultado.
    Los mensajes de error se graban en diferentes registros en función de cómo se originan. La mayoría de los errores se graban en exception.log pero también se pueden utilizar otros archivos de registro de errores. Existen tres archivos de registro de errores:
    • exception.log
    • error_view.log
    • error_misc.log

Registro de mensajes de aplicación y programa de utilidad de recopilador de datos

La versión 9.4 incluye el registro de mensajes de aplicación que se basa en servicios de registro log4cxx de Apache. Puede limitar el tamaño de archivo de registro, configurar la limpieza automática de los archivos antiguos, elegir el formato de los archivos de registro de salida y cambiar el nivel de registro y las configuraciones de registro sin reiniciar el servidor. El archivo de configuración se supervisa cada 60 segundos para detectar los cambios.

Existen cinco niveles de registro, que de inferior a superior son: Debug (Depuración), Info (Información), Warn (Aviso), Error y Fatal (Muy grave). Cada nivel registra información para dicho nivel y todos los niveles superiores. Por ejemplo, el nivel Warn incluye información de las modalidades Warn, Error y Fatal.

Las versiones anteriores de Rational DOORS necesitaban una recopilación repetida manual de información del entorno y los recursos además de los registros de diagnóstico durante la fase de resolución de problemas inicial. Incluir la mensajería de aplicación en la versión 9.4, puede ejecutar una herramienta de recopilación de datos de línea de mandatos para recopilar registros que se generan según las instrucciones de configuración de la mensajería de aplicación. La herramienta de recopilación de datos también crea 3 archivos de texto:
  • readme.txt proporciona claridad sobre el uso cuando se produce el problema.
  • problemDetails.txt es un archivo de plantilla en el que puede especificar detalles del problema manualmente.
  • collectedInformation.txt es un registro de información recopilada automáticamente sobre el sistema operativo, de información del producto, archivos de biblioteca de enlace dinámico soportados (.DLL) y el archivo config.ini de Rational DOORS.
Para obtener información para la configuración de archivos de registro, consulte estos temas:

Comentarios