LONGQUERYTIMETHRESHOLD

El valor de configuración LONGQUERYTIMETHRESHOLD permite capturar estadísticas en consultas de cuadrícula y MDX de Essbase de larga ejecución. Especifique la duración del tiempo de consulta más baja en segundos durante la que desea capturar información estadística.

Al activar LONGQUERYTIMETHRESHOLD, Essbase:
  • resume brevemente el rendimiento de las consultas en el log de diagnóstico de Oracle (ODL) para cada consulta que se ejecuta más tiempo que el valor de tiempo especificado
  • define un umbral/filtro en lo que se registra para el rastreo de consultas (cuando la configuración TRACE_REPORT está activada)

Sintaxis

LONGQUERYTIMETHRESHOLD n

donde n es un número de segundos. Si se establece en 0, este valor está desactivado (es el valor predeterminado). Si se establece en -1, esta configuración siempre está activada.

Ejemplo

LONGQUERYTIMETHRESHOLD 60

Especifica la recopilación de estadísticas para consultas que se ejecutan 60 segundos o más.

Configuración del Rastreo de Consultas en Curso

Utilice los valores de configuración TRACE_REPORT y LONGQUERYTIMETHRESHOLD juntos para gestionar la información de rastreo de consultas que se debe recopilar para el cubo en el log de diagnóstico de Oracle (ODL) de la aplicación o imprimirla en trace_report.log.

Puede activar TRACE_REPORT para realizar un seguimiento del rendimiento general de las consultas, pero Oracle recomienda filtrar todas las consultas, excepto las de ejecución más larga, definiendo también LONGQUERYTIMETHRESHOLD.

Idealmente,
  • Configure Essbase para que solo registre información para el 5 por ciento superior de las consultas de ejecución más larga. Si no sabes este valor, 60 segundos pueden ser un buen lugar para comenzar.
  • Compruebe regularmente que los archivos log no crecen demasiado.
Tipo de Configuración Valor TRACE_REPORT LONGQUERYTIMETHRESHOLD valor Efecto en logs
Solo ODL, con umbral Definir en 0 (o no definir en absoluto) Se define en un valor n (segundos) mayor que 0 Las métricas de rendimiento de todas las consultas que se ejecutan durante más de n segundos se imprimen en el log de ODL de la aplicación.
ODL y rastreo, con umbral Definir en -1 Se define en un valor n (segundos) mayor que 0 Las métricas de rendimiento de todas las consultas que se ejecutan durante más de n segundos se imprimen en el log de ODL de la aplicación.

La información sobre las consultas que se ejecutan durante más de n segundos se imprime en trace_report.log.

Rastreo sin umbral: no recomendado Definir en -1 Definir en 0 (o no definir en absoluto) La información sobre todas las consultas, independientemente del tiempo de ejecución, se imprime en trace_report.log.

No se recomienda esta configuración, ya que trace_report.log puede ser demasiado grande si no se filtra mediante un umbral y el rendimiento de la consulta se ve afectado si el umbral es demasiado bajo.

El log trace_report se encuentra en <Domain Home>/servers/<Essbase-Managed-Server-Name>/logs/essbase/essbase/app/<application-name>/<cube-name>/trace_report.log.

El log ODL de la aplicación se encuentra en <Domain Home>/servers/<Essbase-Managed-Server-Name>/logs/essbase/essbase/app/<application-name>/<application-name>_ODL.log.

Para obtener más información sobre las ubicaciones de los archivos log, consulte Ubicaciones de entorno en la plataforma Essbase.

Cuándo Utilizar Diferentes Opciones de Rastreo de Consultas

El valor de configuración QUERYTRACE está diseñado para depurar una sola consulta, en caso de que se observen problemas. Imprime el log de rastreo en el directorio de cubo como query_trace.txt y el archivo se borra por defecto antes de la ejecución de cada consulta. QUERYTRACE no debe dejarse activado en la configuración de la aplicación para uso a largo plazo, ya que puede afectar al rendimiento.

El valor de configuración TRACE_REPORT proporciona menos detalles que QUERYTRACE, pero es capaz de rastrear varias consultas simultáneas. TRACE_REPORT es una buena opción para recopilar información sobre muchas consultas simultáneas que se ejecutan durante un período de tiempo.

La activación del registro de consultas mediante la definición del parámetro QUERYLOG en dbname.cfg (en el directorio de cubo) está diseñada para realizar un seguimiento de los patrones de consulta de usuario para un cubo, en formato XML.