Logs

O AEM oferece a possibilidade de configurar:

• parâmetros globais para o serviço de registro central
• Solicitar registro de dados; uma configuração de registro especializada para obter informações de solicitação
• Configurações específicas para cada serviço; por exemplo, um arquivo de log individual e o formato para as mensagens de log

Estas são todas configurações OSGi.

Registro Global

A configuração de registro do Apache Sling é usada para configurar o logger raiz. Isso define as configurações globais para fazer logon AEM:

• o nível de registro
• a localização do ficheiro de registro central
• o número de versões a conservar
• rotação de versão; tamanho máximo ou intervalo de tempo
• o formato a ser usado ao gravar mensagens de log

Registradores e gravadores para serviços individuais

Além das configurações de registro global, o AEM permite definir configurações específicas para um serviço individual:

• nível de registro específico
• a localização do ficheiro de registro individual
• o número de versões a conservar
• rotação de versão; tamanho máximo ou intervalo de tempo
• o formato a ser usado ao gravar mensagens de log
• o logger (o serviço OSGi que fornece as mensagens de log)

Isso permite canalizar mensagens de log de um único serviço em um arquivo separado. Isto pode ser particularmente útil durante o desenvolvimento ou testes; por exemplo, quando você precisa de um nível de log aumentado para um serviço específico.

AEM usa o seguinte para gravar mensagens de log no arquivo:

1. Um serviço OSGi (logger) grava uma mensagem de log.
2. Um Logging Logger pega essa mensagem e a formata de acordo com sua especificação.
3. Um Gravador de log grava todas essas mensagens no arquivo físico definido.

Esses elementos são vinculados pelos seguintes parâmetros para os elementos apropriados:

• Logger (logger)

  Defina os serviços que geram as mensagens.

• Arquivo de log (registrador de log)

  Defina o arquivo físico para armazenar as mensagens de log.

  Isso é usado para vincular um Agente de registro a um Escritor de registro. O valor deve ser idêntico ao mesmo parâmetro na configuração do Gravador de log para que a conexão seja feita.

• Arquivo de log (Gravador de log)

  Defina o arquivo físico no qual as mensagens de log serão gravadas.

  Isso deve ser idêntico ao mesmo parâmetro na configuração do Gravador de log, ou a correspondência não será feita. Se não houver correspondência, um Escritor implícito será criado com a configuração padrão (rotação diária do log).

Registradores e Escritores Padrão

Determinados Registradores e Escritores estão incluídos em uma instalação padrão de AEM.

O primeiro é um caso especial, pois controla os arquivos request.log e access.log:

• O logger:

  • Apache Sling Customizable Request Data Logger

    (org.apache.sling.engine.impl.log.RequestLoggerService)

  • Escreva mensagens sobre o conteúdo da solicitação para request.log.

• Links para:

  • Logon de solicitação do Apache Sling

    (org.apache.sling.engine.impl.log.RequestLogger)

  • Grava as mensagens em request.log ou access.log.

Elas podem ser personalizadas, se necessário, embora a configuração padrão seja adequada para a maioria das instalações.

Os outros pares seguem a configuração padrão:

• O logger:

  • Configuração do Apache Sling Logging Logger

    (org.apache.sling.commons.log.LogManager.fatory.config)

  • Grava mensagens Information em logs/error.log.

• Links para o Escritor:

  • Configuração do gravador de log do Apache Sling

    (org.apache.sling.commons.log.LogManager.fatory.writer)

• O logger:

  • Configuração do Apache Sling Logging Logger
    (org.apache.sling.commons.log.LogManager.fatory.config.649d51b7-6425-45c9-81e6-2697a03d6be7)

  • Grava mensagens Warning em ../logs/error.log para o serviço org.apache.pdfbox.

• Não se vincula a um Escritor específico, portanto, criará e usará um Escritor implícito com configuração padrão (rotação diária do log).

Criando seus próprios registradores e gravadores

Você pode definir seu próprio par de Registrador/Escritor:

1. Crie uma nova instância da Configuração de fábrica Apache Sling Logging Logger Configuration.

   1. Especifique o arquivo de log.
   2. Especifique o logger.
   3. Configure os outros parâmetros, conforme necessário.

2. Crie uma nova instância da Configuração de fábrica Configuração do Apache Sling Logging Writer.

   1. Especifique o Arquivo de Log - deve corresponder ao especificado para o Logger.
   2. Configure os outros parâmetros, conforme necessário.