TRACE_REPORT
Use a configuração TRACE_REPORT para depurar o desempenho de várias consultas simultâneas. O rastreamento de consultas ajuda a monitorar as métricas de desempenho da consulta do Essbase. O nível de informações que você deseja manter é reportado no log do aplicativo e/ou em um log de rastreamento separado, trace_report.log.
Descrição
TRACE_REPORT permite o rastreamento de consultas para recuperações de grade, consultas MDX e origens de partição transparentes. O arquivo de saída de rastreamento de consulta inclui informações sobre:
-
O tipo de consulta
-
A hora da consulta
-
Nome de usuário e endereço IP
-
Texto do relatório
Sintaxe
TRACE_REPORT nem que n deve ser definido como -1, para ativar o rastreamento de consultas. O valor padrão é 0 (rastreamento de consulta desativado).
Observação:
O Suporte Técnico da Oracle pode definir um valor inteiro diferente de zero para reduzir os itens registrados emtrace_report.log.
Exemplo
TRACE_REPORT -1Configurando 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.
- 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 |
| 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 |
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.
Notas
TRACE_REPORT se aplica a bancos de dados de armazenamento em blocos (BSO), incluindo aqueles no modo híbrido. TRACE_REPORT não se aplica a bancos de dados de armazenamento agregado (ASO).