Supervisión y mantenimiento de la instancia de AEM monitoring-and-maintaining-your-aem-instance
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.
*ERROR* LowDiskSpaceBlocker
Los mensajes " pueden verse en el archivo de registro cuando el espacio libre se reduce.Copias de seguridad backups
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 backing-up-your-software-installation
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 hacer una copia de seguridad de todo el repositorio y luego:
- Paren AEM.
- Haga una copia de seguridad de todo
<cq-installation-dir>
del sistema de archivos.
Copia de seguridad del repositorio backing-up-your-repository
La variable Copia de seguridad y restauración 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 version-purging
La variable Purgar versiones 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 variable Purgar versión 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 overview
La variable Purgar versiones está disponible en la Herramientas consola under Versiones o directamente en:
https://<server>:<port>/etc/versioning/purge.html
Ruta de inicio Una 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.
Recursivo Al 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áximas versiones que mantener Número máximo de versiones que se deben mantener 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 Como la eliminación de versiones del contenido es definitiva 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.
Purga Inicie la depuración de las versiones en el nodo definido por la ruta de inicio.
Depuración de versiones de un sitio web purging-versions-of-a-web-site
Para purgar versiones de un sitio web, siga este procedimiento:
-
Vaya a la Herramientas consola, seleccione Versiones y doble clic Purgar versiones.
-
Establezca la ruta de inicio del contenido que desea depurar (p. ej.
/content/geometrixx-outdoors
).- Si solo desea depurar el nodo definido por la ruta, anule la selección Recursivo.
- Si desea purgar el nodo definido por la ruta y sus descendientes, seleccione Recursivo.
-
Establezca el número máximo de versiones (para cada nodo) que desea mantener. Deje vacío para no utilizar esta configuración.
-
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.
-
Haga clic en Ensayo para obtener una vista previa de lo que haría el proceso de depuración.
-
Haga clic en Purga para iniciar el proceso.
Análisis de la consola analyzing-the-console
La variable Ensayo y Purga los procesos 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:
- La variable Camisas las versiones se depuran porque su edad de versión es buena a 2 días.
- La variable ¡Tonga Fashions! se depuran porque el número de versiones es bueno a 5.
Uso de registros de auditoría y archivos de registro working-with-audit-records-and-log-files
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 working-with-logs
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 log-file-rotation
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án una vez al día según las reglas dadas:
- La variable
error.log
se cambia el nombre del archivo según el patrón {original_filename}.yyyy-MM-dd
. Por ejemplo, el 11 de julio de 2010, se cambia el nombre del archivo de registro actualerror.log-2010-07-10
, luegoerror.og
se crea. - 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 finding-the-log-files
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 el Dynamic Media está activado. 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.
-
Este registro solo se utiliza si el Dynamic Media está activado. El registro s7access registra cada solicitud realizada a Dynamic Media a través de
/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
ycom.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 activating-the-debug-log-level
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 la variable 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:
Crear un archivo de registro personalizado create-a-custom-log-file
En determinadas circunstancias, es posible que desee crear un archivo de registro personalizado con un nivel de registro diferente. Puede hacerlo en el repositorio:
-
Si aún no existe, cree una nueva carpeta de configuración (
sling:Folder
) para su proyecto/apps/<project-name>/config
. -
En
/apps/<project-name>/config
, cree un nodo para el nuevo Configuración del registrador 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
note note NOTE Aunque no es un requisito técnico, es aconsejable realizar <identifier>
único. -
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: especifique el nivel de registro requerido (
debug
,info
,warn
oerror
); por ejemplodebug
-
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}
-
note note NOTE org.apache.sling.commons.log.pattern
admite hasta seis argumentos.{0} Marca de tiempo del 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 stacktrace se anexa al mensaje.note caution CAUTION org.apache.sling.commons.log.names debe tener un valor. note note NOTE Las rutas de escritura de registros son relativas a la variable crx-quickstart
ubicación.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/
) -
-
Este paso solo es necesario cuando se requiere un nuevo Writer (es decir, con una configuración diferente a la predeterminada Writer).
note caution CAUTION 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 el nuevo Configuración del Escritor de registro de Apache Sling:-
Nombre:
org.apache.sling.commons.log.LogManager.factory.writer-<identifier>
(ya que esto es un escritor)Al igual que con el registrador,
<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.writer-MINE
. -
Tipo:
sling:OsgiConfig
note note NOTE Aunque no es un requisito técnico, es aconsejable realizar <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
-
note note NOTE 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
oGB
(se omiten las mayúsculas y minúsculas). - Se puede especificar una programación de fecha/hora como
java.util.SimpleDateFormat
patrón. 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. table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 '.'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: -
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.
-
Utilice únicamente caracteres permitidos para un nombre de archivo válido en cualquier parte de la opción.
-
-
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 de Sling en ../system/console/slinglog
; por ejemplo http://localhost:4502/system/console/slinglog
.
Búsqueda de registros de auditoría finding-the-audit-records
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 aem-wcm-audit-records-shown-when-page-authoring
-
Abra una página.
-
Desde la barra de tareas puede seleccionar la ficha con el icono de bloqueo y luego hacer doble clic en Registro de auditoría…
-
Se abrirá una nueva ventana que muestra la lista de registros de auditoría de la página actual.
-
Haga clic en OK cuando desee cerrar la ventana.
AEM WCM Auditing records dentro del repositorio aem-wcm-auditing-records-within-the-repository
Dentro de /var/audit
carpeta, 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 osgi-audit-records-from-the-web-console
Los eventos OSGi también generan registros de auditoría que pueden verse desde la variable Estado de configuración pestaña -> Archivos de registro en la consola web de AEM:
Monitorización de los agentes de replicación monitoring-your-replication-agents
Puede monitorizar su colas de replicación para detectar cuándo una cola está bloqueada o desactivada, 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?
-
all
enabled
las colas deben tener el estadoidle
oactive
, que indican un funcionamiento normal; no debe haber colasblocked
, que suele ser un signo de problemas en el lado del receptor. -
si el tamaño de la cola crece con el tiempo, esto puede indicar una cola bloqueada.
Para monitorizar un agente de replicación:
-
Acceda a la Herramientas en AEM.
-
Haga clic en Replicación.
-
Haga doble clic en el vínculo a los agentes para el entorno adecuado (panel izquierdo o derecho); por ejemplo Agentes en autor.
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.
-
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 actualizar la visualización de las entradas de la cola; esto le ayuda a ver los elementos que entran y salen de la cola.
- Ver registro para acceder al registro de cualquier acción del agente de replicación.
- Probar conexión a la instancia de destino.
- Forzar reintento en cualquier elemento de cola si es necesario.
note caution CAUTION 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, a continuación, compruebe el estado del agente ( enabled
, disabled
) y la cola subyacente ( active
, idle
, blocked
).
Monitorización del rendimiento monitoring-performance
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.
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 tools-for-monitoring-and-analyzing-performance
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.
Interpretación del archivo request.log interpreting-the-request-log
Este archivo registra información básica sobre cada solicitud realizada a AEM. De estas valiosas conclusiones se pueden extraer.
La variable request.log
ofrece una forma integrada de obtener una visión de cuánto tardan las solicitudes. Para fines de desarrollo, resulta útil tail -f
el request.log
y observe los tiempos de respuesta lentos. Para analizar un tamaño mayor request.log
le recomendamos que uso de rlog.jar
que le permite ordenar y filtrar los tiempos de respuesta.
Se recomienda aislar las páginas "lentas" del request.log
y, a continuación, ajustarlos de forma individual para obtener un mejor rendimiento. Esto generalmente se hace 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 monitoring-traffic-on-your-website
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 monitoring-response-times-with-the-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 monitoring-search-response-times-with-the-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 monitoring-the-number-and-impact-of-concurrent-users
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; p. ej., 30 usuarios haciendo 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 using-rlog-jar-to-find-requests-with-long-duration-times
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 rápidamente request.log
de modo que las solicitudes se muestren por duración, desde el más largo hasta el más corto.
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 request.log
como parámetro y muestran 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 necesite concatenar al individuo request.log
si necesita realizar esta operación en una muestra de datos de gran tamaño.
Apache Bench 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 "http://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; see Time per request: 54.595 [ms]
(es decir, 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 request-counters
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 del HTML html-comments
Se recomienda que todos los proyectos incluyan 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 monitoring-performance-using-jconsole
El comando herramienta jconsole
está disponible con el JDK.
-
Inicie la instancia de AEM.
-
Ejecución
jconsole.
-
Seleccione la instancia de AEM y Connect.
-
Desde dentro de la variable
Local
aplicación, doble cliccom.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 monitoring-performance-using-j-visualvm
Desde JDK 1.6, el comando herramienta jvisualvm
está disponible. Después de instalar JDK 1.6, puede:
-
Inicie la instancia de AEM.
note note NOTE Si utiliza Java 5, puede agregar la variable -Dcom.sun.management.jmxremote
a la línea de comandos java que inicia su JVM. JMX está habilitado de forma predeterminada con Java 6. -
Ejecute:
jvisualvm
: en la carpeta bin JDK 1.6 (versión probada)visualvm
: se puede descargar desde VisualVM (versión del borde sangrante)
-
Desde dentro de la variable
Local
aplicación, doble cliccom.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 information-collection
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? how-many-authors-are-working-with-the-system
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? what-is-the-average-number-of-page-activations-per-day
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? how-many-pages-do-you-currently-maintain-on-this-system
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? if-you-use-msm-what-is-the-average-number-of-rollouts-per-month
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? what-is-the-average-number-of-live-copies-per-month
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? if-you-use-aem-assets-how-many-assets-do-you-currently-maintain-in-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? what-is-the-average-size-of-the-assets
Para determinar el tamaño total de la variable /var/dam
carpeta:
-
Utilice WebDAV para asignar el repositorio al sistema de archivos local.
-
Utilice la línea de comandos:
code language-shell 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? how-many-templates-are-currently-used
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? how-many-components-are-currently-used
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? how-many-requests-per-hour-do-you-have-on-the-author-system-at-peak-time
Para determinar las solicitudes por hora que tiene en el sistema de creación en el momento de mayor actividad:
-
Para determinar el número total de solicitudes desde la instalación, utilice la línea de comandos:
code language-shell cd <cq-installation-dir>/crx-quickstart/logs grep -R "\->" request.log | wc -l
-
Para determinar las fechas de inicio y finalización:
code language-shell 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? how-many-requests-per-hour-do-you-have-on-the-publish-system-at-peak-time
Repita el procedimiento anterior en la instancia de publicación.
Análisis de escenarios específicos analyzing-specific-scenarios
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% cpu-at
Si la CPU de su sistema está funcionando constantemente al 100%, consulte:
-
La base de conocimientos:
Memoria insuficiente out-of-memory
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 inicio AEM
-
La base de conocimientos:
E/S de disco disk-i-o
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:
-
Si ha configurado Depuración de versiones
-
La base de conocimientos:
Degradación del rendimiento normal regular-performance-degradation
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:
-
La base de conocimientos:
Ajuste de JVM jvm-tuning
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:
code language-none -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":
code language-none -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".