DocumentaciónAEM 6.4Guía de implementación

Registro logging

Last update: Fri May 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Developer
CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

AEM le ofrece la posibilidad de configurar:

  • parámetros globales para el servicio de registro central
  • solicitar el registro de datos; una configuración de registro especializada para información de solicitud
  • ajustes específicos para los servicios individuales; por ejemplo, un archivo de registro y un formato individuales para los mensajes de registro

Estos son todos Configuraciones de OSGi.

NOTE
El inicio de sesión en AEM se basa en los principios de Sling. Consulte Registro de Sling para obtener más información.

Registro global global-logging

Configuración de registro de Apache Sling se utiliza para configurar el registrador raíz. Esto define la configuración global para iniciar sesión en AEM:

  • el nivel de registro
  • la ubicación del archivo de registro central
  • el número de versiones que deben conservarse
  • rotación de versiones; bien un tamaño máximo o un intervalo de tiempo
  • el formato que se utilizará al escribir los mensajes de registro
NOTE
Esta Artículo de la base de conocimiento explica cómo girar los archivos request.log y access.log.

Registradores y escritores para servicios individuales loggers-and-writers-for-individual-services

Además de la configuración de registro global, AEM permite configurar opciones específicas para un servicio individual:

  • el nivel de registro específico
  • la ubicación del archivo de registro individual
  • el número de versiones que deben conservarse
  • rotación de versiones; bien el tamaño máximo o el intervalo de tiempo
  • el formato que se utilizará al escribir los mensajes de registro
  • el registrador (el servicio OSGi que proporciona los mensajes de registro)

Esto le permite canalizar mensajes de registro para un solo servicio en un archivo independiente. Esto puede resultar especialmente útil durante el desarrollo o los ensayos; por ejemplo, cuando necesita un nivel de registro mayor para un servicio específico.

AEM utiliza lo siguiente para escribir mensajes de registro en el archivo:

  1. Un Servicio OSGi (logger) escribe un mensaje de registro.
  2. A Registrador toma este mensaje y lo formatea según su especificación.
  3. A Escritor de registros escribe todos estos mensajes en el archivo físico que ha definido.

Estos elementos están vinculados por los siguientes parámetros para los elementos adecuados:

  • Registrador (registrador)

    Defina los servicios que generan los mensajes.

  • Archivo de registro (registrador)

    Defina el archivo físico para almacenar los mensajes de registro.

    Se utiliza para vincular un Registrador de registros con un Escritor de registros. El valor debe ser idéntico al mismo parámetro en la configuración de Logging Writer para la conexión que se va a realizar.

  • Archivo de registro (escritor de registro)

    Defina el archivo físico en el que se escribirán los mensajes de registro.

    Debe ser idéntico al mismo parámetro en la configuración del Escritor de registros o no se producirá la coincidencia. Si no hay coincidencia, se creará un Writer implícito con la configuración predeterminada (rotación diaria del registro).

Registradores y escritores estándar standard-loggers-and-writers

Algunos Registradores y Escritores están incluidos en una instalación AEM estándar.

El primero es un caso especial, ya que controla ambos request.log y access.log archivos:

  • El registrador:

    • Registrador de datos de solicitud personalizable de Apache Sling

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

    • Escribir mensajes sobre el contenido de la solicitud en request.log.

  • Vínculos a:

    • Registrador de solicitudes de Apache Sling

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

    • Escribe los mensajes en request.log o access.log.

Se pueden personalizar si es necesario, aunque la configuración estándar es adecuada para la mayoría de las instalaciones.

Los otros pares siguen la configuración estándar:

  • El registrador:

    • Configuración del registrador de Apache Sling

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

    • Escribe Information mensajes a logs/error.log.

  • Enlaces al escritor:

    • Configuración del Escritor de registro de Apache Sling

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

  • El registrador:

    • Configuración del registrador de Apache Sling (org.apache.sling.commons.log.LogManager.factory.config.649d51b7-6425-45c9-81e6-2697a03d6be7)

    • Escribe Warning mensajes a ../logs/error.log para el servicio org.apache.pdfbox.

  • No vincula a un escritor específico, por lo que creará y utilizará un Writer implícito con la configuración predeterminada (rotación diaria del registro).

Creación de sus propios registradores y escritores creating-your-own-loggers-and-writers

Puede definir su propio par Logger / Writer:

  1. Crear una nueva instancia de la configuración de fábrica Configuración del registrador de Apache Sling.

    1. Especifique el archivo de registro.
    2. Especifique el Registrador.
    3. Configure los demás parámetros según sea necesario.

  2. Crear una nueva instancia de la configuración de fábrica Configuración del Escritor de registro de Apache Sling.

    1. Especifique el archivo de registro: debe coincidir con el especificado para el registrador.
    2. Configure los demás parámetros según sea necesario.
NOTE
En determinadas circunstancias, es posible que desee crear un archivo de registro personalizado.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56