O servidor PPM usa a interface log4J para exibir mensagens do sistema. Cada componente do PPM (por exemplo, importação de dados, merger, calculadora de medidas) usa os próprios agentes de log. Os módulos do sistema PPM (componentes) têm os seguintes agentes de log superiores: log, trace e audit.
Por padrão, o sistema PPM possui os seguintes appenders para saída de mensagens formatadas.
Appender |
Descrição |
console |
As mensagens são enviadas para a console. Apenas relevante para programas de linha de comando. |
logFile |
As mensagens são gravadas em um arquivo. O nome do arquivo é especificado pela chave de configuração log4j.appender.logFile.File. |
errorFile |
Mensagens de erro e exceções (saída de log iniciada com E: ou F:) são gravadas em um arquivo. O nome do arquivo é especificado pela chave de configuração log4j.appender.errorFile.File. |
traceFile |
As mensagens são gravadas exclusivamente em um arquivo. O nome do arquivo é especificado pela chave de configuração log4j.appender.traceFile.File. |
auditFile |
Grava mensagens de log de auditoria em um arquivo. O nome do arquivo é especificado pela chave de configuração log4j.appender.auditFile.File. |
Para o servidor do cliente, a saída de mensagens é configurada no arquivo Server_Log_settings.properties, para o servidor de análise, no arquivo AnalysisServer_Log_settings.properties. Ambos os arquivos de configuração, incluindo suas entradas padrão, são criados automaticamente durante a instalação.
Os arquivos de configuração Server_Log_settings.properties e AnalysisServer_Log_settings.properties são verificados a cada 60 segundos (definição fixa). Portanto, a configuração da saída de log pode ser alterada sem ser necessário reiniciar os servidores do PPM.
Log baseado em módulos
Os nomes de módulos familiares do PPM são usados para a saída de mensagens do sistema do servidor cliente do PPM e do servidor de análise. Eles são configurados nos arquivos Server_Log_settings.properties (servidor do cliente) ou AnalysisServer_Log_settings.properties (servidor de análise), respectivamente.
O PPM suporta os seguintes módulos do agente de log:
Nome do módulo |
Descrição |
LOG.XML |
Importação de dados XML do sistema de origem |
LOG.EIM |
Importação interna de instâncias de fragmento importadas |
LOG.MGR |
Merge de fragmentos de processo |
LOG.TYP |
Tipificação das instâncias de processo |
LOG.KIC |
Cálculo de medidas e dimensões |
LOG.PLV |
Cálculo do valor planejado |
LOG.CFG |
Gestão da configuração interna |
LOG.STD |
Servidor PPM em modo STANDARD |
LOG.SRV |
Módulo padrão usado para saída de log do servidor do PPM |
LOG.CNV |
Conversor de bancos de dados |
LOG.IMP |
Importação e exportação de configurações (por exemplo, usando runppmconfig) |
LOG.ADM |
Administração do cliente (por exemplo, usando runppmadmin) |
LOG.KG |
Criação de chaves para fragmentos de processo importados (gerador de chaves) |
LOG.PRF |
Profiler (SA) |
LOG.OLA |
Interface de consulta |
LOG.REP |
Criação de relatórios |
LOG.RAU |
Automação de relatório |
LOG.MST |
Servidor do PPM em modo MASTER |
LOG.SUB |
Servidor do PPM em modo SUBSERVER |
LOG.LOG |
Saída de log geral |
LOG.EAL |
Sistema de alerta antecipado |
LOG.ALY |
Análise de irregularidades (runppmanalytics) |
LOG.CCS |
Calculador de atributo em modo SILENT |
LOG.CCD |
Calculador de atributo em modo DEFAULT |
LOG.CCV |
Calculador de atributo em modo VERBOSE |
LOG.PFM |
Cliente sysmon |
LOG.MON |
Monitoramento de consultas |
LOG.PFS |
Estatísticas de favoritos específicos do usuário |
LOG.SFS |
Estatísticas de favoritos compartilhados |
LOG.CPI |
Melhorias, administração de mensagens |
LOG.ASRV |
Módulo padrão usado para saída de log do servidor de análise |
LOG.MEM |
Sistema de alerta antecipado em caso de insuficiência de memória |
LOG.DAI |
Importação de análise de dados |
Na saída de mensagem, os códigos do módulo (correspondentes ao nome do módulo sem o prefixo LOG.) não estão localizados. Portanto, para mensagens da calculadora de medidas, o código do módulo é KIC.
Tem de especificar um nível de log para cada módulo do agente de log. Os seguintes níveis de log são suportados: INFO, WARN, ERROR, FATAL, OFF. A afinidade dos níveis de log selecionados aumenta da direita para a esquerda, ou seja, se definir o nível de log para WARN, as mensagens dos níveis ERROR e FATAL também são enviadas.
Exemplo
Informações, avisos, erros e erros críticos devem ser enviados na console para a importação de dados XML.
log4j.logger.LOG.XML=INFO,console
Saída de mensagem de rastreamento
Em contraste com os módulos de agente de log, os módulos de rastreamento não possuem níveis de log. Em vez disso, a saída de mensagens pode ser ligada ou desligada. Esta saída contém mais informações sobre o erro. Existem os seguintes módulos de rastreamento: ASRV, SRV, CONFIG, ABT, CONPOOL, FRQ, RET, RETDS, RETQT, QPL, SELITY, DIM, IMP, RMI, MEM, MON, PPI, EIP, CLC, UPD, DST, QUE, SES, TRANS, RSAPI, RSPPMUI, RSCONFMC, RSPMC
Em vez do nível de log, pode especificar as seguintes configurações para os módulos de rastreamento: OFF, TRACE.
Exemplo
As mensagens de rastreamento devem ser enviadas para o servidor do cliente, mas não para o servidor de análise.
log4j.logger.TRACE.SRV=TRACE
log4j.logger.TRACE.ASRV=OFF
Prefixos de saída de log
Cada saída de log tem um prefixo indicando o nível de log correspondente. Este prefixo é idêntico para todos os idiomas.
Nível de log |
Prefixo para todos os idiomas |
Estatística |
S: |
FATAL |
F: |
ERROR |
E: |
WARN |
W: |
INFO |
I: |
TRACE |
T: |
As mensagens de estatísticas são emitidas sempre e só podem ser suprimidas pelo nível de log OFF.
Formato de saída de log
O formato de saída de log é especificado nos dois arquivos de configuração Server_Log_settings.properties e AnalysisServer_Log_settings.properties. O formato de data padrão do PPM é especificado por %d{ppmdate} em esses arquivos.
O formato de data usado depende do idioma em que o cliente e os servidores de análise foram iniciados. Os seguintes formatos de data são usados para os seis idiomas suportados pelo PPM:
Idioma |
Locale |
Formato da data |
Inglês EUA |
EN |
MM/dd/aa HH:mm:ss |
Inglês GB* |
US |
dd/MM/aa HH:mm:ss |
Alemão |
DE |
dd.MM.aa HH:mm:ss |
Francês |
FR |
dd.MM.aa HH:mm:ss |
Japonês |
JA |
dd/MM/aa HH:mm:ss |
Russo |
RU |
dd.MM.aa HH:mm:ss |
Chinês |
ZH |
dd/MM/aa HH:mm:ss |
*O formato de data Inglês EUA é usado pelo PPM como padrão. Para alternar com o formato de data Inglês GB, consulte a documentação Instalação do PPM, capítulo Adaptar o formato da data ao idioma Inglês britânico.
Exemplo
log4j.appender.error.File.layout.ConversionPattern=%p %d{ppmdate} [%c{1}] %m%n
Sistemas dimensionados
A configuração da saída da mensagem de log para um sistema escalado PPM é basicamente igual à de um sistema padrão com apenas um servidor do PPM. No entanto, o seguinte deve ser observado: