Volver al blog
Oracle 2 min de lectura

Cómo activar el modo debug en Oracle BI Publisher 11g

Cuando un informe de BI Publisher falla con un mensaje poco descriptivo, subir el registrador oracle.xdo a TRACE:32 desde Enterprise Manager deja ver qué ocurre de verdad en la generación del informe.

Portada de la guía para activar el modo debug en Oracle BI Publisher 11g

Cuando un informe de BI Publisher falla con un mensaje poco descriptivo, el modo debug suele ser la vía más rápida para avanzar: eleva el nivel de detalle del log y deja ver qué está ocurriendo en la generación del informe, en el modelo de datos y en el resto de la cadena. No hay que tocar ningún fichero de configuración —se hace desde Enterprise Manager, subiendo el nivel del registrador oracle.xdo—.

No conviene activarlo en entornos productivos. El nivel de traza más fino genera un volumen de log muy alto y penaliza el rendimiento del servidor: úsalo en desarrollo, o en producción solo dentro de una ventana controlada y devolviendo el registrador a su valor original en cuanto termines el diagnóstico.

1. Localizar bipublisher en Enterprise Manager

Entra en el Enterprise Manager del dominio de BI y despliega el árbol de Despliegues de Aplicaciones de la izquierda. Busca bipublisher, haz clic derecho sobre él y navega hasta Logs → Configuración de Log.

Árbol de Enterprise Manager con el menú contextual de bipublisher abierto en Logs y Configuración de Log
El menú contextual de bipublisher lleva directamente a la configuración de logs.

2. Buscar el registrador oracle.xdo

En la pestaña Niveles de Log, con la vista Registradores de Tiempo de Ejecución, busca oracle.xdo. Es el registrador que agrupa los mensajes del motor de BI Publisher. Por defecto aparece en WARNING:1, que es justo el nivel que oculta el detalle que necesitas.

Página de Configuración de Log filtrando el registrador oracle.xdo, con nivel WARNING:1
El registrador oracle.xdo, con su nivel por defecto.

3. Cambiar el nivel a TRACE:32

Despliega la columna de nivel de diagnóstico y selecciona TRACE:32 (FINEST), el nivel más detallado de la escala. Pulsa Aplicar para guardar el cambio.

Desplegable de niveles de Oracle Diagnostic Logging con TRACE:32 FINEST seleccionado
La escala completa de Oracle Diagnostic Logging, de INCIDENT_ERROR a TRACE:32.

Dónde consultar los logs

Con el nuevo nivel activo, los mensajes detallados se pueden revisar desde el propio Enterprise Manager o directamente en el filesystem:

$DOMAIN_HOME/servers/bi_server1/logs/bipublisher

Resultado

A partir de ese momento, reproducir el fallo del informe deja en el log el rastro completo de la ejecución: la consulta del modelo de datos, el procesado de la plantilla y el punto exacto donde se rompe. Con eso, el mensaje genérico de la interfaz deja de ser el único dato disponible.

Cuando termines el diagnóstico, devuelve oracle.xdo a su nivel anterior. Un registrador olvidado en TRACE:32 llena el filesystem de logs y arrastra el rendimiento del servidor de informes.