AEM Depuración de registros as a Cloud Service con

AEM AEM Los registros actúan como primera línea para depurar aplicaciones de la en el as a Cloud Service AEM, pero dependen del registro adecuado en la aplicación de la aplicación de la aplicación implementada de la.

AEM Toda la actividad de registro del servicio de registro de un entorno determinado (Dispatcher de creación, publicación o publicación) se consolida en un único archivo de registro, incluso si diferentes pods dentro de ese servicio generan las instrucciones de registro.

Los ID de secuencia se proporcionan en cada sentencia de registro y permiten filtrar o intercalar sentencias de registro. Los ID de la secuencia tienen el formato:

Archivos de registro personalizados

AEM como Cloud Service no admite archivos de registro personalizados, pero sí admite el registro personalizado.

AEM Para que los registros de Java estén disponibles en el as a Cloud Service (a través de ). Cloud Manager o CLI DE ADOBE I/O), las instrucciones de registro personalizadas deben escribirse en error.log. Registros escritos en registros con nombres personalizados, como example.logAEM , no será accesible desde el as a Cloud Service de la.

Los registros se pueden escribir en error.log usar una propiedad de configuración OSGi de LogManager de Sling en el org.apache.sling.commons.log.LogManager.factory.config~example.cfg.json archivos.

{
   ...
   "org.apache.sling.commons.log.file": "logs/error.log"
   ...
}

AEM Registros del servicio de autor y publicación de

AEM AEM Tanto los servicios de autor como los de publicación proporcionan registros de servidor en tiempo de ejecución de la:

AEM Publicar registros de Dispatcher

AEM AEM AEM Solo Dispatcher de publicación de datos proporciona registros de Apache Web Server y Dispatcher, ya que estos aspectos solo existen en el nivel de publicación de la y no en el nivel de Author de la.

Cloud Manager cloud-manager

Adobe Cloud Manager permite la descarga de registros, por día, a través de la acción Descargar registros de un entorno.

Estos registros se pueden descargar e inspeccionar mediante cualquier herramienta de análisis de registros.

CLI de Adobe I/O con complemento de Cloud Manager aio

Adobe AEM Cloud Manager admite el acceso a los registros as a Cloud Service de la a través de CLI DE ADOBE I/O con el Complemento de Cloud Manager para la CLI de Adobe I/O.

Primero, configuración del complemento Adobe I/O con Cloud Manager.

Asegúrese de que se han identificado el ID de programa y el ID de entorno relevantes y utilice list-available-log-options para enumerar las opciones de registro utilizadas para lo siguiente cola o descargar registros.

$ aio cloudmanager:list-programs
Program Id Name      Enabled
14304      Program 1 true
11454      Program 2 true
11502      Program 3 true

$ aio config:set cloudmanager_programid <PROGRAM ID>

$ aio cloudmanager:list-environments
Environment Id Name            Type  Description
22295          program-3-dev   dev
22310          program-3-prod  prod
22294          program-3-stage stage

$ aio cloudmanager:list-available-log-options <ENVIRONMENT ID>
Environment Id Service    Name
22295          author     aemaccess
22295          author     aemerror
22295          author     aemrequest
22295          publish    aemaccess
22295          publish    aemerror
22295          publish    aemrequest
22295          dispatcher httpdaccess
22295          dispatcher httpderror
22295          dispatcher aemdispatcher

Registros de cola aio-cli-tail-logs

La CLI de Adobe I/O AEM proporciona la capacidad de rastrear registros en tiempo real desde la as a Cloud Service con el uso de la función de seguimiento en tiempo real de. registros de cola comando. AEM El seguimiento es útil para ver la actividad de registro en tiempo real a medida que las acciones se realizan en el entorno as a Cloud Service de la.

$ aio config:set cloudmanager_programid <PROGRAM ID>
$ aio cloudmanager:tail-logs <ENVIRONMENT ID> <SERVICE> <NAME>

Otras herramientas de línea de comandos, como grep se puede usar de forma conjunta con tail-logs para ayudar a aislar las instrucciones de registro de interés, por ejemplo:

$ aio cloudmanager:tail-logs 12345 author | grep com.example.MySlingModel

… solo muestra las instrucciones de registro generadas a partir de com.example.MySlingModel o contener esa cadena en ellos.

Descarga de registros aio-cli-download-logs

La CLI de Adobe I/O AEM proporciona la capacidad de descargar registros de los registros as a Cloud Service mediante el uso de la función de descarga de registros de. download-logs), comando. Esto proporciona el mismo resultado final que descargar los registros de la interfaz de usuario web de Cloud Manager, con la diferencia de que download-logs El comando consolida los registros a lo largo de los días, en función de cuántos días se soliciten.

$ aio config:set cloudmanager_programid <PROGRAM ID>
$ aio cloudmanager:download-logs <ENVIRONMENT> <SERVICE> <NAME> <DAYS>

Explicación de registros

AEM Los inicios de sesión as a Cloud Service tienen varios pods que escriben instrucciones de registro en ellos. AEM Dado que varias instancias de escriben en el mismo archivo de registro, es importante comprender cómo analizar y reducir el ruido durante la depuración. Para explicar, lo siguiente aemerror se utiliza un fragmento de registro:

01.01.2020 12:00:00.000 [cm-p12345-e56789-aem-author-abcdefg-1111] *DEBUG* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Preparing to collect resources
01.01.2020 12:00:01.002 [cm-p12345-e56789-aem-author-abcdefg-2222] *WARN*  [qtp40782847611-87] com.example.services.impl.ExampleServiceImpl Unable to resolve resource [ /content/example ] to a resource. Aborting.
01.01.2020 12:00:02.003 [cm-p12345-e56789-aem-author-abcdefg-1111] *ERROR* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Unable to collect any resources

AEM Mediante los ID de secuencia, el punto de datos después de la fecha y la hora, los registros se pueden recopilar mediante Pod o la instancia de dentro del servicio, lo que facilita el seguimiento y la comprensión de la ejecución del código.

Pod cm-p12345-e56789-aem-author-abcdefg-1111

01.01.2020 12:00:00.000 [cm-p12345-e56789-aem-author-abcdefg-1111] *DEBUG* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Preparing to collect resources
01.01.2020 12:00:02.003 [cm-p12345-e56789-aem-author-abcdefg-1111] *ERROR* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Unable to collect any resources

Pod cm-p12345-e56789-aem-author-abcdefg-2222

01.01.2020 12:00:01.002 [cm-p12345-e56789-aem-author-abcdefg-2222] *WARN*  [qtp2078364989-269] com.example.services.impl.ExampleServiceImpl Unable to resolve resource [ /content/example ] to a resource. Aborting.

Niveles de registro recomendados log-levels

Las directrices generales del Adobe AEM sobre los niveles de registro según el entorno as a Cloud Service de la son las siguientes:

La configuración del nivel de registro más adecuado para cada tipo de entorno se realiza con la configuración as a Cloud Service, los niveles de registro se mantienen en el código, lo que hace que los valores de registro sean los más AEM

…y por lo tanto, requieren una implementación para cambiar.

Variables específicas del entorno para establecer los niveles de registro de Java

AEM Una alternativa a establecer niveles de registro de Java bien conocidos y estáticos para cada entorno es usar la opción de los Cloud Service como de la aplicación de la aplicación de la manera más sencilla. variables específicas del entorno para parametrizar los niveles de registro, permitiendo que los valores se cambien dinámicamente mediante el CLI de Adobe I/O con complemento de Cloud Manager.

Esto requiere actualizar las configuraciones de registro de OSGi para utilizar los marcadores de posición de variables específicos del entorno. Valores predeterminados para los niveles de registro deben establecerse de acuerdo con Adobe de recomendaciones. Por ejemplo:

/apps/example/config/org.apache.sling.commons.log.LogManager.factory.config~example.cfg.json

{
    ...
    "org.apache.sling.commons.log.names": ["com.example"],
    "org.apache.sling.commons.log.level": "$[env:LOG_LEVEL;default=DEBUG]"
    ...
}

Este enfoque tiene desventajas que deben tenerse en cuenta:

Las variables específicas del entorno no funcionan para las configuraciones de registro del servidor web Apache o Dispatcher, ya que no se configuran mediante la configuración OSGi.