Mensagens do sistema (saída de log)

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.
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 log4j.appender.traceFile.File.
Esse appender é usado para coletar determinadas mensagens para suportar a solução básica de problemas .

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: