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