Ativar Log de Consulta

Para ativar o registro em log de consulta para um cubo do Essbase, crie um arquivo de configurações de registro em log de consulta no diretório de cubo, configure-o e reinicie o cubo. As entradas de log serão gravadas em um arquivo de log de consulta .qlg, que você pode salvar e exibir como xml.

As etapas a seguir explicam como criar um arquivo de configurações de log de consulta. Para ver um arquivo de log de consulta de amostra, consulte Arquivo de Amostra de Log de Consulta.

Para ativar o log de consultas:

1. No diretório de cubo, crie um arquivo de definições de log de consulta.

   O arquivo de definições deve ser nomeado dbname.cfg, em que dbname corresponde ao nome do cubo. Por exemplo, o arquivo de definições do log de consulta para Amostra Básica é basic.cfg. Como os aplicativos Essbase 21c são de modo Unicode, você deve usar um editor de texto ativado para UTF-8 e salvar como UTF-8 com BOM.

   Observação:

   O diretório de cubo significa <Application Directory>/app/appname/dbname. Se você não souber onde <Application Directory> está em seu ambiente,

   • Consulte Locais de Ambiente na Plataforma Essbase se você usar uma implantação independente do Essbase.

   • Se você usar uma implantação do Essbase no Oracle Cloud Infrastructure Marketplace, o <Application Directory> será /u01/data/essbase/app.

2. No arquivo de definições, especifique os elementos obrigatórios e opcionais, usando a sintaxe da seção Sintaxe de Log de Consulta:

   • A dimensão para a qual deseja registrar consultas (QUERYLOG [dimension_name]).

   • Opcional: a definição para registrar números de geração ou de nível para membros de gerações ou níveis especificados em uma dimensão (QUERYLOG GENERATION generation-range ou QUERYLOG LEVEL level-range).

   • Opcional: A definição para excluir o registro de membros de gerações ou níveis especificados em uma dimensão (QUERYLOG NONE GENERATION generation-range ou QUERYLOG NONE LEVEL level-range).

   • Opcional: O local onde o arquivo de log de consulta é criado (QUERYLOG LOGPATH path-expression).

   • Opcional: O formato da saída do arquivo de log (QUERYLOG LOGFORMAT CLUSTER | TUPLE).

   • Opcional: O tamanho do arquivo de log (QUERYLOG LOGFILESIZE n)

   • Opcional: O tamanho de todos os arquivos de log (QUERYLOG TOTALLOGFILESIZE n).

   • Uma configuração para ativar ou desativar o registro de consulta na próxima vez que o aplicativo for iniciado (QUERYLOG ON | OFF).

3. Reinicie o cubo para aceitar as configurações.

   Observação:

   Reinicie depois de criar um arquivo ou alterar qualquer entrada em um arquivo.

4. Depois que o log de consulta for ativado, revise as entradas de log no arquivo de log de consulta, dbname.qlg.

   Por exemplo, você pode exibir a saída do arquivo de log para analisar quantas vezes um determinado membro foi consultado. Use um editor ativado para UTF-8 para exibir os arquivos de log.