Logs

AEM oferta a possibilidade de configurar:

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

Essas são todas configurações OSGi.

Registro Global

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

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

Registradores e gravadores para serviços individuais

Além das configurações globais de registro, AEM permite que você defina configurações específicas para um serviço individual:

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

Isso permite que você canal 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 registro no arquivo:

1. Um serviço OSGi (registrador) grava uma mensagem de registro.
2. Um Logging Logger pega esta mensagem e a formata de acordo com sua especificação.
3. Um Gravador de log grava todas essas mensagens no arquivo físico que você definiu.

Estes elementos estão ligados pelos seguintes parâmetros para os elementos apropriados:

• Logger (Logging 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 Logging Logger a um Logging Writer. 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 para o 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

Alguns registradores e gravadores estão incluídos em uma instalação padrão AEM.

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

• O Registrador:

  • Registrador de Dados de Solicitação Personalizável do Apache Sling

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

  • Grave mensagens sobre o conteúdo da solicitação em request.log.

• Links para:

  • Registro de solicitação Sling do Apache

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

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

Eles podem ser personalizados 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 Registrador:

  • 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 Apache Sling Logging Writer

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

• O Registrador:

  • 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 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 Configuração do Apache Sling Logging Logger.

   1. Especifique o arquivo de log.
   2. Especifique o registrador.
   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. Especificar o arquivo de log - deve corresponder ao especificado para o Logger.
   2. Configure os outros parâmetros conforme necessário.