Registro

O AEM oferece 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

Estas são todas configurações OSGi.

Observação

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

Registro global

A Configuração de registro do Apache Sling é usada para configurar o agente de registro raiz. Isso define as configurações globais para logon no 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
Observação

Este artigo da Base de conhecimento explica como girar os arquivos request.log e access.log.

Registradores e Escritores para Serviços Individuais

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

  • 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ê canalize 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.

O AEM usa o seguinte para gravar mensagens de registro no arquivo:

  1. Um serviço ​OSGi (logger) grava uma mensagem de registro.
  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 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 do 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)

    • Gravar mensagens sobre o conteúdo da solicitação para 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 Information mensagens 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 Warning mensagens para ../logs/error.log 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 escritores

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 Configuration.

    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 Configuration.

    1. Especificar 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, talvez você queira criar um arquivo de logpersonalizado.

Nesta página