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.

OBSERVAÇÃO

Fazer logon AEM é baseado nos princípios do Sling. Consulte Registro do Sling para obter mais informações.

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
OBSERVAÇÃO

Este artigo da Base de conhecimento explica como girar os arquivos request.log e access.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.
OBSERVAÇÃO

Em determinadas circunstâncias, você pode criar um arquivo de log personalizado.

Nesta página