Risorse del server di monitoraggio tramite la console JMX monitoring-server-resources-using-the-jmx-console

La console JMX consente di monitorare e gestire i servizi sul server CRX. Le sezioni seguenti riepilogano gli attributi e le operazioni esposti attraverso il framework JMX.

Per informazioni sull’utilizzo dei controlli della console, consulta Utilizzo della console JMX. Per informazioni di base su JMX, vedi Tecnologia Java Management Extensions (JMX) sul sito web dell'Oracle.

Per informazioni sulla creazione di MBeans per gestire i servizi utilizzando la console JMX, vedi Integrazione dei servizi con la console JMX.

Manutenzione del flusso di lavoro workflow-maintenance

Operazioni per l’amministrazione di istanze del flusso di lavoro in esecuzione, completate, obsolete e non riuscite.

Operazioni operations

listRunningWorkflowsPerModel Elenca il numero di istanze del flusso di lavoro in esecuzione per ciascun modello di flusso di lavoro.

listCompletedWorkflowsPerModel Elenca il numero di istanze del flusso di lavoro completate per ciascun modello di flusso di lavoro.

returnWorkflowQueueInfo Elenca informazioni sugli elementi del flusso di lavoro elaborati e in coda per l’elaborazione.

returnWorkflowJobTopicInfo Elenca le informazioni di elaborazione per i lavori del flusso di lavoro, organizzate per argomento.

returnFailedWorkflowCount Mostra il numero di istanze del flusso di lavoro che hanno avuto esito negativo. Puoi specificare un modello di flusso di lavoro per eseguire query o recuperare informazioni per tutti i modelli di flusso di lavoro.

returnFailedWorkflowCountPerModel Mostra il numero di istanze del flusso di lavoro che non sono riuscite per ciascun modello di flusso di lavoro.

terminateFailedInstances Termina le istanze del flusso di lavoro che non sono riuscite. È possibile terminare tutte le istanze non riuscite o solo le istanze non riuscite per un modello specifico. Facoltativamente è possibile riavviare le istanze dopo che sono state terminate. È inoltre possibile testare l'operazione per visualizzare i risultati senza eseguire effettivamente l'operazione.

tryFailedWorkItems Tentativi di eseguire passaggi di elementi di lavoro non riusciti. È possibile riprovare tutti gli elementi di lavoro non riusciti o solo gli elementi di lavoro non riusciti per un modello di flusso di lavoro specifico. Facoltativamente, è possibile testare l'operazione per visualizzare i risultati senza eseguire effettivamente l'operazione.

PurgeActive Rimuove le istanze del flusso di lavoro attivo di una pagina specifica. È possibile eliminare le istanze attive per tutti i modelli o solo per le istanze di un modello specifico. Facoltativamente, puoi testare l’operazione per visualizzare i risultati senza eseguire effettivamente l’operazione.

countStaleWorkflows Restituisce il numero di istanze del flusso di lavoro non aggiornate. Puoi recuperare il numero di istanze non aggiornate per tutti i modelli di flusso di lavoro o per un modello specifico.

riavvioStaleWorkflows Riavvia le istanze del flusso di lavoro non aggiornate. È possibile riavviare tutte le istanze obsolete o solo le istanze non aggiornate per un modello specifico. È inoltre possibile testare l'operazione per visualizzare i risultati senza eseguire effettivamente l'operazione.

fetchModelList Elenca tutti i modelli di flusso di lavoro.

countRunningWorkflows Restituisce il numero di istanze del flusso di lavoro in esecuzione. È possibile recuperare il numero di istanze in esecuzione per tutti i modelli di flusso di lavoro o per un modello specifico.

countCompletedWorkflows Restituisce il numero di istanze del flusso di lavoro completate. Puoi recuperare il numero di istanze completate per tutti i modelli di flusso di lavoro o per un modello specifico.

purgeCompleted Rimuove dall’archivio i record dei flussi di lavoro completati di una specifica età. Utilizza questa operazione periodicamente per ridurre al minimo le dimensioni dell’archivio quando utilizzi intensamente i flussi di lavoro. È possibile eliminare le istanze completate per tutti i modelli o solo per le istanze di un modello specifico. Facoltativamente, puoi testare l’operazione per visualizzare i risultati senza eseguire effettivamente l’operazione.

Archivio repository

Informazioni sull'archivio CRX

Attributi attributes

Nome Nome dell’implementazione dell’archivio JCR. Sola lettura.

Versione Versione di implementazione del repository. Sola lettura.

HomeDir La directory in cui si trova l'archivio. Il percorso predefinito è <quickstart_jar_location>/crx-quickstart/repository. Sola lettura.

NomeCliente Nome del cliente a cui viene rilasciata la licenza software. Sola lettura.

LicenseKey Chiave di licenza univoca per questa installazione dell'archivio. Sola lettura.

SpazioDiscoDisponibile Lo spazio su disco disponibile per questa istanza del repository, in Mbyte. Sola lettura.

MaximumNumberOfOpenFiles Il numero di file che è possibile aprire contemporaneamente. Sola lettura.

SessionTracker Il valore della variabile di sistema crx.debug.Sessions. true indica una sessione di debug. false indica una sessione normale. Lettura/scrittura.

Descrittori Un set di coppie chiave-valore che rappresentano le proprietà del repository. Tutte le proprietà sono di sola lettura.

NomiArea di lavoro Nomi delle aree di lavoro nell’archivio. Sola lettura.

DataStoreGarbageCollectionDelay La quantità di tempo in millisecondi che la raccolta di oggetti inattivi dorme dopo la scansione ogni decimo nodo. Lettura/scrittura.

Ritardo backup Il tempo in millisecondi impiegato dal processo di backup tra ciascun passaggio del backup. Lettura/scrittura.

BackupInProgress Il valore true indica che è in esecuzione un processo di backup. Sola lettura.

BackupProgress Per il backup corrente, la percentuale di tutti i file di cui è stato eseguito il backup. Sola lettura.

CurrentBackupTarget Per il backup corrente, il file ZIP in cui vengono archiviati i file di backup. Quando un backup non è in corso, non viene visualizzato alcun valore. Sola lettura.

BackupEraCompletato Il valore true indica che non si sono verificati errori durante il backup corrente o che non è in corso alcun backup. false indica un errore durante il backup corrente. Sola lettura.

BackupResult Lo stato del backup corrente. Sono possibili i seguenti valori:

Sola lettura.

TarOptimizationRunningSince Data di inizio del processo di ottimizzazione file TAR corrente. Sola lettura.

TarOptimizationDelay Il tempo in millisecondi impiegato dal processo di ottimizzazione TAR tra ciascun passaggio del processo. Lettura/scrittura.

ProprietàCluster Un insieme di coppie chiave-valore che rappresentano proprietà e valori del cluster. Ogni riga della tabella rappresenta una proprietà cluster. Sola lettura.

ClusterNodes I membri del cluster di repository.

ClusterId Identificatore del cluster di archivio. Sola lettura.

ClusterMasterId Identificatore del nodo principale del cluster di repository. Sola lettura.

ClusterNodeId Identificatore di questo nodo del cluster di repository. Sola lettura.

Operazioni operations-1

createWorkspace Crea un’area di lavoro in questo archivio.

runDataStoreGarbageCollection Esegue la raccolta degli oggetti inattivi sui nodi del repository.

stopDataStoreGarbageCollection Interrompe l'esecuzione della raccolta degli oggetti inattivi nell'archivio dati.

startBackup Esegue il backup dei dati dell'archivio in un file ZIP.

cancelBackup Arresta il processo di backup corrente ed elimina l'archivio temporaneo creato dal processo per l'archiviazione dei dati.

blockRepositoryWrites Blocca le modifiche ai dati del repository. Tutti i listener di backup dell'archivio vengono informati del blocco.

unblockRepositoryWrites Rimuove il blocco dall’archivio. Tutti i listener di backup dell'archivio vengono informati della rimozione del blocco.

startTarOptimization Avvia il processo di ottimizzazione dei file TAR utilizzando il valore predefinito per tarOptimizationDelay.

stopTarOptimization Interrompe l'ottimizzazione dei file TAR.

tarIndexMerge Unisce i file di indice principali di tutti i set TAR. I file di indice principali sono file con diverse versioni principali. Ad esempio, i file seguenti vengono uniti nel file index_3_1.tar: index_1_1.tar, index_2_0.tar, index_3_0.tar. I file che sono stati uniti vengono eliminati (nell'esempio precedente, index_1_1.tar, index_2_0.tar e index_3_0.tar vengono eliminati).

getClusterMaster Imposta questo nodo del repository come nodo principale del cluster. Se non è già master, questo comando arresta il listener dell'istanza master corrente e avvia un listener principale sul nodo corrente. Questo nodo viene quindi impostato come nodo principale e si riavvia, causando la connessione a questa istanza di tutti gli altri nodi del cluster (cioè quelli controllati dal master).

joinCluster Aggiunge questo archivio a un cluster come nodo controllato dal cluster master. Devi fornire un nome utente e una password a scopo di autenticazione. La connessione utilizza l’autenticazione di base. Le credenziali di protezione sono codificate in base 64 prima di essere inviate al server.

traversalCheck Passa e, facoltativamente, corregge le incongruenze in una sottostruttura che inizia in un nodo specifico. Questo è descritto in dettaglio nella documentazione sui Persistence Manager.

consistencyCheck Verifica e, facoltativamente, corregge la coerenza nel Datastore. Questo è descritto in dettaglio nella documentazione del Datastore.

Statistiche archivio (TimeSeries) repository-statistics-timeseries

Valore del campo TimeSeries per ogni tipo di statistica che org.apache.jackrabbit.api.stats.RepositoryStatistics definisce.

Attributi attributes-1

Per ogni tipo di statistica segnalato sono forniti i seguenti attributi:

Statistiche query archivio repository-query-stats

Informazioni statistiche sulle query del repository.

Attributi attributes-2

Query lente Informazioni sulle query del repository che hanno richiesto il tempo più lungo per essere completate. Sola lettura.

DimensioneCodaLenta Numero massimo di query da includere nell'elenco SlowQueries. Lettura/scrittura.

Query popolari Informazioni sulle query del repository che si sono verificate di più. Sola lettura.

PopularQueriesQueueSize Il numero massimo di query nell'elenco PopularQueries. Lettura/scrittura.

Operazioni operations-2

clearSlowQueriesQueue Rimuove tutte le query dall’elenco SlowQueries.

clearPopularQueriesQueue Rimuove tutte le query dall’elenco PopularQueries.

Agenti di replica replication-agents

Monitora i servizi per ogni agente di replica. Quando crei un agente di replica, il servizio viene visualizzato automaticamente nella console JMX.

Attributi attributes-3

Id Valore String che rappresenta l'identificatore della configurazione dell'agente di replica. Più agenti possono utilizzare la stessa configurazione. Sola lettura.

Valido Un valore booleano che indica se l’agente è configurato correttamente:

Sola lettura.

Abilitato Un valore booleano che indica se l’agente è abilitato:

QueueBlocked Un valore booleano che indica se la coda esiste ed è bloccata:

Sola lettura.

QueuePaused Un valore booleano che indica se la coda di lavoro è in pausa:

Lettura/scrittura.

QueueNumEntries Un valore int che rappresenta il numero di processi nella coda dell'agente. Sola lettura.

QueueStatusTime Valore Date che indica l'ora sul server in cui sono stati ottenuti i valori di stato visualizzati. Il valore corrisponde all’ora di caricamento della pagina. Sola lettura.

QueueNextRetryTime Per le code bloccate, un valore Date che indica quando si verifica il prossimo tentativo automatico. Quando non viene visualizzato alcun tempo, la coda non viene bloccata. Sola lettura.

QueueProcessingSince Valore Date che indica quando è iniziata l'elaborazione per il processo corrente. Quando non viene visualizzato il tempo, la coda è bloccata o inattiva. Sola lettura.

QueueLastProcessTime Valore Date che indica quando è stato completato il processo precedente. Sola lettura.

Operazioni operations-3

queueForceRetry Per le code bloccate, invia il comando di esecuzione di un nuovo tentativo alla coda.

queueClear Rimuove tutti i processi dalla coda.

Motore Sling sling-engine

Fornisce statistiche sulle richieste HTTP in modo da poter monitorare le prestazioni del servizio SlingRequestProcessor.

Attributi attributes-4

RequestsCount Il numero di richieste che si sono verificate dall'ultima reimpostazione delle statistiche.

MinRequestDurationMsec Il tempo più breve (in millisecondi) necessario per elaborare una richiesta dall'ultima reimpostazione delle statistiche.

MaxRequestDuratioMsec Il periodo di tempo più lungo (in millisecondi) necessario per elaborare una richiesta dall'ultima reimpostazione delle statistiche.

StandardDeviationDurationMsec Deviazione standard del tempo necessario per elaborare le richieste. La deviazione standard viene calcolata utilizzando tutte le richieste dall’ultima reimpostazione delle statistiche.

MediaRequestDurationMsec Il tempo medio necessario per elaborare una richiesta. La media viene calcolata utilizzando tutte le richieste dall’ultima reimpostazione delle statistiche

Operazioni operations-4

resetStatistics Imposta tutte le statistiche su zero. Reimposta le statistiche quando devi analizzare le prestazioni di elaborazione della richiesta durante un intervallo di tempo specifico.

Gestione pacchetti package-manager

Informazioni su tutti i pacchetti contenuti in Gestione pacchetti.

Avvio rapido quickstart-launcher

Informazioni sul processo di avvio e sul modulo di avvio rapido.

Operazioni operations-5

log

Visualizza un messaggio nella finestra QuickStart.

Argomenti:

startupFinished

Chiama il metodo startupFinished del server launcher. Il metodo tenta di aprire la pagina di benvenuto in un browser Web.

startupProgress

Imposta il valore di completamento del processo di avvio del server. La barra di avanzamento nella finestra QuickStart rappresenta il valore di completamento.

Servizi di terze parti third-party-services

Diverse risorse server di terze parti installano MBeans che espongono attributi e operazioni alla console JMX. Nella tabella seguente sono elencate le risorse di terze parti e sono disponibili collegamenti per ulteriori informazioni.

Utilizzo della console JMX using-the-jmx-console

La console JMX visualizza informazioni su diversi servizi in esecuzione sul server:

MBeans distribuiti con un servizio OSGi espone gli attributi e le operazioni del servizio alla console. MBean determina gli attributi e le operazioni esposti e se gli attributi sono di sola lettura o di lettura-scrittura.

La pagina principale della console JMX include una tabella dei servizi. Ogni riga della tabella rappresenta un servizio esposto da un MBean.

Utilizzo di applicazioni JMX esterne per il monitoraggio using-external-jmx-applications-for-monitoring

CRX consente alle applicazioni esterne di interagire con i Fagioli gestiti (MBeans) tramite Estensioni di gestione Java (JMX). Utilizzo di console generiche come JConsole o applicazioni di monitoraggio specifiche per il dominio, consente di ottenere e impostare configurazioni e proprietà CRX, così come il monitoraggio delle prestazioni e dell'utilizzo delle risorse.

Utilizzo di JConsole per connettersi a CRX using-jconsole-to-connect-to-crx

Per connettersi a CRX utilizzando JConsole, segui questi passaggi:

JConsole verrà avviato e verrà visualizzata la finestra JConsole.

Connessione a un processo CRX locale connecting-to-a-local-crx-process

JConsole visualizzerà un elenco dei processi Java Virtual Machine locali. L’elenco conterrà due processi quickstart. Seleziona il processo "CHILD" di avvio rapido dall'elenco dei processi locali (di solito quello con il PID più alto).

Connessione a un processo CRX remoto connecting-to-a-remote-crx-process

Per connettersi a un processo CRX remoto, la JVM che ospita il processo CRX remoto dovrà essere abilitata per accettare connessioni JMX remote.

Per abilitare le connessioni JMX remote, è necessario impostare la seguente proprietà di sistema all'avvio della JVM:

com.sun.management.jmxremote.port=portNum

Nella proprietà precedente, portNum è il numero di porta attraverso il quale si desidera abilitare le connessioni JMX RMI. Assicurati di specificare un numero di porta non utilizzato. Oltre a pubblicare un connettore RMI per l'accesso locale, l'impostazione di questa proprietà pubblica un connettore RMI aggiuntivo in un registro di sola lettura privato alla porta specificata utilizzando un nome noto, "jmxrmi".

Per impostazione predefinita, quando si abilita l'agente JMX per il monitoraggio remoto, utilizza l'autenticazione tramite password basata su un file di password che deve essere specificato utilizzando la seguente proprietà di sistema all'avvio della Java VM:

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

Consulta la sezione documentazione JMX pertinente per istruzioni dettagliate sulla configurazione di un file password.

Esempio:

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

Utilizzo dei MBeans forniti da CRX using-the-mbeans-provided-by-crx

Dopo aver effettuato il collegamento al processo quickstart, JConsole fornisce una serie di strumenti di monitoraggio generali per la JVM in cui CRX è in esecuzione.

Per accedere alle opzioni di monitoraggio e configurazione interne di CRX, vai alla scheda MBeans e, dalla struttura dei contenuti gerarchici a sinistra, seleziona la sezione Attributi o operazioni a cui sei interessato. Ad esempio, la sezione com.adobe.granite/Repository/Operations .

All’interno di tale sezione, seleziona l’attributo o l’operazione desiderati nel riquadro a sinistra.