Programas de linha de comando

Os programas de linha de comando gravam suas mensagens na console ou no arquivo de log especificado com o parâmetro -protocolfile, ver o capítulo Parâmetros comuns). Não existe diferença entre um arquivo de erro e de rastreamento. As exceções são enviadas com outra saída de log no arquivo especificado ou na console. O valor da chave PRINT_STACKTRACE_ON_EXCEPTION no arquivo de configuração Server_settings.properties especifica se o rastreamento de pilha de uma exceção também é enviado. Os valores válidos são TRUE e FALSE, o valor padrão é FALSE.

As opções de log especificadas (parâmetros -information, -warning, -error) definem o nível de log para cada módulo, para o valor especificado INFO, WARN ou ERROR. Será considerado o nível de log configurado para o módulo do arquivo Server_Log_settings.properties. Note o seguinte quando avaliar as opções de log especificadas, devido à estrutura de nível de log hierárquico. O nível de log a ser usado é determinado da seguinte maneira:

  1. O último parâmetro no encontrado é determinado segundo a ordem dos parâmetros -information, -warning, -error especificados.
  2. O primeiro parâmetro yes encontrado é determinado segundo a ordem dos parâmetros -information, -warning, -error especificados.
  3. A partir do valor "no" encontrado por último na primeira etapa e com base no nível de log padrão específico do módulo, é determinado o nível de log mais restritivo. Se nenhum valor "no" for especificado, será aplicado o nível de log.
  4. A partir do valor yes encontrado em primeiro lugar na segunda etapa e com base no nível de log determinado na terceira etapa, é determinado o nível de log mais restritivo.

Exemplo 1

O nível de log padrão para o módulo é INFO. Quando executar um programa de linha de comando com os parâmetros –information yes –warning no –error yes, o nível de log é determinado da seguinte forma.

O nível de log resultante é INFO.

Exemplo 2

O nível de log padrão para o módulo é WARN. Quando executar um programa de linha de comando com os parâmetros –information yes, o nível de log é determinado da seguinte forma.

O nível de log resultante é INFO.

Exemplo 3

O nível de log padrão para o módulo é INFO. Quando executar um programa de linha de comando com os parâmetros –warning no, o nível de log é determinado da seguinte forma.

O nível de log resultante é ERROR.

Sumário

Formato de saída de log

O formato da saída de log dos programas de linha de comando para a saída da console é especificado pelo formato do appender console. O formato de saída do log da saída de log para um arquivo é especificado pelo appender logFile.

Exceto para os estilos do appender, nenhuma outra configuração é avaliada para os programas de linha de comando a partir dos arquivos Server_Log_settings.properties e Analysisserver_Log_settings.properties. Portanto, os appenders adicionais para a saída de log dos programas da linha de comando não podem ser especificados.

Saída de log do servidor

Os programas de linha de comando runppmconfig, runppmreport e runppmadmin enviam mensagens de log específicas do servidor do cliente e do servidor de análise. Essas mensagens aparecem na saída de log do servidor e na saída de log do programa de linha de comando e são indicadas pelo nome do módulo adicional.

Exemplo

...

I: 05.10.10 14:41:53 [IMP] Importar a configuração do componente "users"...

I: 05.10.10 14:41:53 [IMP] [SRV] Importar usuários...

I: 05.10.10 14:41:53 [IMP] [SRV] Importar grupos...

I: 05.10.10 14:41:53 [IMP] [SRV] Foram adicionados os seguintes 0 usuários: []

I: 05.10.10 14:41:53 [IMP] A configuração do componente "users" do arquivo

...