Class: Logger

@nginstack/engine/lib/log/Logger~ Logger


new Logger()

Classe responsável por tratar a geração de logs do sistema. Baseada na biblioteca log4j (http://logging.apache.org/log4j/docs/). O link "http://logging.apache.org/log4j/docs/manual.html" contém uma introdução aos conceitos da biblioteca log4x. Para criar um Logger, deve ser utilizado o método de classe Logger.getLogger().

Esta classe também é publicada pelo Engine por meio da variável global Logger.

See:

Methods


<static> getLogger(category)

Cria uma instância da classe Logger para a categoria informada. Uma categoria de log possui a finalidade de agrupar e identificar um conjunto de logs, permitindo configurações como: direcionamento da saída do log (Appender), layout das informações gravadas (Layout) e a prioridade habilitada.

Parameters:
Name Type Description
category string

Indica o módulo ou processo que está gerando as informações. A categoria pode definir uma hierarquia. Exemplo: "product.module".

Returns:

Instância da classe Logger.

Type
Logger

<static> propertyConfig(config)

Configura as categorias de log. A configuração informada irá complementar a configuração padrão do sistema, que pode ser consultada na página "Logger" do Manage.

Parameters:
Name Type Description
config string

Script de configuração.


debug(log [, formatArgs])

Gera um log com a prioridade DEBUG. Este nível de prioridade deve ser utilizado para informações de depuração de um processo.

Normalmente esta prioridade é ignorada em um ambiente de produção.

O parâmetro log pode conter parâmetros de formatação, seguindo a conversão utilizada no toFormattedString. Os valores dos parâmetros devem ser informados após o parâmetro log.

Parameters:
Name Type Argument Description
log string

Texto a ser escrito no log.

formatArgs * <optional>
<repeatable>

Argumentos esperados pela expressão de formatação indicada

Example
const Logger = require('@nginstack/engine/lib/log/Logger.js');
const logger = Logger.getLogger('ClassName');
logger.debug('Método %s executado em %d milissegundos.', methodName, time);

error(log [, formatArgs])

Gera um log com a prioridade ERROR. Este nível de prioridade deve ser utilizado para registrar um erro não esperado, o que impediu a execução de uma rotina ou um processo.

Normalmente esta prioridade é ativada em um ambiente de produção.

O parâmetro log pode conter parâmetros de formatação, seguindo a conversão utilizada no toFormattedString. Os valores dos parâmetros devem ser informados após o parâmetro log.

Parameters:
Name Type Argument Description
log string

Texto a ser escrito no log.

formatArgs * <optional>
<repeatable>

Argumentos esperados pela expressão de formatação indicada em log.

Example
const Logger = require('@nginstack/engine/lib/log/Logger.js');
const logger = Logger.getLogger('ClassName');
logger.error('Usuário %s não tem poder de aprovação.', session.userName);

fatal(log [, formatArgs])

Gera um log com a prioridade FATAL. Este nível de prioridade deve ser utilizado apenas para registrar erros críticos irrecuperáveis que comprometem o funcionamento do sistema.

Normalmente, esta prioridade é ativada em um ambiente de produção.

O parâmetro log pode conter parâmetros de formatação, seguindo a conversão utilizada no toFormattedString. Os valores dos parâmetros devem ser informados após o parâmetro log.

Parameters:
Name Type Argument Description
log string

Texto a ser escrito no log

formatArgs * <optional>
<repeatable>

Argumentos esperados pela expressão de formatação indicada em log.

Example
const Logger = require('@nginstack/engine/lib/log/Logger.js');
const logger = Logger.getLogger('ClassName');
logger.fatal('Esgotamento de memória.');

info(log [, formatArgs])

Gera um log com a prioridade INFO. Este nível de prioridade deve ser utilizado para informações que não requerem uma atenção imediata do administrador, como detalhes de um processamento ou dicas de performance.

Normalmente, esta prioridade é ativada em um ambiente de produção.

O parâmetro log pode conter parâmetros de formatação, seguindo a conversão utilizada no toFormattedString. Os valores dos parâmetros devem ser informados após o parâmetro log.

Parameters:
Name Type Argument Description
log string

Texto a ser escrito no log.

formatArgs * <optional>
<repeatable>

Argumentos esperados pela expressão de formatação indicada em log.

Example
const Logger = require('@nginstack/engine/lib/log/Logger.js');
const logger = Logger.getLogger('ClassName');
logger.info('%d registros corrigidos pelo reprocessamento.', count);

warn(log [, formatArgs])

Gera um log com a prioridade WARN. Este nível de prioridade deve ser utilizado para registrar situações que devem receber atenção do administrador, mas que não impedem a utilização do sistema.

Normalmente, esta prioridade é ativada em um ambiente de produção.

O parâmetro log pode conter parâmetros de formatação, seguindo a conversão utilizada no toFormattedString. Os valores dos parâmetros devem ser informados após o parâmetro log.

Parameters:
Name Type Argument Description
log string

Texto a ser escrito no log.

formatArgs * <optional>
<repeatable>

Argumentos esperados pela expressão de formatação indicada em log.

Example
const Logger = require('@nginstack/engine/lib/log/Logger.js');
const logger = Logger.getLogger('ClassName');
if (memAllocPercentual > 70) {
  logger.warn('Memória em uso atingiu %d%% da capacidade.', memAllocPercentual);
}