Reunir e Analisar Logs de Consulta

• Acessando Logs de Consulta
• Níveis de Log de Consulta
• Lendo um Log de Consulta
  • Consulta SQL Lógica
  • Solicitação Lógica
  • Plano de Execução
  • Solicitações Físicas ou do Banco de Dados
  • Estatísticas Resumidas
• Considerações de Log de Consulta
• Acessando Logs de Consulta de uma Pasta de Trabalho

Acessando Logs de Consulta

Níveis de Log de Consulta

• O nível de log determina os detalhes e a quantidade de logs gerados.

• É possível definir o nível de log no nível do sistema, da sessão ou do relatório.

• Você pode definir o nível de log global para seu modelo semântico (RPD) usando a propriedade Nível de registro em log do sistema (em Ferramentas, Opção, Repositório) ou usar a variável de sessão.

  
  .jpg

• É possível substituir o nível de log de um relatório, adicionando a variável LOGLEVEL à propriedade Prefixo, disponível na guia Avançado do relatório.

• Para garantir a obtenção de logs completos, evitando ocorrências no cache, você pode incluir a variável DISABLE_CACHE_HIT=1 em conjunto com LOGLEVEL.

  
  .jpg

• Intervalo de valores de nível de log (LOGLEVEL) entre 0 e 7.

  • LOGLEVEL=0 significa que o registro em log está desativado.
  • LOGLEVEL=7 é o nível de registro em log mais alto, usado principalmente pela equipe de desenvolvimento da Oracle.
  • LOGLEVEL=2 é adequado para ajuste de desempenho e entendimento básico.
  • LOGLEVEL=3 é obrigatório para solucionar problemas de filtros de segurança de dados no nível da linha.

• Dependendo do nível de log, os logs de consultas conterão informações sobre a consulta que incluirão a solicitação lógica, o plano de navegação e execução, a consulta física gerada, bem como tempo de execução, linhas e bytes recuperados em diferentes nós de execução, além de informações relacionadas ao cache.

Os administradores podem extrair logs de consulta na página Emitir SQL, na Console, executando a consulta com as definições apropriadas de variáveis e LOGLEVEL.

Lendo um Log de Consulta

A página Logs de Consulta e Sessões lista todas as consultas e sessões que estão ativas no momento. Os administradores podem acessar essa página na Console.

Cada entrada na página fornece acesso ao log de uma consulta específica, no nível definido (ou seja, no nível de modelo semântico, sessão ou relatório).

.jpg

Cada solicitação tem um requestid exclusivo no Oracle Analytics.

Consulta SQL Lógica

Veja uma amostra de consulta SQL lógica no Oracle Analytics.

Estas são algumas variáveis comuns que você talvez veja em uma solicitação SQL lógica:

• QUERY_SRC_CD: Origem da consulta: Prompt, Relatório, DV, Emitir SQL etc.
• SAW_SRC_PATH: Se a consulta foi salva, é o caminho para ela no catálogo.
• SAW_DASHBOARD: Se a consulta foi incluída em um painel de controle, é o caminho para ele no catálogo.
• SAW_DASHBOARD_PG: Nome da página do painel de controle.

Solicitação Lógica

A solicitação lógica é a conversão de uma consulta de camada de apresentação em camada de modelo de negócios e mapeamento após a adição de filtros de segurança, se houver.

Com base na solicitação lógica, o Oracle Analytics decide se a consulta atinge um cache existente ou se deve ser recuperada do banco de dados.

Plano de Execução

O plano de execução é a transformação da solicitação lógica real em um plano otimizado para execução. Isso inclui um plano de envio para cada operação e se ela é executada no banco de dados ou no Oracle Analytics. Quando uma operação é processada no Oracle Analytics, o log de consulta indica [for database 0:0,0].

Durante a execução da consulta, o Oracle Analytics percorre exatamente essa árvore. Nos logs detalhados, as informações sobre as linhas processadas estão disponíveis em cada nó da árvore de execução.

Solicitações Físicas ou do Banco de Dados

Com base no plano de execução, o Oracle Analytics gera a SQL física a ser executada no banco de dados especificado. Pode haver uma ou mais solicitações enviadas para um ou mais bancos de dados.

Para cada solicitação física enviada ao banco de dados, há um log do número de linhas e bytes recuperados.

Quando há diversas consultas, é possível usar o ID da consulta (neste exemplo, 1914627) para fazer a correspondência com a consulta exata registrada em log na seção Enviando a consulta para o banco de dados. Isso permite mapear a consulta com as linhas recuperadas quando há diversas solicitações do banco de dados.

Um relatório pode enviar diversas consultas para um ou mais bancos de dados, dependendo da estrutura do relatório e da definição do modelo semântico. Por exemplo, neste log de consulta, 3 consultas físicas foram enviadas para o banco de dados.

O log fornece informações de linhas semelhantes processadas para todos os nós no plano de execução. Por fim, as linhas enviadas para o cliente são registradas em log.

O log inclui também um resumo final de estatísticas que inclui o tempo de execução completo. Você pode correlacionar o tempo aqui para analisar e investigar problemas de desempenho.

Estatísticas Resumidas

Considerações de Log de Consulta

• Atividade de thread único. Em circunstâncias adversas, pode ocorrer gargalo de desempenho para níveis de log superiores a 2.

• Os tempos listados e calculados se referem ao momento em que entradas são gravadas no log, e isso é quase sempre quando elas ocorrem (ou seja, a atividade que iniciou a entrada no log). A não ser que haja outros gargalos que impactam o registro em log.

• O registro das consultas em log é para diagnóstico e não tem a intenção de coletar informações de uso. Para saber mais sobre rastreamento de uso, consulte Rastrear Uso.

Acessando Logs de Consulta de uma Pasta de Trabalho

Apenas os administradores podem acessar logs pela página Logs de Consulta e Sessões na Console. No entanto, os autores de conteúdo podem acessar informações de log para consultas de visualização em suas pastas de trabalho por meio do menu Desenvolvedor, e essa é uma ferramenta útil para os autores que desejam solucionar problemas de desempenho de consulta. Para acessar a ferramenta de desempenho para pastas de trabalho (opção de menu Desenvolvedor), os usuários devem habilitar Ativar Opções do Desenvolvedor, que está no menu Avançado, em Meu Perfil.

Quando está ativada, a opção de menu Desenvolvedor é exibida no menu de pasta de trabalho.

A opção Desenvolvedor permite que os usuários exibam e analisem vários logs instantaneamente para qualquer visualização em uma tela. Um quadro separado aparece abaixo da tela, apresentando diferentes guias para cada tipo de informação. Por padrão, os logs não são preenchidos nem atualizados quando a visualização é executada.

Selecione a visualização que deseja analisar e clique em Atualizar para gerar os logs. Depois de atualizadas, várias informações relacionadas à visualização são exibidas e você pode analisar as informações do log para a visualização específica. Para analisar diversas visualizações, atualize-as individualmente e analise-as uma por uma.