O servidor PPM usa a interface log4J2 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 appender.logFile.fileName.
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 appender.errorFile.fileName.
As exceções e rastreamentos de pilha são enviados exclusivamente para este arquivo.
traceFile As mensagens são gravadas exclusivamente em um arquivo. O nome do arquivo é especificado pela chave de configuração appender.traceFile.fileName.
Esse appender é usado para coletar determinadas mensagens para suportar a solução de problemas.
auditFile Grava mensagens de log de auditoria em um arquivo. O nome do arquivo é especificado pela chave de
configuração appender.auditFile.fileName.
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
Nome do módulo
Descrição
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.
logger.LOG.XML.name=LOG.XML logger.LOG.XML.level=INFO
logger.LOG.XML.appenderRef.console.ref = console
▪ Os níveis de log não fazem distinção entre maiúsculas e minúsculas, por exemplo, logger.LOG.XML.level=error é igual a logger.LOG.XML.level=ERROR.
▪ Os níveis de log incorretos, tais como logger.LOG.XML.level=error são ignorados. Neste caso, é usado o nível de log do agente de log superior, que é logger.LOG.level=INFO neste exemplo.
▪ Se nenhum nível de log foi especificado para um módulo do agente de log, o nível de log do agente de log superior se aplica, neste exemplo, isso seria logger.LOG.level=INFO.
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.
logger.TRACE.SRV.level=TRACE logger.TRACE.ASRV.level=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
appender.errorFile.layout.pattern=%p %xd{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:
▪ Todas as mensagens de exceção e rastreamento são exibidas nos subservidores
correspondentes. As exceções são passadas para o servidor mestre e gravadas em seu log de erros.
▪ Como o servidor mestre não está conectado a um servidor de análise, os servidores mestres podem gerar apenas mensagens de rastreamento do servidor do cliente. As mensagens de rastreamento dos servidores de análise são gravadas na saída de log dos respectivos subservidores.