Sub-sistema de administração de logs

RTLOG

Descrição

Subsistema que captura e gerencia registros históricos do que aconteceu no sistema. Este sub-sistema permite capturar vários eventos do sistema registrando-os em tabelas que podem ser consultadas de diversas formas.
Além da auditoria, os dados registrados por este subsistema também podem ser utilizados para replicação e journaling.

Procedimentos

Interfaces

Dúvidas frequentes

Configurações

RTLOG.CON_JOURNALING.MIGRAR_LOGS_AUTOMATICAMENTE

Migrar LOGs automaticamente

Caso marcado, indica que o sistema tentará migrar automaticamente os LOGs para o histórico.

Tipo: FLAG

Valor padrão: S

RTLOG.CON_JOURNALING.NULL_TEXT

Texto a ser apresentado para indicar que o campo não está informado

Define o texto que deve ser apresentado para indicar que um determinado campo não está ou estava informado.
Caso não configurado, assume "(não informado)".

Tipo: TEXT

RTLOG.CON_JOURNALING.TEMPLATE_DESCRICAO_DELETE

Template para apresentação da descrição de uma exclusão

Template HTML utilizado para formar a descrição de registros de exclusão.
O template DEVE se formado por 3 linhas HTML:
A segunda linha será repetida para cada atributo inserido/alterado e as seguintes macro-substituições deverão ser utilizadas:

  • ${label}: Título (label) utilizado para identificar o atributo.
  • ${antes}: O valor do atributo antes da operação.
  • ${depois}: O valor do atributo após a operação.

Exemplos:
  • Simplificado (apenas indica que o registro foi excluído):
Registro excluído

  • Simplificado apresentando os valores antigos:
<strike><b>${label}:</b> ${antes}</strike><br>

Tipo: TEXT_LONG

RTLOG.CON_JOURNALING.TEMPLATE_DESCRICAO_INSERT

Template para apresentação da descrição de uma inclusão

Template HTML utilizado para formar a descrição de registros de inclusão.
O template DEVE se formado por 3 linhas HTML:
A segunda linha será repetida para cada atributo inserido/alterado e as seguintes macro-substituições deverão ser utilizadas:

  • ${label}: Título (label) utilizado para identificar o atributo.
  • ${antes}: O valor do atributo antes da operação.
  • ${depois: O valor do atributo após a operação.

Exemplos:
  • Modelo simplificado:

<b>${label}:</b> ${depois}<br>

  • Modelo em tabela
<table class="form"><tbody>
<tr><td class="label"><b>${label}:</b></td><td>${depois}</td></tr>
</tbody></table>

Tipo: TEXT_LONG

RTLOG.CON_JOURNALING.TEMPLATE_DESCRICAO_UPDATE

Template para apresentação da descrição de uma alteração

Template HTML utilizado para formar a descrição de registros de alteração.
O template DEVE se formado por 3 linhas HTML:
A segunda linha será repetida para cada atributo alterado e as seguintes macro-substituições deverão ser utilizadas:

  • ${label}: Título (label) utilizado para identificar o atributo.
  • ${antes}: O valor do atributo antes da operação.
  • ${depois: O valor do atributo após a operação.

Exemplos:
Apresentar os valores organizados em uma tabela
<table class="form"><tbody><tr><th></th><th>De</th><th>Para</th></tr>
<tr><td class="label"><b>${label}:</b></td><td>${antes}</td><td>${depois}</td></tr>
</tbody></table>

Apresentar os valores de forma simplificada (padrão)

<b>${label}:</b> <strike>${antes}</strike> ${depois}<br>

Resultado:
Nome do campo: Valor antigo Valor novo
Outro: 215,90 225,55

Tipo: TEXT

RTLOG.CON_LOGS.LIST_LINHAS_DESCRICAO_MAX

Define o número máximo de linhas que são apresentadas na descrição na tela de LIST.

Valor padrão: 6

RTLOG.CON_LOGS.LIST_TAMANHO_DESCRICAO_MAX

Define a largura máxima das linhas a serem apresentadas na tela de LIST.

Valor padrão: 50

RTLOG.EVENT_LISTENER

Geração de LOGs para os envios de e-mail

Configura o listener necessário para a geração de logs no envio de e-mails (ver RTLOG.LOGS.LOG_MAIL).

Tipo: TEXT

Valor padrão: RT.SMTP.SEND_MAIL_SUCCESS_EVENT : RTLOG.LOGS RT.SMTP.SEND_MAIL_EXCEPTION_EVENT : RTLOG.LOGS

RTLOG.LOGS.LOG_MAIL

Gerar logs no envio de e-mails

Define se deve ou não gerar logs no envio de e-mails realizados pelo sistema.
Os seguintes valores são aceitos:

  • S: Sim - Gerar LOG de qualquer e-mail enviado.
  • N: Não - Não gerar LOG no envio de e-mails.
  • E: Gerar LOG apenas para erros obtidos na tentativa de envio de e-mails.
Atenção
Para que os LOGs sejam realizados, é necessário que o listener dos eventos de e-mail estejam devidamente configurados.
Ver RTLOG.EVENT_LISTENER.

Tipo: OPCAO

Valor padrão: S

RTLOG.LOGS_SISTEMA.LOG_MAIL

Gerar logs no envio de e-mails

Define se deve ou não gerar logs no envio de e-mails realizados pelo sistema.

Tipo: OPCAO

Valor padrão: S

RTLOG.RETENCOES_LOGS.MAX_DIAS_EXCLUSAO

Máximo de dias a serem excluídos

Indica o número máximo de dias a serem excluídos em um processo de remoção de logs expirados (ver Retenções dos LOGs). Esta preferencia é utilizada para evitar que uma rotina tente excluir um número muito grande de registros em um mesmo processo. Por padrão, sugere-se que a rotina de limpeza dos logs seja executada diariamente e que exclua no máximo 10 dias.

Exemplo
Digamos que a preferencia esteja configurada para 10 dias.
O tempo de retenção do tipo de log é de 1 ano (365 dias)

Caso tenhamos 2 anos de log, teoricamente teria 1 ano de log já expirado, mas ao executar a rotina de limpeza, ao invés de excluir 1 ano inteiro, a rotina irá excluir apenas 10 dias.
Caso tenha um JOB para excluir os LOGs expirados diariamente, levará 36 dias até que a rotina "alcance" o prazo normal de expiração.

Ver o método

Tipo: INTEGER

Valor padrão: 10

RTLOG.RT.LOG.INSERT_DML

DML a ser utilizado para inserir um LOG.

Tipo: TEXT

Valor padrão: INSERT INTO logs (id, data_hora, descricao, endereco_remoto, tempo, origem, registro, sessao_id, tipo, usuario, usuario_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)

RTLOG.RT.LOG.LOGGER

Valor padrão: br.com.telescope.t2.log.TableLogger

RTLOG.VERSAO

Versão do sistema de LOG

Indica qual a versão do sistema de LOG a ser utilizado.
A versão 1 utiliza a tabela LOGS e DML_LOGS para a replicação. É o sistema padrão em uso.
A versão 2 utiliza as tabelas LOGS_SISTEMAS, LOGS_DADOS e V_LOGS_SISTEMAS. É um sistema em testes que resolve algumas questões de performance da versão 1.

Tipo: INTEGER

Valor padrão: 1