Supervisión de recursos del servidor mediante la consola JMX

La consola JMX permite supervisar y administrar los servicios en el servidor CRX. Las secciones siguientes resumen los atributos y las operaciones expuestos a través del marco de trabajo JMX.

Para obtener información sobre cómo utilizar los controles de la consola, consulte Uso de la consola JMX. Para obtener información general sobre JMX, consulte la Tecnología Java Management Extensions (JMX) en el sitio web del Oracle.

Para obtener información sobre la creación de MBeans para administrar los servicios mediante la consola JMX, consulte Integración de servicios con la consola JMX.

Mantenimiento de flujo de trabajo

Operaciones para administrar instancias de flujo de trabajo en ejecución, completadas, obsoletas y fallidas.

• Dominio: com.adobe.granite.workflow
• Tipo: Mantenimiento

Operaciones

listRunningWorkflowsPerModel Indica el número de instancias de flujo de trabajo que se ejecutan para cada modelo de flujo de trabajo.

• Argumentos: ninguno
• Valor devuelto: datos tabulares que contienen las columnas Count y ModelId.

listCompletedWorkflowsPerModel Indica el número de instancias de flujo de trabajo completadas para cada modelo de flujo de trabajo.

• Argumentos: ninguno
• Valor devuelto: datos tabulares que contienen las columnas Count y ModelId.

returnWorkflowQueueInfo Enumera información sobre los elementos de flujo de trabajo que se han procesado y que se han puesto en cola para su procesamiento.

• Argumentos: ninguno

• Valor devuelto: Datos de tabla que contienen las siguientes columnas:

  • Trabajos
  • Nombre de cola
  • Activar tareas
  • Tiempo medio de procesamiento
  • Tiempo medio de espera
  • Tareas canceladas
  • Tareas con errores
  • Trabajos finalizados
  • Trabajos procesados
  • Trabajos en cola

returnWorkflowJobTopicInfo Enumera la información de procesamiento de los trabajos de flujo de trabajo, organizada por temas.

• Argumentos: ninguno

• Valor devuelto: datos tabulares que contienen las siguientes columnas:

  • Nombre del tema
  • Tiempo medio de procesamiento
  • Tiempo medio de espera
  • Tareas canceladas
  • Tareas con errores
  • Trabajos finalizados
  • Trabajos procesados

returnFailedWorkflowCount Muestra el número de instancias de flujo de trabajo que han fallado. Puede especificar un modelo de flujo de trabajo para consultar o recuperar información de todos los modelos de flujo de trabajo.

• Argumentos:

  • model: ID del modelo que se va a consultar. Para ver un recuento de instancias de flujo de trabajo con errores para todos los modelos de flujo de trabajo, especifique sin valor. El ID es la ruta al nodo del modelo, por ejemplo:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Valor devuelto: número de instancias de flujo de trabajo con errores.

returnFailedWorkflowCountPerModel Muestra el número de instancias de flujo de trabajo que han fallado para cada modelo de flujo de trabajo.

• Argumentos: ninguno.
• Valor devuelto: datos tabulares que contienen las columnas Recuento e ID de modelo.

terminateFailedInstances Finalice las instancias de flujo de trabajo con errores. Puede finalizar todas las instancias fallidas o solo las instancias fallidas para un modelo específico. De forma opcional, puede reiniciar las instancias una vez finalizadas. También puede probar la operación para ver los resultados sin realizar realmente la operación.

• Argumentos:

  • Reinicie la instancia: (Opcional) Especifique un valor de true para reiniciar las instancias una vez terminadas. El valor predeterminado de false no provoca el reinicio de instancias de flujo de trabajo terminadas.

  • Ejecución en seco: (Opcional) especifique un valor de true para ver los resultados de la operación sin realizar realmente la operación. El valor predeterminado de false hace que se realice la operación.

  • Modelo: (Opcional) ID del modelo al que se aplica la operación. No especifique ningún modelo para aplicar la operación a las instancias fallidas de todos los modelos de flujo de trabajo. El ID es la ruta al nodo del modelo, por ejemplo:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Valor devuelto: Datos de tabla sobre las instancias que han finalizado, que contienen las columnas siguientes:

  • Iniciador
  • InstanceId
  • ModelId
  • Carga útil
  • StartComment
  • WorkflowTitle

retryFailedWorkItems Intenta ejecutar pasos de elementos de trabajo que han fallado. Puede reintentar todos los elementos de trabajo con errores o solo los elementos de trabajo con errores para un modelo de flujo de trabajo específico. Si lo desea, puede probar la operación para ver los resultados sin realizar realmente la operación.

• Argumentos:

  • Ejecución en seco: (Opcional) especifique un valor de true para ver los resultados de la operación sin realizar realmente la operación. El valor predeterminado de false hace que se realice la operación.

  • Modelo: (Opcional) ID del modelo al que se aplica la operación. No especifique ningún modelo para aplicar la operación a los elementos de trabajo con errores de todos los modelos de flujo de trabajo. El ID es la ruta al nodo del modelo, por ejemplo:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Valor devuelto: datos de tabla sobre los elementos de trabajo con errores que se vuelven a intentar, incluidas las columnas siguientes:

  • Iniciador
  • InstanceId
  • ModelId
  • Carga útil
  • StartComment
  • WorkflowTitle

PurgeActive Elimina las instancias de flujo de trabajo activas de una página específica. Se pueden depurar instancias activas para todos los modelos o sólo las instancias de un modelo específico. Si lo desea, puede probar la operación para ver los resultados sin realizar realmente la operación.

• Argumentos:

  • Modelo: (Opcional) ID del modelo al que se aplica la operación. No especifique ningún modelo para aplicar la operación a las instancias de flujo de trabajo de todos los modelos de flujo de trabajo. El ID es la ruta al nodo del modelo, por ejemplo:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Número de días desde que se inició el flujo de trabajo: antigüedad de las instancias de flujo de trabajo que se van a depurar, en días.

  • Ejecución en seco: (Opcional) especifique un valor de true para ver los resultados de la operación sin realizar realmente la operación. El valor predeterminado de false hace que se realice la operación.

• Valor devuelto: datos tabulares sobre las instancias de flujo de trabajo activas que se depuran, incluidas las siguientes columnas:

  • Iniciador
  • InstanceId
  • ModelId
  • Carga útil
  • StartComment
  • WorkflowTitle

countStaleWorkflows Devuelve el número de instancias de flujo de trabajo que están obsoletas. Puede recuperar el número de instancias antiguas para todos los modelos de flujo de trabajo o para un modelo específico.

• Argumentos:

  • Modelo: (Opcional) ID del modelo al que se aplica la operación. No especifique ningún modelo para aplicar la operación a las instancias de flujo de trabajo de todos los modelos de flujo de trabajo. El ID es la ruta al nodo del modelo, por ejemplo:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Valor devuelto: número de instancias de flujo de trabajo antiguas.

restartStaleWorkflows Reinicia instancias de flujo de trabajo obsoletas. Puede reiniciar todas las instancias antiguas o solo las instancias antiguas de un modelo específico. También puede probar la operación para ver los resultados sin realizar realmente la operación.

• Argumentos:

  • Modelo: (Opcional) ID del modelo al que se aplica la operación. No especifique ningún modelo para aplicar la operación a las instancias antiguas de todos los modelos de flujo de trabajo. El ID es la ruta al nodo del modelo, por ejemplo:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Ejecución en seco: (Opcional) especifique un valor de true para ver los resultados de la operación sin realizar realmente la operación. El valor predeterminado de false hace que se realice la operación.

• Valor devuelto: lista de instancias de flujo de trabajo que se reinician.

fetchModelList Muestra todos los modelos de flujo de trabajo.

• Argumentos: ninguno
• Valor devuelto: datos de tabla que identifican los modelos de flujo de trabajo, incluidas las columnas ModelId y ModelName.

countRunningWorkflows Devuelve el número de instancias de flujo de trabajo en ejecución. Puede recuperar el número de instancias en ejecución para todos los modelos de flujo de trabajo o para un modelo específico.

• Argumentos:

  • Modelo: (Opcional) ID del modelo para el que se devuelve el número de instancias en ejecución. No especificar ningún modelo para devolver el número de instancias en ejecución de todos los modelos de flujo de trabajo. El ID es la ruta al nodo del modelo, por ejemplo:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Valor devuelto: número de instancias de flujo de trabajo en ejecución.

countCompletedWorkflows Devuelve el número de instancias de flujo de trabajo que se han completado. Puede recuperar el número de instancias completadas para todos los modelos de flujo de trabajo o para un modelo específico.

• Argumentos:

  • Modelo: (Opcional) ID del modelo para el que se devuelve el número de instancias completadas. No especificar ningún modelo para devolver el número de instancias completadas de todos los modelos de flujo de trabajo. El ID es la ruta al nodo del modelo, por ejemplo:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Valor devuelto: número de instancias de flujo de trabajo completadas.

purgeCompleted Elimina del repositorio los registros de los flujos de trabajo completados de una página específica. Utilice esta operación periódicamente para minimizar el tamaño del repositorio cuando haga un uso intensivo de los flujos de trabajo. Puede depurar instancias completadas para todos los modelos o solo las instancias de un modelo específico. Si lo desea, puede probar la operación para ver los resultados sin realizar realmente la operación.

• Argumentos:

  • Modelo: (Opcional) ID del modelo al que se aplica la operación. No especifique ningún modelo para aplicar la operación a las instancias de flujo de trabajo de todos los modelos de flujo de trabajo. El ID es la ruta al nodo del modelo, por ejemplo:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Número de días transcurridos desde que se completó el flujo de trabajo: número de días durante los cuales las instancias del flujo de trabajo quedaron en el estado completado.

  • Ejecución en seco: (Opcional) especifique un valor de true para ver los resultados de la operación sin realizar realmente la operación. El valor predeterminado de false hace que se realice la operación.

• Valor devuelto: datos tabulares sobre las instancias de flujo de trabajo completadas que se depuran, incluidas las columnas siguientes:

  • Iniciador
  • InstanceId
  • ModelId
  • Carga útil
  • StartComment
  • WorkflowTitle

Repositorio

Información sobre el repositorio CRX

• Dominio: com.adobe.granite
• Tipo: repositorio

Atributos

Nombre Nombre de la implementación del repositorio JCR. Solo lectura.

Versión La versión de implementación del repositorio. Solo lectura.

HomeDir El directorio en el que se encuentra el repositorio. La ubicación predeterminada es <quickstart_jar_location>/crx-quickstart/repository. Solo lectura.

NombreCliente El nombre del cliente al que se emite la licencia de software. Solo lectura.

LicenseKey La clave de licencia única para esta instalación del repositorio. Solo lectura.

AvailableDiskSpace Espacio en disco disponible para esta instancia del repositorio, en MB. Solo lectura.

MaximumNumberOfOpenFiles Número de archivos que se pueden abrir al mismo tiempo. Solo lectura.

SessionTracker Valor de la variable del sistema crx.debug.session. true indica una sesión de depuración. false indica una sesión normal. Lectura y escritura.

Descriptores Conjunto de pares de clave-valor que representan las propiedades del repositorio. Todas las propiedades son de solo lectura.

Clave	Valor
option.node.and.property.with.same.name.supported	Indica si un nodo y una propiedad del nodo pueden tener el mismo nombre. true indica que se admiten los mismos nombres, false indica que no se admiten.
identifier.stability	Indica la estabilidad de los identificadores de nodo no referenciables. Los siguientes valores son posibles: identifier.stable.indefinite.duration: Los identificadores no cambian. identifier.Stability.method.duration: los identificadores pueden cambiar entre llamadas de método. identifier.stable.save.duration: Los identificadores no cambian dentro de un ciclo de guardado/actualización. identifier.Stability.session.duration: Los identificadores no cambian durante una sesión.
query.xpath.pos.index	Indica si se admite el lenguaje de consulta JCR 1.0 XPath. true indica compatibilidad y false indica que no la admite.
crx.repository.systemid	El identificador del sistema tal como se encuentra en el archivo system.id.
option.query.sql.supported	Indica si se admite el lenguaje de consulta JCR 1.0 XPath. true indica compatibilidad y false indica que no la admite.
jcr.repository.version	La versión de la implementación del repositorio.
option.update.primary.node.type.supported	Indica si se puede cambiar el tipo de nodo principal de un nodo. true indica que puede cambiar el tipo de nodo principal y false indica que no se admite el cambio.
option.node.type.management.supported	Indica si se admite la administración del tipo de nodo. true indica que se admite y false indica que no se admite.
node.type.management.overrides.supported	Indica si se puede anular la propiedad heredada o la definición de nodo secundario de un tipo de nodo. true indica que se admiten invalidaciones y false indica que no se admiten invalidaciones.
option.observation.supported	true indica que se admite la observación asincrónica de los cambios del repositorio. La compatibilidad con la observación asincrónica permite a las aplicaciones recibir y responder a las notificaciones sobre cada cambio a medida que se produce.
query.jcrscore	true indica que la pseudopropiedad jcr:score está disponible en consultas XPath y SQL que incluyen una función jcrfn:contains (en XPath) o CONTAINS (en SQL) para realizar una búsqueda de texto completo.
option.simple.versioning.supported	true indica que el repositorio admite versiones simples. Con el control de versiones sencillo, el repositorio mantiene una serie secuencial de versiones de un nodo.
option.workspace.management.supported	true indica que el repositorio admite la creación y eliminación de espacios de trabajo mediante API.
option.update.mixin.node.types.supported	true indica que el repositorio admite la adición y eliminación de tipos de nodos de mezcla de un nodo existente.
node.type.management.primary.item.name.supported	true indica que el repositorio permite que las definiciones de nodo contengan un elemento principal como elemento secundario. Se puede acceder a un elemento principal mediante la API sin conocer el nombre del elemento.
level.2.supported	true indica que tanto LEVEL_1_SUPPORTED como OPTION_XML_IMPORT_SUPPORTED son true.
write.supported	true indica que el repositorio proporciona acceso de escritura mediante la API. false indica acceso de solo lectura.
node.type.management.update.in.use.supported	true indica que puede cambiar las definiciones de nodo que están en uso por los nodos existentes.
jcr.specification.version	La versión de la especificación JCR que implementa el repositorio.
option.journaled.observation.supported	true indica que las aplicaciones pueden realizar una observación en diario del repositorio. con la observación en diario, se puede obtener un conjunto de notificaciones de cambio para un período de tiempo específico.
query.languages	Los idiomas de consulta compatibles con el repositorio. Ningún valor indica que no se admitan consultas.
option.xml.export.supported	true indica que el repositorio admite la exportación de nodos como código XML.
node.type.management.multiple.binary.properties.supported	true indica que el repositorio admite el registro de tipos de nodo que tienen varias propiedades binarias. false indica que se admite una sola propiedad binaria para un tipo de nodo.
option.access.control.supported	true indica que el repositorio admite el control de acceso para establecer y determinar privilegios de usuario para el acceso a nodos.
option.baselines.supported	true indica que el repositorio admite configuraciones y líneas de base.
option.shareable.nodes.supported	true indica que el repositorio admite la creación de nodos que se pueden compartir.
crx.cluster.id	El identificador del clúster de repositorios.
query.stored.queries.supported	true indica que el repositorio admite consultas almacenadas.
query.full.text.search.supported	true indica que el repositorio admite la búsqueda de texto completo.
node.type.management.inheritance	Indica el nivel de compatibilidad del repositorio para la herencia de tipo de nodo. Los siguientes valores son posibles: node.type.management.inheritance.minimal: El registro de tipos de nodo principales se limita a los que solo tienen nt:base como supertipo. El registro de los tipos de nodos de mezcla está limitado a los que no tienen supertipo. node.type.management.inheritance.single: El registro de tipos de nodos principales se limita a los que tienen un supertipo. El registro de los tipos de nodos de mezcla está limitado a aquellos con un supertipo como máximo. node.type.management.inheritance.multiple: Los tipos de nodo principales se pueden registrar con uno o varios supertipos. Los tipos de nodos mixin se pueden registrar con cero o más supertipos.
crx.cluster.preferredMaster	true indica que este nodo de clúster es el nodo maestro preferido del clúster.
option.transactions.supported	true indica que el repositorio admite transacciones.
jcr.repository.vendor.url	La URL del proveedor del repositorio.
node.type.management.value.constraints.supported	true indica que el repositorio admite restricciones de valor para las propiedades del nodo.
node.type.management.property.types	una matriz de constantes javax.jcr.PropertyType que representan los tipos de propiedad que puede especificar un tipo de nodo registrado. Una matriz de longitud cero indica que los tipos de nodo registrados no pueden especificar definiciones de propiedades. Los tipos de propiedad son STRING, URI, BOOLEAN, LONG, DOUBLE, DECIMAL, BINARY, DATE, NAME, PATH, WEAKREFERENCE, REFERENCE y UNDEFINED (si se admite)
node.type.management.orderable.child.nodes.supported	true indica que el repositorio admite la conservación del orden de los nodos secundarios.
jcr.repository.vendor	El nombre del proveedor del repositorio.
query.joins	Nivel de compatibilidad con uniones en consultas. Los siguientes valores son posibles: query.joins.none: no se admiten combinaciones. Las consultas pueden utilizar un selector. query.joins.inner: Compatibilidad con uniones internas. query.joins.inner.outer: compatibilidad con uniones internas y externas.
org.apache.jackrabbit.spi.commons.AdditionalEventInfo
query.xpath.doc.order	true indica que el repositorio admite el lenguaje de consulta XPath 1.0.
query.jcrpath
option.xml.import.supported	true indica que el repositorio admite la importación de código XML como contenido.
node.type.management.same.name.siblings.supported	true indica que el repositorio admite nodos hermanos (nodos con el mismo nodo principal) con los mismos nombres.
node.type.management.residual.definitions.supported	true indica que el repositorio admite propiedades de nombre con definiciones residuales. Cuando se admite, el atributo name de una definición de elemento puede ser un asterisco ("*").
node.type.management.autocreated.definitions.supported	true indica que el repositorio admite la creación automática de elementos secundarios (nodos o propiedades) de un nodo cuando se crea el nodo.
crx.cluster.master	true indica que este nodo de repositorio es el nodo maestro del clúster.
level.1.supported	true indica que option.xml.export.support es true y query.language tiene una longitud distinta de cero.
option.unfiled.content.supported	true indica que el repositorio admite contenido sin archivar. Los nodos sin archivar no forman parte de la jerarquía del repositorio.
jcr.specification.name	El nombre de la especificación JCR que implementa el repositorio.
option.versioning.supported	true indica que el repositorio admite versiones completas.
jcr.repository.name	El nombre del repositorio.
option.locking.supported	true indica que el repositorio admite el bloqueo de nodos. El bloqueo permite al usuario impedir temporalmente que otros usuarios realicen cambios.
jcr.repository.version.display
option.activities.supported	true indica que el repositorio admite actividades. Las actividades son un conjunto de cambios que se realizan en un espacio de trabajo y que se combinan en otro espacio de trabajo.
node.type.management.multivalued.properties.supported	true indica que el repositorio admite propiedades de nodo que pueden tener cero o más valores.
option.retention.supported	true indica que el repositorio admite el uso de aplicaciones de administración de retención externas para aplicar directivas de retención al contenido y admite retención y liberación.
option.lifecycle.supported	true indica que el repositorio admite la administración del ciclo vital.

WorkspaceNames Nombres de los espacios de trabajo del repositorio. Solo lectura.

DataStoreGarbageCollectionDelay Cantidad de tiempo en milisegundos que la recolección de elementos no utilizados permanece activa después de analizar cada décimo nodo. Lectura y escritura.

BackupDelay La cantidad de tiempo en milisegundos que el proceso de copia de seguridad permanece en suspensión entre cada paso de la copia de seguridad. Lectura y escritura.

CopiaDeSeguridadEnCurso El valor true indica que se está ejecutando un proceso de copia de seguridad. Solo lectura.

BackupProgress Para la copia de seguridad actual, el porcentaje de todos los archivos de los que se ha realizado una copia de seguridad. Solo lectura.

CurrentBackupTarget Para la copia de seguridad actual, el archivo ZIP donde se almacenan los archivos de copia de seguridad. Cuando una copia de seguridad no está en curso, no aparece ningún valor. Solo lectura.

CopiaDeSeguridadCorrecta El valor true indica que no se han producido errores durante la copia de seguridad actual o que no hay ninguna copia de seguridad en curso. false indica que se produjo un error durante la copia de seguridad actual. Solo lectura.

BackupResult El estado de la copia de seguridad actual. Los siguientes valores son posibles:

• Copia de seguridad en curso: se está ejecutando una copia de seguridad.
• Copia de seguridad cancelada: se ha cancelado la copia de seguridad.
• Copia de seguridad finalizada con error: error durante la copia de seguridad. El mensaje de error proporciona información sobre la causa.
• Copia de seguridad completada: la copia de seguridad se realizó correctamente.
• No se ha ejecutado ninguna copia de seguridad hasta el momento: no hay ninguna copia de seguridad en curso.

Solo lectura.

TarOptimizationRunningSince Hora a la que comenzó el proceso actual de optimización de archivos TAR. Solo lectura.

TarOptimizationDelay La cantidad de tiempo en milisegundos que el proceso de optimización de TAR pasa en suspensión entre cada paso del proceso. Lectura y escritura.

Propiedades de clúster Conjunto de pares de clave-valor que representan las propiedades y los valores del clúster. Cada fila de la tabla representa una propiedad de clúster. Solo lectura.

ClusterNodes Los miembros del clúster de repositorios.

ClusterId El identificador de este clúster de repositorios. Solo lectura.

ClusterMasterId El identificador del nodo maestro de este clúster de repositorios. Solo lectura.

ClusterNodeId El identificador de este nodo del clúster de repositorios. Solo lectura.

Operaciones

createWorkspace Crea un espacio de trabajo en este repositorio.

• Argumentos:

  • name: Valor de tipo String que representa el nombre del nuevo espacio de trabajo.

• Valor devuelto: ninguno

runDataStoreGarbageCollection Ejecuta la recolección de elementos no utilizados en los nodos del repositorio.

• Argumentos:

  • delete: valor booleano que indica si se eliminarán los elementos de repositorio no utilizados. El valor true provoca la eliminación de nodos y propiedades no utilizados. El valor false hace que se analicen todos los nodos, pero no se elimina ninguno.

• Valor devuelto: ninguno

stopDataStoreGarbageCollection Detiene la recolección de elementos no utilizados de un almacén de datos en ejecución.

• Argumentos: ninguno
• Valor devuelto: representación de cadena del estado actual

startBackup Realiza una copia de seguridad de los datos del repositorio en un archivo ZIP.

• Argumentos:

  • target: (Opcional) A String valor que representa el nombre del archivo ZIP o del directorio en el que se archivan los datos del repositorio. Para utilizar un archivo ZIP, incluya la extensión del nombre del archivo ZIP. Para utilizar un directorio, no incluya ninguna extensión de nombre de archivo.

    Para realizar una copia de seguridad incremental, especifique el directorio que se utilizó anteriormente para la copia de seguridad.

    Puede especificar una ruta absoluta o relativa. Las rutas relativas son relativas al elemento principal del directorio crx-quickstart.

    Cuando no se especifica ningún valor, el valor predeterminado de backup-currentdate.zip se utiliza, donde currentdate tiene el formato yyyyMMdd-HHmm.

• Valor devuelto: ninguno

cancelBackup Detiene el proceso de copia de seguridad actual y elimina el archivo temporal que el proceso creó para archivar datos.

• Argumentos: ninguno
• Valor devuelto: ninguno

blockRepositoryWrites Bloquea los cambios realizados en los datos del repositorio. El bloque se notifica a todos los agentes de escucha de copia de seguridad del repositorio.

• Argumentos: ninguno
• Valor devuelto: ninguno

unblockRepositoryWrites Quita el bloque del repositorio. La eliminación del bloque se notifica a todos los agentes de escucha de copia de seguridad del repositorio.

• Argumentos: ninguno
• Valor devuelto: ninguno

startTarOptimization Inicia el proceso de optimización del archivo TAR utilizando el valor predeterminado de tarOptimizationDelay.

• Argumentos: ninguno
• Valor devuelto: ninguno

stopTarOptimization Detiene la optimización de archivos TAR.

• Argumentos: ninguno
• Valor devuelto: ninguno

tarIndexMerge Combina los archivos de índice principales de todos los conjuntos TAR. Los archivos de índice principales son archivos con diferentes versiones principales. Por ejemplo, los siguientes archivos se combinan en el archivo index_3_1.tar: index_1_1.tar, index_2_0.tar, index_3_0.tar. Los archivos que se han combinado se eliminan (en el ejemplo anterior, se eliminan index_1_1.tar, index_2_0.tar e index_3_0.tar).

• Argumentos:

  • background: Valor booleano que indica si se debe ejecutar la operación en segundo plano para que la consola web se pueda utilizar durante la ejecución. El valor true ejecuta la operación en segundo plano.

• Valor devuelto: ninguno

beClusterMaster Establece este nodo de repositorio como el nodo maestro del clúster. Si no es así, este comando detiene el agente de escucha de la instancia maestra actual e inicia un agente de escucha maestro en el nodo actual. A continuación, este nodo se establece como nodo maestro y se reinicia, lo que provoca que todos los demás nodos del clúster (es decir, aquellos que están controlados por el nodo maestro) se conecten a esta instancia.

• Argumentos: ninguno
• Valor devuelto: ninguno

joinCluster Agrega este repositorio a un clúster como un nodo controlado por el maestro del clúster. Debe proporcionar un nombre de usuario y una contraseña para fines de autenticación. La conexión utiliza autenticación básica. Las credenciales de seguridad se codifican en base 64 antes de enviarse al servidor.

• Argumentos:

  • master: Valor de cadena que representa la dirección IP o el nombre de equipo del equipo que ejecuta el nodo del repositorio principal.
  • username: Nombre que se utilizará para autenticarse en el clúster.
  • password: Contraseña que se utilizará para la autenticación.

• Valor devuelto: ninguno

travversalCheck Recorre y, opcionalmente, corrige las incoherencias en un subárbol que comienza en un nodo específico. Esto se trata en detalle en la documentación sobre Administradores de persistencia.

consistencyCheck Comprueba y, opcionalmente, corrige la coherencia en el almacén de datos. Esto se trata en detalle en la documentación del almacén de datos.

Estadísticas del repositorio (TimeSeries)

El valor del campo Serie temporal para cada tipo de estadística que org.apache.jackrabbit.api.stats.RepositoryStatistics define.

• Dominio: com.adobe.granite

• Tipo: TimeSeries

• Nombre: uno de los siguientes valores de org.apache.jackrabbit.api.stats.RepositoryStatistics.Type Clase de enumeración:

  • BUNDLE_CACHE_ACCESS_COUNTER
  • BUNDLE_CACHE_MISS_AVERAGE
  • PAQUETE_CACHE_MISS_COUNTER
  • BUNDLE_CACHE_MISS_DURATION
  • BUNDLE_CACHE_SIZE_COUNTER
  • PAQUETE_CONTADOR
  • PAQUETE_READ_COUNTER
  • BUNDLE_WRITE_AVERAGE
  • PAQUETE_WRITE_COUNTER
  • BUNDLE_WRITE_DURATION
  • PAQUETE_WS_SIZE_COUNTER
  • QUERY_AVERAGE
  • QUERY_COUNT
  • QUERY_DURATION
  • SESSION_COUNT
  • SESSION_LOGIN_COUNTER
  • SESSION_READ_AVERAGE
  • SESSION_READ_COUNTER
  • SESSION_READ_DURATION
  • SESSION_WRITE_AVERAGE
  • SESSION_WRITE_COUNTER
  • SESSION_WRITE_DURATION

Atributos

Se proporcionan los atributos siguientes para cada tipo de estadística del que se informa:

• ValuePerSecond: valor medido por segundo en el último minuto. Solo lectura.
• ValuePerMinute: valor medido por minuto durante la última hora. Solo lectura.
• ValuePerHour: Valor medido por hora durante la última semana. Solo lectura.
• ValuePerWeek: valor medido por semana durante los últimos tres años. Solo lectura.

Estadísticas de consulta del repositorio

Información estadística sobre consultas del repositorio.

• Dominio: com.adobe.granite
• Tipo: QueryStat

Atributos

SlowQueries Información sobre las consultas del repositorio que han tardado más tiempo en completarse. Solo lectura.

SlowQueriesQueueSize Número máximo de consultas que se incluirán en la lista de consultas lentas. Lectura-escritura.

Consultas populares Información sobre las consultas del repositorio que más se han producido. Solo lectura.

PopularConsultasTamañoCola Número máximo de consultas en la lista Consultas populares. Lectura-escritura.

Operaciones

clearSlowQueriesQueue Quita todas las consultas de la lista de consultas lentas.

• Argumentos: ninguno
• Valor devuelto: ninguno

clearPopularQueriesQueue Quita todas las consultas de la lista Consultas populares.

• Argumentos: ninguno
• Valor devuelto: ninguno

Agentes de replicación

Supervise los servicios de cada agente de replicación. Al crear un agente de replicación, el servicio aparece automáticamente en la consola JMX.

• Dominio: com.adobe.granite.replication
• Tipo: agente
• Nombre: sin valor
• Propiedades: {id="Nombre"}, donde Nombre es el valor de la propiedad Nombre del agente.

Atributos

Id Valor de tipo String que representa el identificador de la configuración del agente de replicación. Varios agentes pueden utilizar la misma configuración. Solo lectura.

Válido Un valor booleano que indica si el agente está configurado correctamente:

• true: Configuración válida.
• false : la configuración contiene errores.

Solo lectura.

Habilitado Un valor booleano que indica si el agente está habilitado:

• true: Habilitado.
• false: Deshabilitado.

QueueBlocked Un valor booleano que indica si la cola existe y está bloqueada:

• true: Bloqueado. Está pendiente un reintento automático.
• false: No bloqueado o no existe.

Solo lectura.

QueuePaused Un valor booleano que indica si la cola de trabajos está en pausa:

• true: en pausa (suspendido)
• false: No está en pausa o no existe.

Lectura-escritura.

QueueNumEntries Valor int que representa el número de trabajos de la cola del agente. Solo lectura.

QueueStatusTime Valor de fecha que indica la hora del servidor en que se obtuvieron los valores de estado mostrados. El valor corresponde a la hora en que se cargó la página. Solo lectura.

QueueNextRetryTime Para colas bloqueadas, un valor Date que indica cuándo se produce el siguiente reintento automático. Cuando no aparece ningún tiempo, la cola no se bloquea. Solo lectura.

QueueProcessingSince Valor de fecha que indica cuándo comenzó el procesamiento del trabajo actual. Cuando no aparece ningún tiempo, la cola está bloqueada o inactiva. Solo lectura.

QueueLastProcessTime Valor de fecha que indica cuándo se completó el trabajo anterior. Solo lectura.

Operaciones

queueForceRetry Para colas bloqueadas, envía el comando retry a la cola.

• Argumentos: ninguno
• Valor devuelto: ninguno

queueClear Quita todos los trabajos de la cola.

• Argumentos: ninguno
• Valor devuelto: ninguno

Motor de Sling

Proporciona estadísticas sobre las solicitudes HTTP para que pueda supervisar el rendimiento del servicio SlingRequestProcessor.

• Dominio: org.apache.sling
• Tipo: motor
• Propiedades:

Atributos

RequestsCount El número de solicitudes que se han producido desde que se restablecieron las estadísticas por última vez.

MinRequestDurationMsec La cantidad de tiempo más corta (en milisegundos) que se requirió para procesar una solicitud desde que se restablecieron las estadísticas por última vez.

MaxRequestDurationMsec La cantidad de tiempo más larga (en milisegundos) necesaria para procesar una solicitud desde que se restablecieron las estadísticas por última vez.

StandardDeviationDurationMsec La desviación estándar de la cantidad de tiempo necesario para procesar solicitudes. La desviación estándar se calcula utilizando todas las solicitudes desde el último restablecimiento de las estadísticas.

MediaRequestDurationMsec Cantidad media de tiempo necesaria para procesar una solicitud. La media se calcula utilizando todas las solicitudes desde el último restablecimiento de las estadísticas

Operaciones

resetStatistics Establece todas las estadísticas en cero. Restablezca las estadísticas cuando necesite analizar el rendimiento del procesamiento de la solicitud durante un lapso de tiempo específico.

• Argumentos: ninguno
• Valor devuelto: ninguno

id La representación de cadena del ID del paquete.

instalado Un valor booleano que indica si el paquete está instalado:

• true: Instalado.
• false: No está instalado.

installBy El ID del usuario que instaló el paquete por última vez.

installationDate La fecha en la que se instaló el paquete por última vez.

talla Valor de tipo long que contiene el tamaño del paquete en bytes.

Lanzador rápido

Información sobre el proceso de inicio y el lanzador de inicio rápido.

• Dominio: com.adobe.granite.quickstart
• Tipo: lanzador

Operaciones

registro

Muestra un mensaje en la ventana Inicio rápido.

Argumentos:

• p1: A String valor que representa el mensaje que se va a mostrar.
• Valor devuelto: ninguno

startupFinished

Llama al método startupFinished del iniciador del servidor. El método intenta abrir la página de bienvenida en un explorador web.

• Argumentos: ninguno
• Valor devuelto: ninguno

startupProgress

Establece el valor de finalización del proceso de inicio del servidor. La barra de progreso de la ventana QuickStart representa el valor de finalización.

• Argumentos:
  • p1: Valor flotante que representa la parte completa del proceso de inicio, como fracción. El valor debe estar entre cero y uno. Por ejemplo, 0,3 indica que se ha completado el 30 %.
• Valor devuelto: ninguno.

Servicios de terceros

Varios recursos de servidor de terceros instalan MBeans que exponen atributos y operaciones a la consola JMX. En la siguiente tabla se enumeran los recursos de terceros y se proporcionan vínculos a más información.

Dominio	Tipo	Clase de MBean
Implementación JMI	MBeanServerDelegate	javax.management.MBeanServerDelegate
com.sun.management	HotSpotDiagnostic	com.sun.management.HotSpotDiagnosticMXBean
java.lang	ClassLoading Compilación GarbageCollector Memoria MemoryManager MemoryPool OperatingSystem Runtime Subprocesamiento	javax.management paquete
java.util.logging		java.util.logging.LoggingMXBean
osgi.core	bundleState marco packageState serviceState	org.osgi.jmx.framework paquete

Uso de la consola JMX

La consola JMX muestra información sobre varios servicios que se ejecutan en el servidor:

• Atributos: propiedades del servicio como configuraciones o datos en tiempo de ejecución. Los atributos pueden ser de solo lectura o de lectura-escritura.
• Operaciones: comandos que se pueden invocar en el servicio.

Los MBean que se implementan con un servicio OSGi exponen atributos y operaciones de servicio a la consola. El MBean determina los atributos y las operaciones que se exponen, y si los atributos son de sólo lectura o de lectura-escritura.

La página principal de la consola JMX incluye una tabla de servicios. Cada fila de la tabla representa un servicio que se expone mediante un MBean.

1. Abra la consola web y haga clic en la pestaña JMX. (http://localhost:4502/system/console/jmx)
2. Haga clic en un valor de celda de un servicio para ver sus atributos y operaciones.
3. Para cambiar un valor de atributo, haga clic en el valor, especifique el valor en el cuadro de diálogo que aparece y haga clic en Guardar.
4. Para invocar una operación de servicio, haga clic en el nombre de la operación, especifique valores de argumento en el cuadro de diálogo que aparece y haga clic en Invocar.

Uso de aplicaciones JMX externas para la monitorización

CRX permite que las aplicaciones externas interactúen con Managed Beans (MBeans) mediante Extensiones de administración de Java (JMX). Uso de consolas genéricas como JConsole o aplicaciones de monitorización específicas del dominio, permite obtener y establecer configuraciones y propiedades de CRX, así como monitorizar el rendimiento y el uso de recursos.

Usar JConsole para conectarse a CRX

Para conectarse a CRX mediante JConsole, siga estos pasos:

1. Abra una ventana de terminal.

2. Introduzca el siguiente comando:

   jconsole

JConsole se iniciará y aparecerá la ventana de JConsole.

Conectarse a un proceso CRX local

JConsole mostrará una lista de los procesos locales de la máquina virtual Java. La lista contendrá dos procesos de inicio rápido. Seleccione el proceso "CHILD" de inicio rápido de la lista de procesos locales (normalmente el que tiene el PID más alto).

Conectarse a un proceso CRX remoto

Para conectarse a un proceso CRX remoto, la JVM que aloja el proceso CRX remoto deberá estar habilitada para aceptar conexiones JMX remotas.

Para habilitar conexiones JMX remotas, se debe establecer la siguiente propiedad del sistema al iniciar la JVM:

com.sun.management.jmxremote.port=portNum

En la propiedad anterior, portNum es el número de puerto a través del cual desea habilitar conexiones JMX RMI. Asegúrese de especificar un número de puerto no utilizado. Además de publicar un conector RMI para acceso local, al establecer esta propiedad se publica un conector RMI adicional en un registro privado de sólo lectura en el puerto especificado con un nombre conocido, "jmxrmi".

De forma predeterminada, al habilitar el agente JMX para la monitorización remota, utiliza la autenticación de contraseña basada en un archivo de contraseña que debe especificarse mediante la siguiente propiedad del sistema al iniciar la VM de Java:

com.sun.management.jmxremote.password.file=pwFilePath

Consulte la documentación JMX relevante para obtener instrucciones detalladas sobre la configuración de un archivo de contraseña.

Ejemplo:

$ java
  -Dcom.sun.management.jmxremote.password.file=pwFilePath
  -Dcom.sun.management.jmxremote.port=8463
  -jar ./cq-quickstart.jar

Usar los MBeans proporcionados por CRX

Después de conectarse al proceso de inicio rápido, JConsole proporciona una serie de herramientas de monitorización generales para la JVM en la que CRX se está ejecutando.

Para acceder a las opciones de monitorización y configuración internas de CRX, vaya a la pestaña MBeans y, en el árbol de contenido jerárquico de la izquierda, seleccione la sección Attributes or Operations que le interese. Por ejemplo, la sección com.adobe.granite/Repository/Operations.

En esa sección, seleccione el atributo u operación que desee en el panel izquierdo.