LONGQUERYTIMETHRESHOLD

A definição de configuração LONGQUERYTIMETHRESHOLD permite capturar estatísticas na grade de longa execução do Essbase e nas consultas MDX. Especifique a menor duração de tempo de consulta, em segundos, para a qual deseja capturar informações estatísticas.

Quando você ativa LONGQUERYTIMETHRESHOLD, o Essbase:
  • resume resumidamente o desempenho da consulta no Oracle Diagnostic Log (ODL) para cada consulta executada por mais tempo que o valor de tempo especificado
  • define um limite/filtro no que é registrado para rastreamento de consulta (quando a definição TRACE_REPORT está ativada)

Sintaxe

LONGQUERYTIMETHRESHOLD n

em que n é um número de segundos. Se definido como 0, essa configuração será desativada (esse é o padrão). Se definido como -1, esta configuração está sempre ativada.

Exemplo

LONGQUERYTIMETHRESHOLD 60

Especifica a coleta de estatísticas para consultas que executam 60 segundos ou mais.

Configurando o Rastreamento de Consulta Contínua

Use as definições de configuração TRACE_REPORT e LONGQUERYTIMETHRESHOLD juntas para gerenciar as informações de rastreamento de consulta que devem ser coletadas para o cubo no Oracle Diagnostic Log (ODL) do aplicativo e/ou impressas em trace_report.log.

Você pode ativar TRACE_REPORT para rastrear o desempenho geral da consulta, mas a Oracle recomenda filtrar todas as consultas com exceção das mais longas, definindo também LONGQUERYTIMETHRESHOLD.

Idealmente,
  • Configure o Essbase para registrar apenas informações para os 5% principais de consultas de execução mais longa. Se você não sabe esse valor, 60 segundos podem ser um bom lugar para começar.
  • Verifique regularmente se os arquivos de log não ficam muito grandes.
Tipo de Configuração Valor TRACE_REPORT Valor LONGQUERYTIMETHRESHOLD Efeito nos Logs
Somente ODL, com limite Definir como 0 (ou não definido) Defina como um valor n (segundos) maior que 0 As métricas de desempenho em todas as consultas com mais de n segundos são impressas no log do ODL do aplicativo.
ODL e rastreamento, com limite Definir como -1 Defina como um valor n (segundos) maior que 0 As métricas de desempenho em todas as consultas com mais de n segundos são impressas no log do ODL do aplicativo.

Informações sobre consultas que são executadas por mais de n segundos são impressas em trace_report.log.

Rastreamento sem limite - não recomendado! Definir como -1 Definir como 0 (ou não definido) As informações sobre todas as consultas, independentemente do tempo de execução, são impressas em trace_report.log.

Essa configuração não é recomendada porque o trace_report.log pode se tornar muito grande se não for filtrado usando um limite e o desempenho da consulta será afetado se o limite for muito baixo.

O log trace_report está localizado em <Domain Home>/servers/<Essbase-Managed-Server-Name>/logs/essbase/essbase/app/<application-name>/<cube-name>/trace_report.log.

O log ODL do aplicativo está localizado em <Domain Home>/servers/<Essbase-Managed-Server-Name>/logs/essbase/essbase/app/<application-name>/<application-name>_ODL.log.

Para obter detalhes sobre os locais do arquivo de log, consulte Locais de Ambiente na Plataforma Essbase.

Quando Usar Opções de Rastreamento de Consulta Diferentes

A configuração QUERYTRACE foi projetada para depurar uma única consulta, caso algum problema seja observado. Ele imprime o log de rastreamento no diretório do cubo como query_trace.txt, e o arquivo é limpo por padrão antes de cada execução de consulta. QUERYTRACE não deve ser deixado ativado na configuração do aplicativo para uso a longo prazo, pois pode afetar o desempenho.

A definição de configuração TRACE_REPORT fornece menos detalhes do que QUERYTRACE, mas pode rastrear várias consultas simultâneas. TRACE_REPORT é uma boa opção para coletar informações sobre muitas consultas simultâneas em execução durante um período de tempo.

A ativação do log de consultas definindo o parâmetro QUERYLOG em dbname.cfg (no diretório do cubo) foi projetada para rastrear padrões de consulta do usuário para um cubo, no formato XML.