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
  • Registros de intermediarios de mensajes, servidor de interoperación y servidor de Rational DOORS Web Access
  • Registros 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 un 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 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 e inhabilite el registro, tal como se describe en el tema de ayuda Habilitación del registro de transacciones en el servidor de base de datos de Rational DOORS.
Nota: Para evitar la degradación de rendimiento, habilite el registro de base de datos sólo para periodos de diagnóstico limitados.

Registro de cliente para Rational DOORS

Puede habilitar el registro para resolver los problemas de conexión con el servidor de base de datos. El registro no contiene datos de objeto o de módulo que puedan tener información de contenido confidencial; sólo contiene los detalles de la transacción de archivos. 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. Tras reproducir el comportamiento, envíe el archivo de registro generado al soporte e inhabilite el registro, tal como se describe en el tema de ayuda de registro del cliente Habilitación de un registro de transacción en el cliente de Rational DOORS.

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 incluir más detalles, habilite componentes para ejecutar en el nivel de depuració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
Para generar información detallada con el registro de nivel de depuración, consulte los enlaces relacionados para el registro de 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 se reciben las solicitudes. Este registro es útil para procesos de diagnóstico 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. Este registro se utiliza para confirmar si la solicitud recibida ha finalizado y devuelto un resultado.
Los mensajes de error se graban en diferentes archivos de registro 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. Los tres archivos de registro de error son:
  • 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 realizar estas tareas sin reiniciar el servidor:
  • Limitar el tamaño del archivo de registro
  • Configurar la limpieza automática de archivos antiguos
  • Elegir el formato de archivos de registro de salida
  • Cambiar el nivel de registro y las configuraciones de registro
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 tres 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, la información del producto Rational DOORS, los archivos de biblioteca de enlace dinámico soportados (.DLL) y el archivo config.ini.
Para obtener información para la configuración de archivos de registro, consulte estos temas:

Icono de vídeo Vídeos

Lista de reproducción de CLM
Canal de Jazz.net
Canales de User Education

Icono de más información Más información

Círculo de aprendizaje de CLM
Círculo de aprendizaje de Agile
Círculos de aprendizaje

Icono de preguntas Sus preguntas

Foro de Jazz.net
Foros de developerWorks

Icono de soporte Obtención de soporte

Portal de soporte
Wiki de despliegue
Blog de soporte