Depuración AEM SDK mediante registros

Al acceder a los registros del SDK de AEM, tanto el SDK local de AEM de inicio rápido Jar como las herramientas de Dispatcher pueden proporcionar perspectivas clave sobre la depuración de las aplicaciones de AEM.

Registros de AEM

Los registros actúan como primera línea para depurar aplicaciones AEM, pero dependen del registro adecuado en la aplicación de AEM implementada. Adobe recomienda mantener el desarrollo local y las configuraciones de registro de AEM como Cloud Service Dev lo más parecido posible, ya que normaliza la visibilidad de registro en los entornos locales de inicio rápido y AEM como Cloud Service de desarrollo del SDK, lo que reduce la manipulación de la configuración y la reimplementación.

El AEM tipo de archivo del proyecto configura el registro en el nivel de depuración para los paquetes Java de la aplicación de AEM para el desarrollo local a través de la configuración OSGi de Sling Logger que se encuentra en

ui.apps/src/main/content/jcr_root/apps/example/config/org.apache.sling.commons.log.LogManager.factory.config-example.cfg.json

que inicia sesión en error.log.

Si el registro predeterminado no es suficiente para el desarrollo local, el registro ad hoc se puede configurar a través de la consola web local de soporte de registro de inicio rápido del SDK, en (/system/console/slinglog), pero no se recomiendan cambios ad hoc que se mantengan en Git a menos que también se necesiten estas mismas configuraciones de registro en AEM como entornos de desarrollo de Cloud Service. Tenga en cuenta que los cambios realizados a través de la consola de soporte de registro se mantienen directamente en el repositorio local de inicio rápido del SDK AEM.

Las instrucciones de registro de Java se pueden ver en el archivo error.log:

$ ~/aem-sdk/author/crx-quickstart/logs/error.log

A menudo es útil "seguir" el error.log que transmite su salida al terminal.

Registros de Dispatcher

Los registros de Dispatcher se emiten para stdout cuando se invoca bin/docker_run, pero se puede acceder directamente a los registros en el contenedor de Docker.

Acceso a los registros en el contenedor Docker

Los registros de Dispatcher pueden acceder directamente al contenedor Docker en /etc/httpd/logs.

$ docker ps

# locate the CONTAINER ID associated with "adobe/aem-ethos/dispatcher-publisher" IMAGE
CONTAINER ID        IMAGE                                       COMMAND                  CREATED             STATUS              PORTS                  NAMES
46127c9d7081        adobe/aem-ethos/dispatcher-publish:2.0.23   "/docker_entrypoint.…"   6 seconds ago       Up 5 seconds        0.0.0.0:8080->80/tcp   wonderful_merkle

$ docker exec -it <CONTAINER ID> /bin/sh

/ #
/ # cd /etc/httpd/logs
/ # ls
    dispatcher.log          healthcheck_access_log  httpd_access.log        httpd_error.log

# When finished viewing the logs files, exit the Docker container's shell
/# exit

El <CONTAINER ID> en docker exec -it <CONTAINER ID> /bin/sh debe reemplazarse por el ID del CONTENEDOR del Docker de destino que aparece en el docker ps comando.

Copia de los registros de Docker al sistema de archivos local

Los registros de Dispatcher se pueden copiar desde el contenedor Docker en /etc/httpd/logs al sistema de archivos local para su inspección usando su herramienta favorita de análisis de registros. Tenga en cuenta que se trata de una copia puntual y no proporciona actualizaciones en tiempo real de los registros.

$ docker ps

# locate the CONTAINER ID associated with "adobe/aem-ethos/dispatcher-publisher" IMAGE
CONTAINER ID        IMAGE                                       COMMAND                  CREATED             STATUS              PORTS                  NAMES
46127c9d7081        adobe/aem-ethos/dispatcher-publish:2.0.23   "/docker_entrypoint.…"   6 seconds ago       Up 5 seconds        0.0.0.0:8080->80/tcp   wonderful_merkle

$ docker cp -L <CONTAINER ID>:/etc/httpd/logs logs
$ cd logs
$ ls
    dispatcher.log          healthcheck_access_log  httpd_access.log        httpd_error.log

El <CONTAINER_ID> en docker cp <CONTAINER_ID>:/var/log/apache2 ./ debe reemplazarse por el ID del CONTENEDOR del Docker de destino que aparece en el docker ps comando.

En esta página