Supervisión y mantenimiento de la instancia de AEM

Una vez que las instancias de AEM se hayan implementado, se necesitarán ciertas tareas para supervisar y mantener su funcionamiento, rendimiento e integridad.

Un factor clave aquí es que para reconocer los problemas potenciales necesita saber cómo se ven y comportan sus sistemas en condiciones normales. Para ello, es mejor supervisar el sistema y recopilar información durante un período de tiempo.

Comprobar	Consideraciones	Comentario / Acciones
Plan de copia de seguridad.		Consulte cómo Hacer una copia de seguridad de la instancia.
Plan de recuperación ante desastres.	Directrices de recuperación ante desastres de su empresa.
Hay disponible un sistema de seguimiento de errores para informar de los problemas.	Por ejemplo, bugzilla, jira o uno de muchos otros.
Se están supervisando los sistemas de archivos.	El repositorio CRX se "congelará" si no hay suficiente espacio libre en disco. Se reanudará una vez que haya espacio disponible.	Los mensajes " *ERROR* LowDiskSpaceBlocker" se pueden ver en el archivo de registro cuando el espacio libre es bajo.
Los archivos de registro se están monitorizando.
La supervisión del sistema se está ejecutando (constantemente) en segundo plano.	Incluido el uso de CPU, memoria, disco y red. Usando, por ejemplo, iostat / vmstat / perfmon.	Los datos registrados se visualizan y se pueden utilizar para rastrear problemas de rendimiento. También se puede acceder a los datos sin procesar.
AEM rendimiento se está supervisando.	Inclusión de Contadores de solicitudes para supervisar los niveles de tráfico.	Si se observa una pérdida significativa, o a largo plazo, del rendimiento, debe realizarse una investigación detallada.
Está monitorizando sus agentes de replicación.
Purgue con regularidad las instancias de flujo de trabajo.	Tamaño del repositorio y rendimiento del flujo de trabajo.	Consulte Depuración regular de instancias de flujo de trabajo.

Copias de seguridad

Se recomienda realizar copias de seguridad de:

• Su instalación de software: antes o después de cambios significativos en la configuración
• El contenido retenido dentro del repositorio: regularmente

Su empresa probablemente tendrá una política de backup que deberá seguir, consideraciones adicionales sobre qué hacer una copia de seguridad y cuándo incluirlas:

• la importancia crítica del sistema y los datos.
• la frecuencia con la que se realizan cambios en el software o los datos.
• volumen de datos; ocasionalmente puede ser un problema, al igual que el tiempo necesario para realizar la copia de seguridad.
• si la copia de seguridad se puede realizar mientras los usuarios están en línea; y, si es posible, cuál es el impacto en el rendimiento.
• la distribución geográfica de los usuarios; es decir, ¿cuándo es el mejor momento para realizar backup (para minimizar el impacto)?
• su política de recuperación ante desastres; existen directrices sobre dónde se deben almacenar los datos de copia de seguridad (por ejemplo, fuera del sitio, medio específico, etc.).

A menudo se realiza una copia de seguridad completa a intervalos regulares (por ejemplo, a diario, semanal o mensual), con backups incrementales intermedios (por ejemplo, por hora, diariamente o semanalmente).

Copia de seguridad de la instalación del software

Después de la instalación, o cambios significativos en la configuración, realice una copia de seguridad de la instalación del software.

Para ello, debe realizar una copia de seguridad de todo el repositorio y:

1. Paren AEM.
2. Haga una copia de seguridad de todo el <cq-installation-dir> desde el sistema de archivos.

Copia de seguridad del repositorio

La sección Backup and Restore de la documentación de CRX cubre todos los problemas relacionados con las copias de seguridad del repositorio CRX.

Para obtener más información sobre cómo hacer una copia de seguridad "en caliente" en línea, consulte Creación de una copia de seguridad en línea.

Depuración de versiones

La herramienta Purge Versions está diseñada para depurar las versiones de un nodo o una jerarquía de nodos en el repositorio. Su principal propósito es ayudarle a reducir el tamaño de su repositorio eliminando versiones antiguas de sus nodos.

Esta sección trata de las operaciones de mantenimiento relacionadas con la función de versiones de AEM. La herramienta Purge Version está diseñada para depurar las versiones de un nodo o una jerarquía de nodos en el repositorio. Su principal propósito es ayudarle a reducir el tamaño de su repositorio eliminando versiones antiguas de sus nodos.

Información general

La herramienta Purge Versions está disponible en la consola Tools en Versioning o directamente en:

https://<server>:<port>/etc/versioning/purge.html

Iniciar rutaUna ruta absoluta en la que se debe realizar la depuración. Para seleccionar la Ruta de inicio, haga clic en el navegador de árbol del repositorio.

​​RecursiveAl depurar datos, puede elegir entre realizar la operación en un nodo o en una jerarquía completa seleccionando Recursivo. En el último caso, la ruta dada define el nodo raíz de la jerarquía.

Máximo de versiones para mantenerEl número máximo de versiones que se guardarán para un nodo. Cuando este número supera este valor, se depuran las versiones más antiguas.

Edad máxima de la versión La edad máxima de la versión de un nodo. Cuando la antigüedad de una versión supera este valor, se depura.

Ensayo Debido a que la eliminación de versiones de su contenido es definida y no se puede revertir sin restaurar una copia de seguridad, la herramienta Purge Versions proporciona un modo de ejecución en seco que le permite obtener una vista previa de las versiones depuradas. Para iniciar una ejecución en seco del proceso de depuración, haga clic en Ensayo.

​​PurgeInicie la depuración de las versiones en el nodo definido por la ruta de inicio.

Depuración de versiones de un sitio web

Para purgar versiones de un sitio web, siga este procedimiento:

1. Vaya a la Tools console, seleccione Versioning y haga doble clic en Purge Versions.

2. Establezca la ruta de inicio del contenido que desea depurar (p. ej. /content/geometrixx-outdoors).

   • Si solo desea purgar el nodo definido por la ruta, anule la selección de Recursive.
   • Si desea purgar el nodo definido por la ruta y sus descendientes, seleccione Recursive.

3. Establezca el número máximo de versiones (para cada nodo) que desea mantener. Deje vacío para no utilizar esta configuración.

4. Establezca la página de versión máxima en días (para cada nodo) que desee mantener. Deje vacío para no utilizar esta configuración.

5. Haga clic en Ensayo para obtener una vista previa de lo que haría el proceso de depuración.

6. Haga clic en Purge para iniciar el proceso.

Análisis de la consola

Los procesos Dry Run y Purge enumeran todos los nodos que se han procesado. Durante el proceso, un nodo puede tener uno de los siguientes estados:

• ignore (not versionnable): el nodo no admite versiones y se ignora durante el proceso.

• ignore (no version): el nodo no tiene ninguna versión y se ignora durante el proceso.

• retained: el nodo no se depura.

• purged: el nodo se depura.

Además, la consola proporciona información útil sobre las versiones:

• V 1.0: el número de versión.

• V 1.0.1*: la estrella indica que la versión es la actual.

• Thu Mar 15 2012 08:37:32 GMT+0100: la fecha de la versión.

En el siguiente ejemplo:

• Las versiones de Shirts se depuran porque su edad de versión es buena a 2 días.
• Las versiones Tonga Fashions! se depuran porque su número de versiones es bueno a 5.

Uso de registros de auditoría y archivos de registro

La auditoría de registros y archivos de registro relacionados con Adobe Experience Manager (AEM) se puede encontrar en varias ubicaciones. A continuación se proporciona una descripción general de lo que puede encontrar donde.

Uso de registros

AEM WCM registra registros detallados. Después de desempaquetar e iniciar QuickStart, puede encontrar los registros en:

• <cq-installation-dir>/crx-quickstart/logs/

• <cq-installation-dir>/crx-quickstart/repository/

Rotación de archivos de registro

La rotación del archivo de registro se refiere al proceso que limita el crecimiento del archivo al crear un nuevo archivo periódicamente. En AEM, un archivo de registro llamado error.log se girará una vez al día según las reglas dadas:

• Se cambia el nombre del archivo error.log según el patrón {original_filename} .yyyy-MM-dd. Por ejemplo, el 11 de julio de 2010, el nombre del archivo de registro actual cambia a error.log-2010-07-10 y, a continuación, se crea un nuevo error.og.

• Los archivos de registro anteriores no se eliminan, por lo que es su responsabilidad limpiar los archivos de registro antiguos periódicamente para limitar el uso del disco.

Búsqueda de los archivos de registro

En el servidor de archivos donde instaló AEM se guardan varios archivos de registro:

• <cq-installation-dir>/crx-quickstart/logs

  • access.log
    Todas las solicitudes de acceso a AEM WCM y al repositorio se registran aquí.

  • audit.log
    Las acciones de moderación se registran aquí.

  • error.log
    Los mensajes de error (de diversos niveles de gravedad) se registran aquí.

  • ImageServer-<PortId>-yyyy>-<mm>-<dd>.log
    Este registro solo se utiliza si Dynamic Media está habilitado. Proporciona estadísticas e información analítica utilizada para analizar el comportamiento del proceso interno de ImageServer.

  • request.log
    Cada solicitud de acceso se registra aquí junto con la respuesta.

  • s7access-<yyyy>-<mm>-<dd>.log
    Este registro solo se utiliza si Dynamic Media está habilitado. El registro s7access registra cada solicitud realizada a Dynamic Media a /is/image y /is/content.

  • stderr.log
    Contiene mensajes de error, también de diversos niveles de gravedad, generados durante el inicio. De forma predeterminada, el nivel de registro está establecido en
    Warning ( WARN)

  • stdout.log
    Contiene mensajes de registro que indican eventos durante el inicio.

  • upgrade.log
    Proporciona un registro de todas las operaciones de actualización que se ejecutan desde el
    com.day.compat.codeupgrade y com.adobe.cq.upgradesexecutor paquetes.

• <cq-installation-dir>/crx-quickstart/repository

  • revision.log
    Revisión de la información de diario.

Activación del nivel de registro de depuración

El nivel de registro predeterminado (Configuración de registro de Apache Sling) es Información, por lo que los mensajes de depuración no se registran.

Para activar el nivel de registro de depuración para un Registrador, establezca la propiedad org.apache.sling.commons.log.level para depurar en el repositorio. Por ejemplo, en /libs/sling/config/org.apache.sling.commons.log.LogManager para configurar el registro global de Apache Sling.

Una línea en el archivo de depuración normalmente comienza con DEBUG y, a continuación, proporciona el nivel de registro, la acción del instalador y el mensaje de registro. Por ejemplo:

DEBUG 3 WebApp Panel: WebApp successfully deployed

Los niveles de registro son los siguientes:

0	Error grave	La acción ha fallado y el instalador no puede continuar.
1	Error	La acción ha fallado. La instalación continúa, pero una parte de AEM WCM no se instaló correctamente y no funcionará.
2	Advertencia	La acción se ha realizado correctamente, pero se han encontrado problemas. AEM WCM puede o no funcionar correctamente.
3	Información	La acción se ha realizado correctamente.

Crear un archivo de registro personalizado

En determinadas circunstancias, es posible que desee crear un archivo de registro personalizado con un nivel de registro diferente. Puede hacerlo en el repositorio:

1. Si aún no existe, cree una nueva carpeta de configuración ( sling:Folder) para su proyecto /apps/<project-name>/config.

2. En /apps/<project-name>/config, cree un nodo para la nueva Configuración del registrador de registros de Apache Sling:

   • Nombre: org.apache.sling.commons.log.LogManager.factory.config-<identifier> (ya que es un registrador)

     Donde <identifier> se reemplaza por texto libre que debe introducir para identificar la instancia (no puede omitir esta información).

     Por ejemplo, org.apache.sling.commons.log.LogManager.factory.config-MINE

   • Tipo: sling:OsgiConfig

   NOTA

   Aunque no es un requisito técnico, es aconsejable hacer <identifier> único.

3. Establezca las siguientes propiedades en este nodo:

   • Nombre: org.apache.sling.commons.log.file

     Tipo: Cadena

     Valor: especificar el archivo de registro; por ejemplo, logs/myLogFile.log

   • Nombre: org.apache.sling.commons.log.names

     Tipo: String[] (String + Multi)

     Valor: especificar los servicios OSGi para los que el registrador debe registrar mensajes; por ejemplo, todos los siguientes:

     • org.apache.sling
     • org.apache.felix
     • com.day

   • Nombre: org.apache.sling.commons.log.level

     Tipo: Cadena

     Valor: especificar el nivel de registro requerido ( debug, info, warn o error); por ejemplo debug

   • Configure los demás parámetros según sea necesario:

     • Nombre: org.apache.sling.commons.log.pattern

       Tipo: String

       Valor: especifique el patrón del mensaje de registro según sea necesario; por ejemplo,

       {0,date,dd.MM.yyyy HH:mm:ss.SSS} *{4}* [{2}] {3} {5}

   NOTA

   org.apache.sling.commons.log.pattern admite hasta seis argumentos.

   Marca de tiempo de tipo java.util.Date

   {1} el marcador de registro

   {2} nombre del subproceso actual

   {3} nombre del registrador

   {4} el nivel de registro

   {5} el mensaje de registro

   Si la llamada de registro incluye un Throwable, el seguimiento de pila se anexa al mensaje.

   PRECAUCIÓN

   org.apache.sling.commons.log.names debe tener un valor.

   NOTA

   Las rutas de escritura de registros son relativas a la ubicación crx-quickstart.

   Por lo tanto, un archivo de registro especificado como:

   logs/thelog.log

   escribe para:

   <cq-installation-dir>/crx-quickstart/logs/thelog.log.

   Y un archivo de registro especificado como:

   ../logs/thelog.log

   escribe en un directorio:

   <cq-installation-dir>/logs/
   (es decir, junto a <cq-installation-dir>/crx-quickstart/)

4. Este paso solo es necesario cuando se requiere un nuevo Writer (es decir, con una configuración diferente a la predeterminada Writer).

   PRECAUCIÓN

   Solo se requiere una nueva configuración del Escritor de registro cuando el valor predeterminado existente no es adecuado.

   Si no hay ningún Writer explícito configurado, el sistema generará automáticamente un Writer implícito basado en el valor predeterminado.

   En /apps/<project-name>/config, cree un nodo para la nueva Configuración del escritor de registro de Apache Sling:

   • Nombre: org.apache.sling.commons.log.LogManager.factory.writer-<identifier> (ya que es un escritor)

     Al igual que con el registrador, <identifier> se sustituye por texto libre que debe introducir para identificar la instancia (no puede omitir esta información). Por ejemplo, org.apache.sling.commons.log.LogManager.factory.writer-MINE

   • Tipo: sling:OsgiConfig

   NOTA

   Aunque no es un requisito técnico, es aconsejable hacer <identifier> único.

   Establezca las siguientes propiedades en este nodo:

   • Nombre: org.apache.sling.commons.log.file

     Tipo: String

     Valor: especifique el archivo de registro para que coincida con el archivo especificado en el registrador;

     para este ejemplo, ../logs/myLogFile.log.

   • Configure los demás parámetros según sea necesario:

     • Nombre: org.apache.sling.commons.log.file.number

       Tipo: Long

       Valor: especifique el número de archivos de registro que desea conservar; por ejemplo, 5

     • Nombre: org.apache.sling.commons.log.file.size

       Tipo: String

       Valor: especificar como sea necesario para controlar la rotación de archivos por tamaño/fecha; por ejemplo, '.'yyyy-MM-dd

   NOTA

   org.apache.sling.commons.log.file.size controla la rotación del archivo de registro estableciendo:

   • un tamaño máximo de archivo
   • un calendario de fecha y hora

   para indicar cuándo se creará un nuevo archivo (y se cambiará el nombre del archivo existente según el patrón de nombre).

   • Se puede especificar un límite de tamaño con un número. Si no se proporciona ningún indicador de tamaño, entonces esto se toma como el número de bytes, o puede agregar uno de los indicadores de tamaño - KB, MB o GB (se omiten las mayúsculas y minúsculas).
   • Una programación de fecha y hora se puede especificar como un patrón java.util.SimpleDateFormat. Esto define el período de tiempo después del cual se girará el archivo; también el sufijo anexado al archivo rotado (para identificación).

   El valor predeterminado es '.'aaaa-MM-dd (para la rotación diaria del registro).

   Por ejemplo, a la medianoche del 20 de enero de 2010 (o cuando el primer mensaje de registro después de esto sea preciso), se cambiará el nombre de …/logs/error.log a …/logs/error.log.2010-01-20. El inicio de sesión del 21 de enero se enviará a (nuevo y vacío) …/logs/error.log hasta que se anule en el siguiente cambio de día.

   '.'yyyy-MM	Rotación al comienzo de cada mes
   '.'yyyy-ww	Rotación en el primer día de cada semana (depende de la configuración regional).
   '.'yyyy-MM-dd	Rotación a medianoche cada día.
   '.'yyyy-MM-dd-a	Rotación a medianoche y mediodía de cada día.
   '.'yyyy-MM-dd-HH	Rotación en la parte superior de cada hora.
   '.'yyyy-MM-dd-HH-mm	Rotación al principio de cada minuto.

   Nota: Al especificar una hora/fecha:

   1. Debería "escapar" el texto literal dentro de un par de comillas simples (' ');

      esto sirve para evitar que ciertos caracteres se interpreten como letras de patrón.

   2. Utilice únicamente caracteres permitidos para un nombre de archivo válido en cualquier parte de la opción.

5. Lea el nuevo archivo de registro con la herramienta seleccionada.

   El archivo de registro creado por este ejemplo será ../crx-quickstart/logs/myLogFile.log.

La Consola Felix también proporciona información sobre la compatibilidad con el registro Sling en ../system/console/slinglog; por ejemplo https://localhost:4502/system/console/slinglog.

Búsqueda de registros de auditoría

Los registros de auditoría se mantienen para proporcionar un registro de quién hizo qué y cuándo. Se generan diferentes registros de auditoría tanto para AEM eventos WCM como OSGi.

AEM registros de auditoría de WCM que se muestran al crear páginas

1. Abra una página.

2. Desde la barra de tareas puede seleccionar la ficha con el icono de bloqueo y luego hacer doble clic en Registro de auditoría…

3. Se abrirá una nueva ventana que muestra la lista de registros de auditoría de la página actual.

   

4. Haga clic en OK cuando desee cerrar la ventana.

AEM WCM Auditing records dentro del repositorio

Dentro de la carpeta /var/audit , los registros de auditoría se mantienen según el recurso. Puede explorar en profundidad hasta que vea los registros individuales y la información que contienen.

Estas entradas contienen la misma información que se muestra al editar una página.

Registros de auditoría de OSGi de la consola web

Los eventos OSGi también generan registros de auditoría que se pueden ver desde la pestaña Configuration Status -> Log Files en la consola web de AEM:

Monitorización de los agentes de replicación

Puede monitorizar las colas de replicación para detectar cuándo una cola está bloqueada o bloqueada, lo que a su vez podría indicar un problema con una instancia de publicación o un sistema externo:

• ¿todas las colas necesarias están habilitadas?

• ¿siguen siendo necesarias colas desactivadas?

• todas las colas enabled deben tener el estado idle o active, que indica el funcionamiento normal; ninguna cola debe ser blocked, lo que a menudo es un signo de problemas en el lado de los receptores.

• si el tamaño de la cola crece con el tiempo, esto puede indicar una cola bloqueada.

Para monitorizar un agente de replicación:

1. Acceda a la pestaña Tools en AEM.

2. Haga clic en Replicación.

3. Haga doble clic en el vínculo a los agentes para el entorno adecuado (panel izquierdo o derecho); por ejemplo Agentes en author.

   La ventana resultante muestra una visión general de todos sus agentes de replicación para el entorno de creación, incluidos su destino y estado.

4. Haga clic en el nombre de agente apropiado (que es un vínculo) para mostrar información detallada sobre ese agente:

   

   Aquí puede hacer lo siguiente:

   • Compruebe si el agente está habilitado.

   • Consulte el destino de cualquier replicación.

   • Compruebe si la cola de replicación está activa (habilitada) actualmente.

   • Compruebe si hay algún elemento en la cola.

   • ​​Actualizar o ​​Borrar para actualizar la visualización de las entradas de la cola; esto le ayuda a ver los elementos que entran y salen de la cola.

   • Consulte Logs para acceder al registro de cualquier acción del agente de replicación.

   • Probar conexión con la instancia de destino.

   • Forzar Reintento en cualquier elemento de cola si es necesario.

   PRECAUCIÓN

   No utilice el vínculo "Probar conexión" para el buzón de salida de replicación inversa en una instancia de publicación.

   Si se realiza una prueba de replicación para una cola de Outbox, todos los elementos que sean más antiguos que la replicación de prueba se reprocesarán con cada replicación inversa.

   Si estos elementos ya existen en una cola, se pueden encontrar con la siguiente consulta XPath JCR y se deben eliminar.

   /jcr:root/var/replication/outbox//*[@cq:repActionType='TEST']

Una vez más, puede desarrollar una solución para detectar todos los agentes de replicación (ubicados en /etc/replication/author o /etc/replication/publish) y luego comprobar el estado del agente ( enabled, disabled) y la cola subyacente ( active, idle, blocked).

Monitorización del rendimiento

La optimización del rendimiento es un proceso interactivo que recibe atención durante el desarrollo. Después de la implementación, suele revisarse después de intervalos o eventos específicos.

Los métodos utilizados al recopilar información para la optimización también se pueden utilizar para la monitorización continua.

A continuación se enumeran los problemas comunes de rendimiento que se producen, junto con propuestas sobre cómo detectarlos y contrarrestarlos.

Área	Síntoma(s)	Para aumentar la capacidad…	Para reducir el volumen…
Cliente	Alto uso de CPU del cliente.	Instale una CPU cliente con mayor rendimiento.	Simplificar el diseño (HTML).
	Bajo uso de CPU del servidor.	Actualice a un explorador más rápido.	Mejore la caché del lado del cliente.
	Algunos clientes son rápidos, algunos lentos.
Servidor
Red	El uso de CPU es bajo tanto en servidores como en clientes.	Elimine los cuellos de botella de la red.	Mejore/optimice la configuración de la caché del cliente.
	La navegación local en el servidor es (comparativamente) rápida.	Aumente el ancho de banda de la red.	Reduzca el "peso" de las páginas web (p. ej., menos imágenes, HTML optimizado).
Servidor web	El uso de CPU en el servidor web es alto.	Agrupe los servidores web.	Reduzca las visitas individuales por página (visita).
		Utilice un equilibrador de carga de hardware.
Aplicación	El uso de CPU del servidor es alto.	Agrupe las instancias de AEM.	Busque y elimine bloques de CPU y memoria (utilice revisión de código, salida de temporización, etc.).
	Alto consumo de memoria.		Mejore el almacenamiento en caché en todos los niveles.
	Tiempos de respuesta bajos.		Optimizar plantillas y componentes (por ejemplo, estructura, lógica).
Repositorio
Caché

Los problemas de rendimiento pueden deberse a una serie de causas que no tienen nada que ver con su sitio web, incluidas las desaceleraciones temporales en la velocidad de conexión, la carga de la CPU y muchas más.

También puede afectar a todos los visitantes o solo a un subconjunto de ellos.

Toda esta información debe obtenerse, ordenarse y analizarse antes de poder optimizar el rendimiento general o resolver problemas específicos.

• Antes de experimentar un problema de rendimiento:

  • recopilar la mayor cantidad de información posible para desarrollar un buen conocimiento del sistema en circunstancias normales

• Cuando experimenta un problema de rendimiento:

  • intente replicarlo con uno (o preferiblemente más) exploradores web estándar, en un cliente diferente que sepa que tiene un buen rendimiento general o en el propio servidor (si es posible)

  • compruebe si algo (relacionado con el sistema) ha cambiado en un espacio de tiempo adecuado y si alguno de estos cambios podría haber afectado al rendimiento

  • haga preguntas como:

    • ¿el problema solo ocurre en momentos específicos?
    • ¿el problema solo ocurre en páginas específicas?
    • ¿se ven afectadas otras solicitudes?

  • recopilar la mayor cantidad de información posible para compararla con su conocimiento del sistema en circunstancias normales:

Herramientas para monitorizar y analizar el rendimiento

A continuación se ofrece una breve descripción general de algunas de las herramientas disponibles para monitorizar y analizar el rendimiento.

Algunos de ellos dependerán del sistema operativo.

Herramienta	Se utiliza para analizar...	Uso / Más información...
request.log	Tiempos de respuesta y concurrencia.	Interpretación del archivo request.log.
truss/strace	Cargas de página	Unix/Linux comandos para rastrear llamadas y señales del sistema. Aumente el nivel de registro a INFO. Analice la cantidad de cargas de página por solicitud, qué páginas, etc.
Volcados de subprocesos	Observe los subprocesos de JVM. Identificar contenciones, bloqueos y corredores de larga duración.	Dependiente del sistema operativo: - Unix/Linux: kill -QUIT <pid> - Windows (modo de consola): Ctrl-Salto También hay herramientas de análisis disponibles, como TDA.
Volcados de montículos	Problemas de falta de memoria que causan un rendimiento lento.	Agregue la opción: -XX:+HeapDumpOnOutOfMemoryError a la llamada de java a AEM. Consulte la Guía de solución de problemas para Java SE 6 con HotSpot VM.
Llamadas del sistema	Identificar problemas de temporización.	Las llamadas a System.currentTimeMillis() o com.day.util.El tiempo se utiliza para generar marcas de tiempo a partir del código o mediante HTML-comments. Nota: Deben implementarse para que se puedan activar o desactivar según sea necesario; cuando un sistema se ejecuta sin problemas, no será necesario el coste de recopilar estadísticas.
Apache Bench	Identifique fugas de memoria, analice selectivamente el tiempo de respuesta.	el uso básico es: ab -k -n <requests> -c <concurrency> <url> Consulte Apache Bench y la página de comando man para obtener más información.
Análisis de búsqueda		Ejecute consultas de búsqueda sin conexión, identifique el tiempo de respuesta de la consulta, pruebe y confirme el conjunto de resultados.
JMeter	Pruebas funcionales y de carga.	https://jakarta.apache.org/jmeter/
JProfiler	Profundización detallada de la CPU y la memoria.	https://www.ej-technologies.com/
JConsole	Observe las métricas y los subprocesos de JVM.	Uso: jconsole Consulte consola y Monitorización del rendimiento con JConsole. Nota: Con JDK 1.6, JConsole se puede ampliar con complementos; por ejemplo, Top o TDA (Analizador de volcado de subprocesos).
Java VisualVM	Observe las métricas de JVM, los subprocesos, la memoria y la creación de perfiles.	Uso: jvisualvm o visualvm Consulte jvisualvm, visualvm y Monitorización del rendimiento mediante (J)VisualVM. Nota: Con JDK 1.6, VisualVM se puede ampliar con complementos.
truss/strace, lsof	Análisis profundo de procesos y llamadas al núcleo (Unix).	Comandos Unix/Linux.
Estadísticas de temporización	Consulte estadísticas de temporización para el procesamiento de páginas.	Para ver las estadísticas de temporización de la renderización de páginas, puede utilizar Ctrl-Mayús-U junto con ?debugClientLibs=true configurado en la dirección URL.
Herramienta de creación de perfiles de CPU y memoria	Se utiliza al analizar solicitudes lentas durante el desarrollo.	Por ejemplo, YourKit.
Recopilación de información	El estado en curso de la instalación.	Conocer en la medida de lo posible sobre la instalación también puede ayudarle a rastrear qué puede haber causado un cambio en el rendimiento y si estos cambios están justificados. Estas métricas deben recopilarse a intervalos regulares para poder ver fácilmente los cambios más importantes.

Interpretación del archivo request.log

Este archivo registra información básica sobre cada solicitud realizada a AEM. De estas valiosas conclusiones se pueden extraer.

El request.log ofrece una forma integrada de obtener una visión del tiempo que tardan las solicitudes. Para fines de desarrollo, es útil tail -f el request.log y observar los tiempos de respuesta lentos. Para analizar un request.log más grande recomendamos el uso de rlog.jar que permite ordenar y filtrar por tiempos de respuesta.

Recomendamos aislar las páginas "lentas" del request.log y luego ajustarlas individualmente para lograr un mejor rendimiento. Esto se suele hacer incluyendo métricas de rendimiento por componente o utilizando una herramienta de perfil de rendimiento como [yourkit](https://www.yourkit.com/).

Monitorización del tráfico en el sitio web

El registro de solicitudes registra cada solicitud realizada, junto con la respuesta realizada:

09:43:41 [66] -> GET /author/y.html HTTP/1.1
09:43:41 [66] <- 200 text/html 797ms

Al totalizar todas las entradas de GET dentro de un periodo específico (por ejemplo, en varios períodos de 24 horas), puede realizar declaraciones sobre el tráfico promedio en su sitio web.

Monitorización de los tiempos de respuesta con request.log

Un buen punto de partida para el análisis de rendimiento es el registro de solicitudes:

<cq-installation-dir>/crx-quickstart/logs/request.log

El registro tiene el siguiente aspecto (las líneas se abrevian por simplicidad):

31/Mar/2009:11:32:57 +0200 [379] -> GET /path/x HTTP/1.1
31/Mar/2009:11:32:57 +0200 [379] <- 200 text/html 33ms
31/Mar/2009:11:33:17 +0200 [380] -> GET /path/y HTTP/1.1
31/Mar/2009:11:33:17 +0200 [380] <- 200 application/json 39ms

Este registro tiene una línea por solicitud o respuesta:

• Fecha en la que se realizó cada solicitud o respuesta.

• Número de la solicitud, entre corchetes. Este número coincide con la solicitud y la respuesta.

• Una flecha que indica si se trata de una solicitud (flecha que señala a la derecha) o una respuesta (flecha a la izquierda).

• Para las solicitudes, la línea contiene:

  • el método (normalmente, GET, HEAD o POST)
  • la página solicitada
  • el protocolo

• Para las respuestas, la línea contiene:

  • el código de estado (200 significa "éxito", 404 significa "página no encontrada"
  • el tipo MIME
  • el tiempo de respuesta

Con secuencias de comandos pequeñas, puede extraer la información necesaria del archivo de registro y ensamblar las estadísticas que desee. A partir de estos datos, puede ver qué páginas o tipos de páginas son lentos y si el rendimiento general es satisfactorio.

Monitorización de los tiempos de respuesta de búsqueda con request.log

Las solicitudes de búsqueda también se registran en el archivo de registro:

31/Mar/2009:11:35:34 +0200 [338] -> GET /author/playground/en/tools/search.html?query=dilbert&size=5&dispenc=utf-8 HTTP/1.1
31/Mar/2009:11:35:34 +0200 [338] <- 200 text/html 1562ms

Por lo tanto, como se ha indicado anteriormente, puede utilizar secuencias de comandos para extraer la información relevante y crear estadísticas.

Sin embargo, una vez que haya determinado el tiempo de respuesta, es posible que tenga que analizar por qué la solicitud está tardando su tiempo y qué se puede hacer para mejorar la respuesta.

Monitorización del número y el impacto de usuarios simultáneos

Una vez más, el request.log puede utilizarse para controlar la concurrencia y la reacción del sistema ante ella.

Se deben realizar pruebas para determinar cuántos usuarios simultáneos puede gestionar el sistema antes de que se vea un impacto negativo. De nuevo, se pueden utilizar secuencias de comandos para extraer resultados del archivo de registro:

• supervisar cuántas solicitudes se realizan dentro de un lapso de tiempo específico, por ejemplo, un minuto
• ensayar los efectos de un número específico de usuarios que realizan las mismas solicitudes (lo más cerca posible) al mismo tiempo; Por ejemplo, 30 usuarios hacen clic en Guardar al mismo tiempo.

31/Mar/2009:11:45:29 +0200 [333] -> GET /author/libs/Personalize/content/statics.close.gif HTTP/1.1
31/Mar/2009:11:45:29 +0200 [334] -> GET /author/libs/Personalize/content/statics.detach.gif HTTP/1.1
31/Mar/2009:11:45:30 +0200 [335] -> GET /author/libs/CFC/content/imgs/logo.rZMNURccynWcTpCxyuBNiTCoiBMmw000.default.gif HTTP/1.1
31/Mar/2009:11:45:32 +0200 [335] <- 304 text/html 0ms
31/Mar/2009:11:45:33 +0200 [334] <- 200 image/gif 31ms
31/Mar/2009:11:45:38 +0200 [333] <- 200 image/gif 31ms
31/Mar/2009:11:45:42 +0200 [336] -> GET /author/libs/CFC/content/imgs/logo.rZMNURccynWcTZRXunQbbQtvuuCMbRRBuWXz0000.default.gif HTTP/1.1
31/Mar/2009:11:45:43 +0200 [337] -> GET /author/titlebar_bg.gif HTTP/1.1
31/Mar/2009:11:45:43 +0200 [336] <- 304 text/html 0ms
31/Mar/2009:11:45:44 +0200 [337] <- 304 text/html 0ms

Uso de rlog.jar para encontrar solicitudes con largos tiempos de duración

AEM incluye varias herramientas de ayuda ubicadas en:
<cq-installation-dir>/crx-quickstart/opt/helpers

Uno de ellos, rlog.jar, se puede usar para ordenar request.log rápidamente de modo que las solicitudes se muestren por duración, de más tiempo a menos.

El siguiente comando muestra los posibles argumentos:

$java -jar rlog.jar
Request Log Analyzer Version 21584 Copyright 2005 Day Management AG
Usage:
  java -jar rlog.jar [options] <filename>
Options:
  -h               Prints this usage.
  -n <maxResults>  Limits output to <maxResults> lines.
  -m <maxRequests> Limits input to <maxRequest> requests.
  -xdev            Exclude POST request to CRXDE.

Por ejemplo, puede ejecutarlo especificando el archivo request.log como parámetro y mostrar las 10 primeras solicitudes que tienen la duración más larga:

$ java -jar ../opt/helpers/rlog.jar -n 10 request.log
*Info * Parsed 464 requests.
*Info * Time for parsing: 22ms
*Info * Time for sorting: 2ms
*Info * Total Memory: 1mb
*Info * Free Memory: 1mb
*Info * Used Memory: 0mb
------------------------------------------------------
     18051ms 31/Mar/2009:11:15:34 +0200 200 GET /content/geometrixx/en/company.html text/ html
      2198ms 31/Mar/2009:11:15:20 +0200 200 GET /libs/cq/widgets.js application/x-javascript
      1981ms 31/Mar/2009:11:15:11 +0200 200 GET /libs/wcm/content/welcome.html text/html
      1973ms 31/Mar/2009:11:15:52 +0200 200 GET /content/campaigns/geometrixx.teasers..html text/html
      1883ms 31/Mar/2009:11:15:20 +0200 200 GET /libs/security/cq-security.js application/x-javascript
      1876ms 31/Mar/2009:11:15:20 +0200 200 GET /libs/tagging/widgets.js application/x-javascript
      1869ms 31/Mar/2009:11:15:20 +0200 200 GET /libs/tagging/widgets/themes/default.js application/x-javascript
      1729ms 30/Mar/2009:16:45:56 +0200 200 GET /libs/wcm/content/welcome.html text/html; charset=utf-8
      1510ms 31/Mar/2009:11:15:34 +0200 200 GET /bin/wcm/contentfinder/asset/view.json/ content/dam?_dc=1238490934657&query=&mimeType=image&_charset_=utf-8 application/json
      1462ms 30/Mar/2009:17:23:08 +0200 200 GET /libs/wcm/content/welcome.html text/html; charset=utf-8

Es posible que deba concatenar los archivos request.log individuales si necesita realizar esta operación en una muestra de datos de gran tamaño.

Apache Bench

Para minimizar el impacto de casos especiales (como la colección de residuos, etc.), se recomienda utilizar una herramienta como apachebench (consulte, por ejemplo, ab para obtener más documentación) para ayudar a identificar fugas de memoria y analizar selectivamente el tiempo de respuesta.

Apache Bench se puede utilizar de la siguiente manera:

$ ab -c 5 -k -n 1000 "https://localhost:4503/content/geometrixx/en/company.html"
This is ApacheBench, Version 2.3 <$Revision: 655654 $>
Copyright 1996 Adam Twiss, Zeus Technology Ltd, https://www.zeustech.net/
Licensed to The Apache Software Foundation, https://www.apache.org/

Benchmarking localhost (be patient)
Completed 100 requests
Completed 200 requests
Completed 300 requests
Completed 400 requests
Completed 500 requests
Completed 600 requests
Completed 700 requests
Completed 800 requests
Completed 900 requests
Completed 1000 requests
Finished 1000 requests

Server Software: Day-Servlet-Engine/4.1.52
Server Hostname: localhost
Server Port: 4503

Document Path: /content/geometrixx/en/company.html
Document Length: 24127 bytes

Concurrency Level: 5
Time taken for tests: 69.766 seconds
Complete requests: 1000
Failed requests: 998
(Connect: 0, Receive: 0, Length: 998, Exceptions: 0)
Write errors: 0
Keep-Alive requests: 0
Total transferred: 24160923 bytes
HTML transferred: 24010923 bytes
Requests per second: 14.33 /sec (mean)
Time per request: 348.828 [ms] (mean)
Time per request: 69.766 [ms] (mean, across all concurrent requests)
Transfer rate: 338.20 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 0 1 3.9 0 58
Processing: 138 347 568.5 282 8106
Waiting: 137 344 568.1 281 8106
Total: 139 348 568.4 283 8106

Percentage of the requests served within a certain time (ms)
50% 283
66% 323
75% 356
80% 374
90% 439
95% 512
98% 1047
99% 1132
100% 8106 (longest request)

Los números anteriores se toman de un portátil MAcBook Pro estándar (mediados de 2010) que accede a la página de empresa de geometrixx, tal como se incluye en una instalación AEM predeterminada. La página es muy sencilla, pero no está optimizada para el rendimiento.

apachebench también muestra el tiempo por solicitud como la media en todas las solicitudes simultáneas; consulte Time per request: 54.595 [ms] (media, en todas las solicitudes simultáneas). Puede cambiar el valor del parámetro de concurrencia -c (número de solicitudes múltiples que se deben realizar a la vez) para ver cualquier efecto.

Contadores de solicitudes

La información sobre el tráfico de solicitudes (número de solicitudes durante un período de tiempo específico) le proporciona una indicación de la carga de la instancia. Esta información se puede extraer de request.log, aunque el uso de contadores automatizará la recopilación de datos para que pueda ver:

• diferencias significativas en la actividad (es decir, diferenciar entre "muchas solicitudes" y "baja actividad")
• cuando no se está utilizando una instancia
• cualquier reinicio (los contadores se restablecen en 0)

Para automatizar la recopilación de información, también puede instalar un RequestFilter para incrementar un contador en cada solicitud. Se pueden usar varios contadores para diferentes periodos de tiempo.

La información recopilada puede utilizarse para indicar:

• cambios significativos en la actividad
• una instancia redundante
• cualquier reinicio (contador restablecer a 0)

Comentarios HTML

Se recomienda que cada proyecto incluya html comments para el rendimiento del servidor. Se pueden encontrar muchos buenos ejemplos públicos; seleccione una página, abra el origen de la página para verla y desplácese hasta la parte inferior; se verá código como el siguiente:

</body>
 </html>
        <!--
        Page took 58 milliseconds to be rendered by server
         -->

Monitorización del rendimiento con JConsole

El comando de herramienta jconsole está disponible con el JDK.

1. Inicie la instancia de AEM.

2. Ejecución jconsole.

3. Seleccione la instancia de AEM y Connect.

4. Desde la aplicación Local, haga doble clic en com.day.crx.quickstart.Main; la Información general se mostrará de forma predeterminada:

   

   Después de esto, puede seleccionar otras opciones.

Monitorización del rendimiento mediante (J)VisualVM

Desde JDK 1.6, el comando de herramienta jvisualvm está disponible. Después de instalar JDK 1.6, puede:

1. Inicie la instancia de AEM.

   NOTA

   Si utiliza Java 5, puede agregar el argumento -Dcom.sun.management.jmxremote a la línea de comandos de java que inicia su JVM. JMX está habilitado de forma predeterminada con Java 6.

2. Ejecute:

   • jvisualvm: en la carpeta bin JDK 1.6 (versión probada)
   • visualvm: se puede descargar desde VisualVM (versión de borde de sangrado)

3. Desde la aplicación Local, haga doble clic en com.day.crx.quickstart.Main; la Información general se mostrará de forma predeterminada:

   

   Después de esto, puede seleccionar otras opciones, como Monitor:

   

Puede utilizar esta herramienta para generar volcados de subprocesos y volcados de cabezales de memoria. El equipo de asistencia técnica suele solicitar esta información.

Recopilación de información

Conocer en la medida de lo posible sobre la instalación puede ayudarle a rastrear qué puede haber causado un cambio en el rendimiento y si estos cambios están justificados. Estas métricas deben recopilarse a intervalos regulares para poder ver fácilmente los cambios más importantes.

La siguiente información puede resultar útil:

• ¿Cuántos autores están trabajando con el sistema?
• ¿Cuál es el número promedio de activaciones de página por día?
• ¿Cuántas páginas mantiene actualmente en este sistema?
• Si utiliza MSM, ¿cuál es el número promedio de implementaciones por mes?
• ¿Cuál es el número promedio de Live Copies por mes?
• Si utiliza AEM Assets, ¿cuántos recursos mantiene actualmente en Assets?
• ¿Cuál es el tamaño promedio de los recursos?
• ¿Cuántas plantillas se utilizan actualmente?
• ¿Cuántos componentes se utilizan actualmente?
• ¿Cuántas solicitudes por hora hay en el sistema de creación en tiempo de espera?
• ¿Cuántas solicitudes por hora tiene en el sistema de publicación en tiempo de pico?

¿Cuántos autores están trabajando con el sistema?

Para ver el número de autores que han utilizado el sistema desde la instalación, utilice la línea de comandos:

cd <cq-installation-dir>/crx-quickstart/logs
cut -d " " -f 3 access.log | sort -u | wc -l

Para ver el número de autores que trabajan en una fecha determinada:

grep "<date>" access.log | cut -d " " -f 3 | sort -u | wc -l

¿Cuál es el número promedio de activaciones de página por día?

Para ver el número total de activaciones de página desde la instalación del servidor, utilice una consulta del repositorio; a través de CRXDE - Herramientas - Consulta:

• Tipo XPath

• Ruta /

• Consulta //element(*, cq:AuditEvent)[@cq:type='Activate']

A continuación, calcule el número de días que han transcurrido desde la instalación para calcular la media.

¿Cuántas páginas mantiene actualmente en este sistema?

Para ver el número de páginas que hay actualmente en el servidor, utilice una consulta de repositorio; a través de CRXDE - Herramientas - Consulta:

• Tipo XPath

• Ruta /

• Consulta //element(*, cq:Page)

Si utiliza MSM, ¿cuál es el número promedio de implementaciones por mes?

Para determinar el número total de lanzamientos desde la instalación, utilice una consulta del repositorio; a través de CRXDE - Herramientas - Consulta:

• Tipo XPath

• Ruta /

• Consulta //element(*, cq:AuditEvent)[@cq:type='PageRolledOut']

Calcule el número de meses que han transcurrido desde la instalación para calcular la media.

¿Cuál es el número promedio de Live Copies por mes?

Para determinar el número total de Live Copies realizadas desde la instalación, utilice una consulta del repositorio; a través de CRXDE - Herramientas - Consulta:

• Tipo XPath

• Ruta /

• Consulta //element(*, cq:LiveSyncConfig)

Vuelva a utilizar el número de meses que han transcurrido desde la instalación para calcular la media.

Si utiliza AEM Assets, ¿cuántos recursos mantiene actualmente en Assets?

Para ver cuántos recursos DAM mantiene actualmente, utilice una consulta de repositorio. a través de CRXDE - Herramientas - Consulta:

• Tipo XPath
• Ruta /
• Consulta /jcr:root/content/dam//element(*, dam:Asset)

¿Cuál es el tamaño promedio de los recursos?

Para determinar el tamaño total de la carpeta /var/dam:

1. Utilice WebDAV para asignar el repositorio al sistema de archivos local.

2. Utilice la línea de comandos:

   cd /Volumes/localhost/var
   du -sh dam/
   

   Para obtener el tamaño promedio, divida el tamaño global por el número total de activos en /var/dam (obtenido anteriormente).

¿Cuántas plantillas se utilizan actualmente?

Para ver el número de plantillas que hay actualmente en el servidor, utilice una consulta de repositorio; a través de CRXDE - Herramientas - Consulta:

• Tipo XPath
• Ruta /
• Consulta //element(*, cq:Template)

¿Cuántos componentes se utilizan actualmente?

Para ver el número de componentes que hay actualmente en el servidor, utilice una consulta de repositorio; a través de CRXDE - Herramientas - Consulta:

• Tipo XPath
• Ruta /
• Consulta //element(*, cq:Component)

¿Cuántas solicitudes por hora hay en el sistema de creación en tiempo de espera?

Para determinar las solicitudes por hora que tiene en el sistema de creación en el momento de mayor actividad:

1. Para determinar el número total de solicitudes desde la instalación, utilice la línea de comandos:

   cd <cq-installation-dir>/crx-quickstart/logs
   grep -R "\->" request.log | wc -l
   

2. Para determinar las fechas de inicio y finalización:

   vim request.log
   G / 1G: for the last/first lines
   

   Utilice estos valores para calcular el número de horas que han transcurrido desde la instalación y el número promedio de solicitudes por hora.

¿Cuántas solicitudes por hora tiene en el sistema de publicación en tiempo de pico?

Repita el procedimiento anterior en la instancia de publicación.

Análisis de escenarios específicos

La siguiente es una lista de sugerencias sobre qué comprobar si comienza a experimentar determinados problemas de rendimiento. La lista no es (lamentablemente) totalmente completa.

CPU al 100%

Si la CPU de su sistema está funcionando constantemente al 100%, consulte:

• La base de conocimientos:

  • Analizar procesos lentos y bloqueados

Memoria insuficiente

Aunque estos errores deben detectarse durante el desarrollo y la prueba, algunos escenarios pueden superarse.

Si el sistema se está quedando sin memoria, esto puede verse de varias maneras, incluida la degradación del rendimiento y los mensajes de error, incluido el subtexto:

java.lang.OutOfMemoryError

En estos casos, compruebe:

• La configuración de JVM utilizada para iniciar AEM

• La base de conocimientos:

  • Analizar problemas de memoria

E/S de disco

Si el sistema se está quedando sin espacio en disco o observa que se está iniciando el almacenamiento en disco, consulte:

• Si ha deshabilitado la recopilación de información de depuración; esto puede configurarse en varias ubicaciones, entre ellas:

  • Controlador de scripts JSP de Apache Sling
  • Controlador de Java Script de Apache Sling
  • Configuración de registro de Apache Sling
  • CQ HTML Library Manager
  • Filtro de depuración de CQ WCM
  • Usuarios

• Si ha configurado Version Purging y cómo lo ha hecho

• La base de conocimientos:

  • Demasiados archivos abiertos
  • El diario consume demasiado espacio en disco

Degradación del rendimiento normal

Si ve que el rendimiento de su instancia se deteriora después de cada reinicio (a veces una semana o más después), se puede comprobar lo siguiente:

• Memoria insuficiente

• La base de conocimientos:

  • Sesiones no cerradas

Ajuste de JVM

La máquina virtual Java (JVM) ha mejorado significativamente con respecto al ajuste (especialmente desde Java 7). Debido a esto, especificar un tamaño razonable de JVM fijo y utilizar los valores predeterminados a menudo será adecuado.

Si los ajustes predeterminados no son adecuados, es importante establecer un método para supervisar y evaluar el rendimiento de GC antes de intentar ajustar el JVM; esto puede implicar factores de monitorización como, por ejemplo, tamaño de pila, algoritmo y otros aspectos.

Algunas opciones comunes son:

• VerboseGC:

  -verbose:gc \
   -Xloggc:$LOGS/verbosegc.log \
   -XX:+PrintGCDetails \
   -XX:+PrintGCDateStamps
  

El registro resultante se puede ingerir mediante un visualizador GC como:

[https://www.ibm.com/developerworks/library/j-ibmtools2/](https://www.ibm.com/developerworks/library/j-ibmtools2/)

O JConsole:

• Estos ajustes son para una conexión JMX "abierta":

  -Dcom.sun.management.jmxremote \
   -Dcom.sun.management.jmxremote.port=8889 \
   -Dcom.sun.management.jmxremote.authenticate=false \
   -Dcom.sun.management.jmxremote.ssl=false
  

• A continuación, conéctese a la JVM con la JConsole; consulte:
  [https://docs.oracle.com/javase/6/docs/technotes/guides/management/jconsole.html](https://docs.oracle.com/javase/6/docs/technotes/guides/management/jconsole.html)

Esto le ayudará a ver cuánta memoria se está utilizando, qué algoritmos GC se están utilizando, cuánto tiempo tardan en ejecutarse y qué efecto tiene en el rendimiento de la aplicación. Sin esto, sintonizar es sólo "mandos de ajuste aleatorio".