Módulo Log

O módulo log fornece funções de logging para scripts Lua, permitindo registro de mensagens com diferentes níveis de severidade. Este módulo é útil para debugging, monitoramento e auditoria de scripts em produção.

Características principais:

• 5 níveis de log: debug, info, warn, error

• Identificação por contexto de execução

• Formatação automática de valores Lua

• Suporte a múltiplos argumentos com separação por tabulação na saída

Funções Disponíveis

1. log.set_ident(identificador)

Define um identificador para os logs gerados pelo script atual.

Parâmetros:

• identificador (string): Identificador único para o contexto de execução

Retorno:

• nil: A função não retorna valor

Comportamento:

• O identificador é armazenado internamente e persiste durante toda a execução do script

• Todas as mensagens de log subsequentes incluirão este identificador

• Útil para distinguir logs de diferentes scripts ou instâncias

Exemplo de Uso:

-- Definir identificador para um script específico
log.set_ident("monitoramento-cpu")

-- Agora todos os logs incluirão "[monitoramento-cpu]"
log.info("Iniciando monitoramento")
-- Saída: [lua] [monitoramento-cpu] Iniciando monitoramento

-- Em outro script ou contexto
log.set_ident("backup-automatico")
log.info("Iniciando backup")
-- Saída: [lua] [backup-automatico] Iniciando backup

2. log.debug(...)

Registra mensagens de nível DEBUG para informações detalhadas de debugging.

Parâmetros:

• … (múltiplos valores): Valores a serem registrados, separados por tabulação

Retorno:

• nil: A função não retorna valor

Exemplo de Uso:

-- Log de valores de variáveis para debugging
local temperatura = 45.6
local uso_memoria = 78.3
log.debug("Variáveis de sistema:", "Temp:", temperatura, "Mem:", uso_memoria)
-- Saída: [lua] [ident] Variáveis de sistema:  Temp:  45.6  Mem:  78.3

-- Debug de fluxo de execução
log.debug("Entrando na função processar_dados")
log.debug("Parâmetros recebidos:", parametros)
log.debug("Configuração atual:", config)

-- Debug de estruturas complexas
local dados = {
    usuario = "admin",
    acao = "login",
    timestamp = os.time()
}
log.debug("Dados da requisição:", dados)

3. log.info(...)

Registra mensagens de nível INFO para informações gerais sobre a execução.

Parâmetros:

• … (múltiplos valores): Valores a serem registrados, separados por tabulação

Retorno:

• nil: A função não retorna valor

4. log.warn(...)

Registra mensagens de nível WARN para situações que requerem atenção mas não são erros.

Parâmetros:

• … (múltiplos valores): Valores a serem registrados, separados por tabulação

Retorno:

• nil: A função não retorna valor

5. log.error(...)

Registra mensagens de nível ERROR para situações de erro que requerem intervenção.

Parâmetros:

• … (múltiplos valores): Valores a serem registrados, separados por tabulação

Retorno:

• nil: A função não retorna valor