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
. 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 registroNivel 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:
- Registro en Rational
DOORS:
- Registro en Rational
DOORS Web Access: