Überwachen von Server-Ressourcen mit der JMX-Konsole monitoring-server-resources-using-the-jmx-console

Mit der JMX-Konsole können Sie Dienste auf dem CRX-Server überwachen und verwalten. In den folgenden Abschnitten werden die Attribute und Vorgänge zusammengefasst, die über das JMX-Framework verfügbar sind.

Weitere Informationen zur Nutzung der Konsolensteuerung finden Sie unter Verwenden der JMX-Konsole. Hintergrundinformationen zu JMX finden Sie auf der Seite zu Java Management Extensions (JMX)-Technologie auf der Website von Oracle.

Informationen zum Erstellen von MBeans für die Verwaltung Ihrer Dienste mithilfe der JMX-Konsole finden Sie unter Integration von Diensten in die JMX-Konsole.

Workflow-Wartung workflow-maintenance

Vorgänge für die Verwaltung von laufenden, abgeschlossenen, veralteten und fehlgeschlagenen Workflow-Instanzen.

Betrieb operations

listRunningWorkflowsPerModel: Führt die Anzahl an Workflow-Instanzen auf, die für jedes Workflow-Modell ausgeführt werden.

listCompletedWorkflowsPerModel: Führt die Anzahl an abgeschlossenen Workflow-Instanzen für jedes Workflow-Modell auf.

returnWorkflowQueueInfo: Zeigt Informationen zu Workflow-Elementen an, die bearbeitet wurden und sich in der Warteschlange für die Verarbeitung befinden.

returnWorkflowJobTopicInfo: Zeigt Verarbeitungsinformationen für Workflow-Aufträge nach Themen geordnet an.

returnFailedWorkflowCount: Führt die Anzahl an fehlgeschlagenen Workflow-Instanzen auf. Sie können ein Workflow-Modell für die Abfrage angeben oder Informationen für alle Workflow-Modelle abrufen.

returnFailedWorkflowCountPerModel: Führt die Anzahl an Workflow-Instanzen auf, die für jedes Workflow-Modell fehlgeschlagen sind.

terminateFailedInstances: Beendet Workflows, die fehlgeschlagen sind. Sie können alle fehlgeschlagenen Instanzen oder nur die fehlgeschlagenen Instanzen für ein bestimmtes Modell beenden. Optional können Sie die Instanzen nach Beendigung neu starten. Sie können den Vorgang auch testen, um die Ergebnisse anzuzeigen, ohne den Vorgang tatsächlich durchzuführen.

retryFailedWorkItems: Versucht, fehlgeschlagene Arbeitselementschritte auszuführen. Sie können alle fehlgeschlagenen Arbeitselemente erneut ausführen lassen oder nur die fehlgeschlagenen Arbeitselemente für ein bestimmtes Workflow-Modell. Optional können Sie den Vorgang testen, um die Ergebnisse zu sehen, ohne den Vorgang tatsächlich durchzuführen.

PurgeActive: Entfernt aktive Workflow-Instanzen eines bestimmten Alters. Sie können aktive Instanzen für alle Modelle bereinigen oder nur die Instanzen für ein bestimmtes Modell. Optional können Sie den Vorgang testen, um die Ergebnisse zu sehen, ohne den Vorgang tatsächlich durchzuführen.

countStaleWorkflows: Gibt die Anzahl an veralteten Workflow-Instanzen zurück. Sie können die Anzahl der veralteten Instanzen für alle Workflow-Modelle oder für ein bestimmtes Modell abrufen.

restartStaleWorkflows: Startet veraltete Workflow-Instanzen neu. Sie können alle veralteten Instanzen oder nur die veralteten Instanzen für ein bestimmtes Modell neu starten. Sie können den Vorgang auch testen, um die Ergebnisse anzuzeigen, ohne den Vorgang tatsächlich durchzuführen.

fetchModelList: Führt alle Workflow-Modelle auf.

countRunningWorkflows: Gibt die Anzahl an laufenden Workflow-Instanzen zurück. Sie können die Anzahl der laufenden Instanzen für alle Workflow-Modelle oder für ein bestimmtes Modell abrufen.

countCompletedWorkflows: Gibt die Anzahl an abgeschlossenen Workflow-Instanzen zurück. Sie können die Anzahl der abgeschlossenen Instanzen für alle Workflow-Modelle oder für ein bestimmtes Modell abrufen.

purgeCompleted: Entfernt Datensätze von abgeschlossenen Workflows eines bestimmten Alters aus dem Repository. Wenn Sie häufig Workflows verwenden, verringern Sie mit diesem Vorgang regelmäßig die Größe des Repositorys. Sie können abgeschlossene Instanzen für alle Modelle bereinigen oder nur die Instanzen für ein bestimmtes Modell. Optional können Sie den Vorgang testen, um die Ergebnisse zu sehen, ohne den Vorgang tatsächlich durchzuführen.

Repository repository

Informationen zum CRX-Repository

Attribute attributes

Name: Der Name der JCR-Repository-Implementierung. Schreibgeschützt.

Version: Die Repository-Implementierungsversion. Schreibgeschützt.

HomeDir: Das Verzeichnis, in dem sich das Repository befindet. Der standardmäßige Speicherort ist <QuickStart_Jar_Location>/crx-quickstart/repository. Schreibgeschützt.

CustomerName: Der Name der Kundschaft, für die die Softwarelizenz ausgegeben wurde. Schreibgeschützt.

LicenseKey: Der eindeutige Lizenzschlüssel für diese Installation des Repositorys. Schreibgeschützt.

AvailableDiskSpace: Der Festplatten-Speicherplatz, der für diese Instanz des Repositorys verfügbar ist, in MB. Schreibgeschützt.

MaximumNumberOfOpenFiles: Die Anzahl an Dateien, die gleichzeitig geöffnet werden können. Schreibgeschützt.

SessionTracker: Der Wert der Systemvariablen „crx.debug.sessions“. Der Wert „true“ steht für eine Debugging-Sitzung. Der Wert „false“ steht für eine normale Sitzung. Lese- und Schreibzugriff.

Descriptors: Ein Satz an Schlüsselwertpaaren, die für Repository-Eigenschaften stehen. Alle Eigenschaften sind schreibgeschützt.

WorkspaceNames: Die Namen der Workspaces im Repository. Schreibgeschützt.

DataStoreGarbageCollectionDelay: Die Zeitdauer in Millisekunden, wie lange die Speicherbereinigung nach dem Scannen jedes zehnten Knotens ruht. Lese- und Schreibzugriff.

BackupDelay: Die Zeitdauer in Millisekunden, wie lange der Backup-Vorgang nach jedem Backup-Schritt ruht. Lese- und Schreibzugriff.

BackupInProgress: Der Wert „true“ bedeutet, dass gerade ein Backup-Vorgang ausgeführt wird. Schreibgeschützt.

BackupProgress: Der Prozentsatz aller Dateien, die beim aktuellen Backup gesichert wurden. Schreibgeschützt.

CurrentBackupTarget: Die ZIP-Datei, in der die Backup-Dateien des aktuellen Backups gespeichert werden. Wenn gerade kein Backup durchgeführt wird, wird kein Wert angezeigt. Schreibgeschützt.

BackupWasSuccessful: Der Wert „true“ bedeutet, dass beim aktuellen Backup keine Fehler aufgetreten sind oder dass gerade kein Backup durchgeführt wird. false zeigt an, dass während der aktuellen Sicherung ein Fehler aufgetreten ist. Schreibgeschützt.

BackupResult: Der Status des aktuellen Backups. Die folgenden Werte sind möglich:

Schreibgeschützt.

TarOptimizationRunningSince: Die Uhrzeit, zu der der aktuelle Vorgang der Optimierung der TAR-Datei begonnen hat. Schreibgeschützt.

TarOptimizationDelay: Die Zeitdauer in Millisekunden, wie lange der Vorgang der Optimierung der TAR-Datei nach jedem Schritt ruht. Lese- und Schreibzugriff.

ClusterProperties: Ein Satz an Schlüsselwertpaaren, die für Cluster-Eigenschaften und -Werte stehen. Jede Zeile in der Tabelle stellt eine Cluster-Eigenschaft dar. Schreibgeschützt.

ClusterNodes: Die Mitglieder des Repository-Clusters.

ClusterId: Die ID dieses Repository-Clusters. Schreibgeschützt.

ClusterMasterId: Die ID des Master-Knotens dieses Repository-Clusters. Schreibgeschützt.

ClusterNodeId: Die ID dieses Knotens des Repository-Clusters. Schreibgeschützt.

Betrieb operations-1

createWorkspace: Legt einen Workspace in diesem Repository an.

runDataStoreGarbageCollection: Führt die Speicherbereinigung auf den Repository-Knoten durch.

stopDataStoreGarbageCollection: Hält eine gerade ausgeführte Datenspeicherbereinigung an.

startBackup: Sichert Repository-Daten in einer ZIP-Datei.

cancelBackup: Hält den aktuellen Backup-Vorgang an und löscht das temporäre Archiv, das der Vorgang für die Archivierung der Daten erstellt hatte.

blockRepositoryWrites: Blockiert Änderungen an den Repository-Daten. Alle Backup-Listener des Repositorys werden über den Block benachrichtigt.

unblockRepositoryWrites: Hebt die Blockierung des Repositorys auf. Alle Backup-Listener des Repositorys werden über die Entfernung des Blocks informiert.

startTarOptimization: Startet den Vorgang zur Optimierung der TAR-Datei mit dem Standardwert für tarOptimizationDelay.

stopTarOptimization: Hält die Optimierung der TAR-Datei an.

tarIndexMerge: Führt die höchsten Indexdateien aller TAR-Sets zusammen. Die höchsten Indexdateien sind Dateien mit unterschiedlichen Hauptversionen. Beispielsweise werden die folgenden Dateien in der Datei index_3_1.tar zusammengeführt: index_1_1.tar, index_2_0.tar, index_3_0.tar. Die zusammengeführten Dateien werden gelöscht (im vorherigen Beispiel sind das die Dateien index_1_1.tar, index_2_0.tar und index_3_0.tar).

becomeClusterMaster: Legt diesen Repository-Knoten als Master-Knoten des Clusters fest. Wenn er nicht bereits Master ist, hält dieser Befehl den Listener der aktuellen Master-Instanz an und startet einen Master-Listener auf dem aktuellen Knoten. Dieser Knoten wird dann als Master-Knoten festgelegt und neu gestartet, wodurch alle anderen Knoten im Cluster (d. h. die vom Master-Knoten gesteuerten Knoten) eine Verbindung zu dieser Instanz herstellen.

joinCluster Fügt dieses Repository einem Cluster als Knoten hinzu, der vom Cluster-Master gesteuert wird. Sie müssen einen Benutzernamen und ein Kennwort für Authentifizierungszwecke angeben. Die Verbindung verwendet eine einfache Authentifizierung. Die Sicherheitsberechtigungen sind Base-64-kodiert, bevor sie an den Server gesendet werden.

traversalCheck: Durchläuft und behebt ggf. Inkonsistenzen in einer Unterstruktur, beginnend bei einem bestimmten Knoten. Ausführliche Informationen hierzu finden Sie in der Dokumentation zu Persistenz-Managern.

consistencyCheck: Überprüft und behebt ggf. Inkonsistenzen im Datenspeicher. Ausführliche Informationen hierzu finden Sie in der Dokumentation zum Datenspeicher.

Repository-Statistiken (TimeSeries) repository-statistics-timeseries

Der Wert des TimeSeries-Feldes für jeden Statistiktyp, den org.apache.jackrabbit.api.stats.RepositoryStatistics definiert.

Attribute attributes-1

Für jeden berichteten Statistiktyp werden die folgenden Attribute bereitgestellt:

Repository-Abfragestatistiken repository-query-stats

Statistische Informationen zu Repository-Abfragen.

Attribute attributes-2

SlowQueries: Informationen zu den Repository-Abfragen, deren Abschluss am längsten gedauert hat. Schreibgeschützt.

SlowQueriesQueueSize: Die maximale Anzahl an Abfragen, die in der SlowQueries-Liste enthalten sein sollen. Lese- und Schreibzugriff.

PopularQueries: Informationen zu den Repository-Abfragen, die am häufigsten durchgeführt wurden. Schreibgeschützt.

PopularQueriesQueueSize: Die Höchstzahl an Abfragen in der PopularQueries-Liste. Lese- und Schreibzugriff.

Betrieb operations-2

clearSlowQueriesQueue: Entfernt alle Abfragen aus der SlowQueries-Liste.

clearPopularQueriesQueue: Entfernt alle Abfragen aus der PopularQueries-Liste.

Replikations-Agenten replication-agents

Überwachen Sie die Dienste für jeden Replikationsagenten. Wenn Sie einen Replikationsagenten erstellen, wird der Dienst automatisch in der JMX-Konsole angezeigt.

Attribute attributes-3

Id: Ein Zeichenfolgenwert, der für die ID der Konfiguration des Replikationsagenten steht. Mehrere Agenten können dieselbe Konfiguration verwenden. Schreibgeschützt.

Valid: Ein boolescher Wert, der angibt, ob der Agent korrekt konfiguriert ist:

Schreibgeschützt.

Enabled: Ein boolescher Wert, der angibt, ob der Agent aktiviert ist:

QueueBlocked: Ein boolescher Wert, der angibt, ob die Warteschlange vorhanden und blockiert ist:

Schreibgeschützt.

QueuePaused: Ein boolescher Wert, der angibt, ob die Auftragswarteschlange angehalten wurde:

Lese- und Schreibzugriff.

QueueNumEntries: Ein int-Wert, der für die Anzahl an Aufträgen in der Agentenwarteschlange steht. Schreibgeschützt.

QueueStatusTime: Ein Date-Wert, der die Zeit auf dem Server angibt, zu der die angezeigten Statuswerte abgerufen wurden. Der Wert entspricht dem Zeitpunkt, zu dem die Seite geladen wurde. Schreibgeschützt.

QueueNextRetryTime: Ein Date-Wert, der für blockierte Warteschlangen angibt, wann der nächste automatische erneute Versuch stattfindet. Wenn keine Zeit angezeigt wird, wird die Warteschlange nicht blockiert. Schreibgeschützt.

QueueProcessingSince: Ein Date-Wert, der angibt, wann die Verarbeitung für den aktuellen Auftrag begonnen hat. Wenn keine Zeit angezeigt wird, ist die Warteschlange entweder blockiert oder inaktiv. Schreibgeschützt.

QueueLastProcessTime: Ein Date-Wert, der angibt, wann der vorhergehende Auftrag abgeschlossen wurde. Schreibgeschützt.

Betrieb operations-3

queueForceRetry: Gibt bei blockierten Warteschlangen den Befehl zum erneuten Versuch an die Warteschlange aus.

queueClear: Entfernt alle Aufträge aus der Warteschlange.

Sling-Engine sling-engine

Stellt Statistiken zu HTTP-Anforderungen bereit, damit Sie die Leistung des SlingRequestProcessor-Dienstes überwachen können.

Attribute attributes-4

RequestsCount: Die Anzahl an Abfragen, die seit dem letzten Zurücksetzen der Statistiken erfolgt sind.

MinRequestDurationMsec: Die kürzeste Zeitdauer (in Millisekunden), die für die Verarbeitung einer Abfrage seit dem letzten Zurücksetzen der Statistiken erforderlich war.

MaxRequestDuratioMsec: Die längste Zeitdauer (in Millisekunden), die für die Verarbeitung einer Abfrage seit dem letzten Zurücksetzen der Statistiken erforderlich war.

StandardDeviationDurationMsec: Die Standardabweichung von der Zeitdauer, die für die Verarbeitung von Abfragen erforderlich war. Diese Standardabweichung wird basierend auf allen Abfragen seit dem letzten Zurücksetzen der Statistiken ermittelt.

MeanRequestDurationMsec: Die Standardabweichung von der Zeitdauer, die für die Verarbeitung von Abfragen erforderlich war. Dieser Durchschnitt wird basierend auf allen Abfragen seit dem letzten Zurücksetzen der Statistiken ermittelt.

Betrieb operations-4

resetStatistics: Setzt alle Statistiken auf null zurück. Setzen Sie die Statistiken zurück, wenn Sie die Leistung der Anforderungsverarbeitung während eines bestimmten Zeitraums analysieren müssen.

Package Manager package-manager

Informationen zu allen Paketen, die Package Manager enthält.

Schnellstart-Starter quickstart-launcher

Informationen zum Startprozess und zum Schnellstart-Starter.

Betrieb operations-5

log

Zeigt eine Meldung im QuickStart-Fenster an.

Argumente:

startupFinished

Ruft die Methode startupFinished des Server-Starters auf. Die -Methode versucht, die Begrüßungsseite in einem Webbrowser zu öffnen.

startupProgress

Legt den Abschlusswert des Serverstartprozesses fest. Die Fortschrittsleiste im QuickStart-Fenster stellt den Abschlusswert dar.

Drittanbieterdienste third-party-services

Mehrere Serverressourcen von Drittanbietern installieren MBeans, die Attribute und Vorgänge der JMX-Konsole offenlegen. In der folgenden Tabelle sind die Drittanbieterressourcen aufgeführt und Links zu weiteren Informationen aufgeführt.

Verwenden der JMX-Konsole using-the-jmx-console

Die JMX-Konsole zeigt Informationen zu mehreren Diensten an, die auf dem Server ausgeführt werden:

MBeans, die mit einem OSGi-Dienst bereitgestellt werden, übermitteln Dienstattribute und Vorgänge an die Konsole. Das MBean legt fest, welche Attribute und Vorgänge übermittelt werden und ob sie schreibgeschützt oder mit Lese- und Schreibzugriff versehen sind.

Die Hauptseite der JMX-Konsole enthält eine Tabelle der Dienste. Jede Zeile in der Tabelle stellt einen Dienst dar, der von einem MBean bereitgestellt wird.

Verwenden externer JMX-Anwendungen zur Überwachung using-external-jmx-applications-for-monitoring

CRX ermöglicht es externen Anwendungen, mit Managed Beans (MBeans) über Java Management Extensions (JMX). Mit allgemeinen Konsolen wie JConsole oder Domain-spezifischen Überwachungsanwendungen können Sie CRX-Konfigurationen und -Eigenschaften abrufen und festlegen sowie die Leistung und Ressourcenauslastung überwachen.

Verwenden von JConsole zur Verbindung mit CRX using-jconsole-to-connect-to-crx

Gehen Sie wie folgt vor, um über JConsole eine Verbindung zu CRX herzustellen:

JConsole wird gestartet und das JConsole-Fenster wird angezeigt.

Herstellen einer Verbindung zu einem lokalen CRX-Prozess connecting-to-a-local-crx-process

JConsole zeigt eine Liste lokaler Java Virtual Machine-Prozesse an. Die Liste enthält zwei Schnellstartprozesse. Wählen Sie den Schnellstart-Prozess "CHILD"aus der Liste der lokalen Prozesse aus (normalerweise der mit der höheren PID).

Herstellen einer Verbindung zu einem Remote-CRX-Prozess connecting-to-a-remote-crx-process

Um eine Verbindung zu einem Remote-CRX-Prozess herzustellen, muss die JVM, die den Remote-CRX-Prozess hostet, aktiviert sein, damit sie Remote-JMX-Verbindungen akzeptieren kann.

Um externe JMX-Verbindungen zu aktivieren, müssen Sie beim Starten der JVM die folgende Systemeigenschaft festlegen:

com.sun.management.jmxremote.port=portNum

In der o. g. Eigenschaft steht portNum für die Nummer des Ports, für den JMX-RMI-Verbindungen aktiviert werden sollen. Stellen Sie sicher, dass Sie eine nicht verwendete Anschlussnummer angeben. Durch Festlegen dieser Eigenschaft wird nicht nur ein RMI-Connector für den lokalen Zugriff veröffentlicht, sondern auch ein zusätzlicher RMI-Connector in einer privaten schreibgeschützten Registrierung am angegebenen Port veröffentlicht, wobei der bekannte Name "jmxrmi"verwendet wird.

Wenn Sie den JMX-Agenten für die Remote-Überwachung aktivieren, verwendet er standardmäßig die Kennwortauthentifizierung basierend auf einer Kennwortdatei, die beim Starten der Java VM mit der folgenden Systemeigenschaft angegeben werden muss:

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

Detaillierte Anweisungen zum Einrichten einer Kennwortdatei finden Sie in der relevanten JMX-Dokumentation.

Beispiel:

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

Verwenden der von CRX bereitgestellten MBeans using-the-mbeans-provided-by-crx

Nach der Verbindung zum Schnellstartprozess stellt JConsole eine Reihe allgemeiner Überwachungstools für die JVM bereit, in der CRX ausgeführt wird.

Um auf die internen Überwachungs- und Konfigurationsoptionen von CRX zuzugreifen, gehen Sie zur Registerkarte MBeans und wählen Sie links in der hierarchischen Inhaltsstruktur den Bereich Attribute oder Vorgänge aus, den Sie interessieren. Beispiel: Abschnitt com.adobe.granite/Repository/Operations .

Wählen Sie in diesem Abschnitt das gewünschte Attribut oder den gewünschten Vorgang im linken Bereich aus.