Espacios de nombre de registro, niveles y actividades

El proveedor de Message Queue define un conjunto de espacios de nombre de registro asociados a los niveles de registro y a actividades de registro que permiten a los clientes de Message Queue crear un registro de los sucesos de conexión y de sesión siempre que se haya establecido correctamente la configuración de registro.

El espacio del nombre de registro raíz del tiempo de ejecución de Message Queue está definido como javax.jms. Todos los registros del tiempo de ejecución del cliente de Message Queue utilizan este nombre como espacio de nombres padre.

Los niveles de registro del tiempo de ejecución del cliente de Message Queue son los mismos que los definidos en la clase java.util.logging.Level. Esta clase define siete niveles de registro estándar y dos ajustes adicionales que puede utilizar para desactivar y activar el proceso de registro.

OFF

Desactiva el registro.

SEVERE

Cuanto mayor es la prioridad, más alto es el valor. Definido por la aplicación.

WARNING

Definido por la aplicación.

INFO

Definido por la aplicación.

CONFIG

Definido por la aplicación.

FINE

Definido por la aplicación.

FINER

Definido por la aplicación.

FINEST

Cuanto menor es la prioridad, menor es el valor. Definido por la aplicación.

ALL

Activa el registro de todos los mensajes.

En general, las excepciones y los errores que se producen en el tiempo de ejecución del cliente de Message Queue son registrados con el espacio de nombre javax.jms.

• Las excepciones que devuelve JVM y que capta el tiempo de ejecución del cliente, como IOException, quedan registradas con el espacio de nombre de registro javax.jms en el nivel WARNING.

• Las excepciones de JMS que devuelve el tiempo de ejecución del cliente, como IllegalStateException , quedan registradas con el espacio de nombre de registro javax.jms en el nivel FINER.

• Los errores que devuelve JVM y que capta el tiempo de ejecución del cliente, como OutOfMemoryError, quedan registrados con el espacio de nombre de registro javax.jms en el nivel SEVERE.

La siguiente tabla muestra una lista de los sucesos que pueden registrarse y el nivel de registro que debe establecerse en los sucesos de registro para las conexiones de JMS y las sesiones.

La siguiente tabla describe los niveles de registro y los sucesos de conexiones.

Tabla 1–6 Niveles de registro y sucesos para el espacio de nombre javax.jms.connection

Nivel de registro	Sucesos
FINE	Conexión creada
FINE	Conexión iniciada
FINE	Conexión cerrada
FINE	Conexión interrumpida
FINE	Conexión reanudada
FINER	Diversas actividades de conexión como setClientID
FINEST	Mensajes, reconocimientos, mensajes de acción y control de Message Queue (como confirmar una transacción)

Para las sesiones, se deja constancia de la siguiente información en el registro.

• Cada registro de un mensaje entregado a un consumidor incluye el ID de la conexión, el ID de la sesión y el ID del consumidor.

• Cada registro de un mensaje enviado por un productor incluye el ID de la conexión, el ID de la sesión y el ID del productor, además del nombre del destino.

La siguiente tabla describe los niveles de registro y los sucesos de las sesiones.

Tabla 1–7 Niveles de registro y sucesos para el espacio de nombre javax.jms.session

Nivel de registro	Suceso
FINE	Sesión creada
FINE	Sesión cerrada
FINE	Productor creado
FINE	Consumidor creado
FINE	Destino creado
FINER	Diversas actividades de sesión como confirmar una sesión.
FINEST	Mensajes producidos y consumidos. (Las propiedades y los cuerpos de los mensajes no se consignan en los registros.)

Por defecto, el nivel de registro de salida se hereda del JRE en que se esté ejecutando la aplicación. Compruebe el archivo JRE_DIRECTORY/lib/logging.properties para determinar cuál es el nivel.

Puede configurar el registro de forma programática o mediante archivos de configuración, de forma que pueda controlar el ámbito en que se produce el registro. En las siguientes secciones se describen estas posibilidades.