Configuración de ODL

Cada producto de Oracle Enterprise Performance Management System que utiliza el formato de registro ODL tiene al menos un archivo de configuración del registro, logging.xml. Los componentes de EPM System tienen nombres descriptivos con el formato loggingNOMBRE_COMPONENTE.xml.

Los archivos de configuración del registro incluyen dos secciones: log_handlers y loggers. La sección log_handlers define los registradores y sus parámetros, mientras que la sección loggers identifica detalles que incluyen el nivel de registro y el log_handler que se va a utilizar.

Consulte en Tabla 3-9 una lista de las propiedades de log_handler que puede especificar.

Niveles de registro de ODL

Tabla 3-7 Niveles de registro de ODL

Nivel	Descripción
INCIDENT_ERROR:1	Mensajes relacionados con un problema grave provocado por motivos desconocidos. Los usuarios deben recurrir a los Servicios de Soporte Oracle para resolver el problema.
ERROR:1	Mensajes relacionados con un problema grave que requiere atención inmediata por parte del administrador del sistema, pero que no están provocados por un defecto en un componente de EPM System
WARNING:1	Mensajes relacionados con un posible problema que debe revisar el administrador del sistema
NOTIFICATION:1	Mensajes relacionados con un evento importante del ciclo de vida, como la activación o la desactivación de un subcomponente o una función
NOTIFICATION:16	Mensajes relacionados con eventos normales en los componentes de EPM System
TRACE:1	Mensajes de rastreo o depuración de eventos que son significativos para los usuarios finales de los componentes de EPM System
TRACE:16	Mensajes de rastreo o depuración detallados que puede utilizar el Servicio de Soporte Oracle para diagnosticar problemas con los componentes de EPM System
TRACE:32	Mensajes de rastreo o depuración muy detallados, normalmente concebidos para que un desarrollador de Oracle Developer pueda localizar el origen desde el que ha surgido el error

Archivo de configuración ODL: despliegues en un solo servidor gestionado

El despliegue de los componentes de EPM System en un solo servidor gestionado genera un archivo de configuración de registro unificado logging.xml para todas las aplicaciones web de Java desplegadas. En un servidor de Windows, este archivo se encuentra normalmente en MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/EPMServer0.

Archivos de configuración ODL: despliegues estándar

El despliegue estándar de EPM System genera un archivo de configuración de registro logging.xml para cada aplicación web de Java desplegadas. En un servidor de Windows, estos archivos se ubican normalmente como se indica a continuación:

Tabla 3-8 Ubicación de los archivos de configuración ODL en despliegues estándar

Componente	Ubicación de logging.xml
Servidor de administración (consola de administración de Oracle WebLogic Server, Oracle Web Services Manager, Enterprise Manager)	`MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/AdminServer/logging.xml`
Oracle Hyperion Provider Services	`MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/AnalyticProviderServices0/logging.xml`
Oracle Hyperion Calculation Manager	`MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/CalcMgr0/logging.xml`
Oracle Essbase Administration Services	`MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/EssbaseAdminServices0/logging.xml`
Oracle Hyperion Foundation Services	`MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/FoundationServices0/logging.xml`
Web de Oracle Hyperion Financial Management	`MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/HFMWeb0/logging.xml`
Oracle Hyperion Planning	`MIDDLEWARE_HOME/user_projects/domains/EPMSystem/config/fmwconfig/servers/Planning0/logging.xml`

Modificación de archivos de configuración ODL

Modifique las propiedades de los registradores definidos en logging.xml para determinar los niveles de mensaje que se registran. De forma predeterminada, el nivel de registro adecuado para el funcionamiento normal de los componentes de EPM System se define en logging.xml. Se pueden definir parámetros adicionales de identificador de registros para cambiar el comportamiento del registro. Por ejemplo, puede especificar la frecuencia de rotación del archivo de registro incluyendo el parámetro rotationFrequency en el identificador del registro. Consulte en Tabla 3-9 la lista completa de parámetros.

Tabla 3-9 Propiedades configurables del registro de ODL

Propiedad del registro	Descripción
`path`	Ruta del registro
`format`	Formato que se utilizará El valor recomendado es `ODL-Text`.
`maxFileSize`	Tamaño máximo en bytes para cada archivo de registro Cuando el archivo de registro principal alcanza el tamaño proporcionado, se desencadena una rotación de registro, se archiva el archivo de registro principal y se crea un nuevo archivo de registro.
`maxLogSize`	Tamaño máximo en bytes para el registro completo Se suprimen archivos más antiguos para mantener el tamaño total del registro por debajo del límite especificado.
`rotationFrequency`	Frecuencia, en minutos, para rotar los registros El valor debe ser un número (de minutos) o la palabra `hourly`, `daily` o `weekly`. (Este valor no distingue entre mayúsculas y minúsculas).
`baseRotationTime`	Tiempo base para la rotación de registros basada en el tiempo; por ejemplo, el punto inicial para el valor `rotationFrequency` Valor predeterminado: 1 de enero de 1970, UTC Utilice uno de los siguientes formatos: HH:mm aaaa-MM-dd aaaa-MM-ddT-HH:mm aaaa-MM-dd-HH:mm:ss.`s`ZH, donde ZH es el indicador de zona horaria y puede ser `Z` para UTC o un desfase desde la Hora del meridiano de Greenwich con el formato más_o_menosHH:mmm Nota: Si el formato de hora no especifica una zona horaria, se utilizará la zona horaria local.
`retentionPeriod`	Cuánto tiempo se mantienen los archivos de registro Se suprimen los archivos que son anteriores al periodo especificado. Los archivos solo se suprimen cuando hay una rotación de registro; ningún subproceso en segundo plano borra archivos de registro. Por lo tanto, es posible que no se supriman los archivos durante un tiempo después de expirar el periodo de retención. El valor debe ser un número (minutos), o un día, una semana, un mes (30 días) o un año (los valores no distinguen entre mayúsculas y minúsculas).
`encoding`	Tipo de codificación de caracteres que se va a utilizar Los archivos XML deben estar codificados en UTF-8 para gestionar caracteres extendidos. El valor predeterminado es `<?xml version="1.0" encoding="UTF-8" ?>`.
`supplementalAttributes`	Lista separada por comas de nombres de atributo complementarios que pueden agregarse a cada mensaje de registro El valor del atributo se debe definir en la clase `ExecutionContext`.
`useSourceClassAndMethod`	Indica si se deben agregar la clase de origen Java y el nombre del método a cada mensaje de registro El valor es un nombre de nivel. Los mensajes de un nivel especificado o inferior incluyen la clase de origen y el nombre de método. Las constantes `true` y `false` se aceptan también como alias de `OFF` y `ALL`. El valor predeterminado es `TRACE:1` (Detallado).
`useDefaultAttributes`	Indica si se deben agregar los valores de atributo predeterminados a cada mensaje de registro Los atributos predeterminados que se pueden asignar son HOST_ID, HOST_NWADDR y USER_ID. El valor debe ser `true` o `false`. El valor predeterminado es `true` para el formato ODL-XML y `false` para el formato ODL-Text.
`includeMessageArguments`	Indica si se incluyen argumentos de mensaje con los mensajes de registro con formato que tengan también un identificador de mensaje Valores posibles: `true` (predeterminado) o `false`.
`useThreadName`	Indicador `useThreadName`, que indica controles si el identificador intenta registrar el nombre de subproceso real en lugar del `threadID` proporcionado por el `java.util.logging.LogRecord`. Si el indicador es `true`, el identificador intenta registrar el nombre de subproceso real. En algunos casos, es posible que el identificador no pueda determinar el nombre de subproceso real, en cuyo caso registrará el `threadID`. El valor predeterminado es `true`.
`useRealThreadId`	Indicador `useRealThreadId`, que indica controles si el identificador intenta registrar el identificador de subproceso real en lugar del `threadID` proporcionado por el `java.util.logging.LogRecord`. Si el indicador es `true`, el identificador intenta registrar el identificador de subproceso real. En algunos casos, es posible que el identificador no pueda determinar el nombre de subproceso real, en cuyo caso registrará el `threadID`. El valor predeterminado es `false`. El registro del identificador de subproceso se excluye mutuamente con la propiedad `useThreadName`. Si `useThreadName` es `true`, se ignora el valor de la propiedad `useRealThreadId`.
`locale`	Reemplazo de la configuración regional predeterminada para la localización de mensajes El valor predeterminado es la configuración regional predeterminada, que se define en EPM System Configurator.
`keepOpen`	Indica si el archivo de registro principal se debe mantener abierto en todo momento o abrirse y cerrarse con cada operación de registro. Valores posibles: `true` y `false`. El valor predeterminado es `true`, el cual mantiene el archivo de registro principal abierto en todo momento. En la mayoría de los casos, debe utilizar el valor predeterminado.
`autoFlushLevel`	Valor de nivel para vaciado automático `ODLHandler` permite que los registros se almacenen en buffer, pero vacía automáticamente el buffer cuando este obtiene un registro con un nivel igual o superior al nivel de `autoFlush` especificado. El valor predeterminado es `NOTIFICATION:1`.
`addJvmNumber`	Número de JVM agregado al nombre de archivo de registro El número de JVM lo define la propiedad del sistema `oracle.process.index`. Si no se ha definido la propiedad del sistema, se ignora esta opción.
`applicationContextProvider`	Nombre de una clase que implementa la interfaz de `ApplicationContext` La clase debe tener un constructor predeterminado. El valor especial `disabled` se puede utilizar para desactivar el registro del nombre de aplicación. El proveedor de contexto de aplicación predeterminado es específico de la plataforma; en la mayoría de los casos, no tendrá que definir esta propiedad.
`userContextProvider`	Nombre de una clase que implementa la interfaz de `UserContext` La clase debe tener un constructor predeterminado. El valor especial `disabled` se puede utilizar para desactivar el registro del nombre de usuario. El proveedor de contexto de usuario predeterminado es específico de la plataforma; en la mayoría de los casos, no tendrá que definir esta propiedad.

Modifique las propiedades de los registradores para depurar un componente o generar la información que solicitan los Servicios de Soporte Oracle para identificar problemas con un componentes de EPM System.

Por ejemplo, para capturar los mensajes de depuración de Servicios compartidos de Oracle Hyperion, cambie el nivel de depuración en cada definición de registrador de Servicios compartidos a TRACE:32.

Nota:

Una vez finalizada la depuración, restaure el archivo logging.xml original desde una copia de seguridad para garantizar una configuración de registro óptima.

Para modificar el archivo de configuración de registro:

Cree una copia de seguridad del archivo de configuración de registro del componente de EPM System cuyo comportamiento de registro desea cambiar. Consulte Matriz de registro de productos de EPM System.
Utilice un editor de texto para abrir logging.xml.

Localice las definiciones de registrador. Por ejemplo, para cambiar el nivel de registro de Servicios compartidos, cambie las siguientes definiciones de registrador:

<logger name="oracle.EPMCAS" level="NOTIFICATION:1" useParentHandlers="false">
     <handler name="epmcas-handler" />
</logger>
<logger name="oracle.EPMCES" level="NOTIFICATION:1" useParentHandlers="false">
     <handler name="epmces-handler" />
</logger>
<logger name="oracle.EPMCMS" level="NOTIFICATION:1" useParentHandlers="false">
     <handler name="epmcms-handler" />
</logger>
<logger level="NOTIFICATION:1" name="oracle.EPMCSS">
     <handler name="epmcss-handler" />
</logger>

Modifique la propiedad level según sea necesario para cambiar el nivel de registro de mensaje. Por ejemplo, defina la propiedad level de cada registrador en TRACE:32 para registrar mensajes de depuración detallados.

Consulte Niveles de registro de ODL.
Guarde y cierre logging.xml.
Reinicie el componente de EPM System para activar los cambios.