Vorgangs-Dashboard

Einführung

Das Vorgangs-Dashboard in AEM 6 hilft Systembetreibern, den Systemzustand AEM Systems auf einen Blick zu überwachen. Darüber hinaus stellt es automatisch generierte Diagnoseinformationen zu relevanten Aspekten der AEM bereit und ermöglicht Ihnen, eigenständige Wartungsautomatisierung zu konfigurieren und durchzuführen, um Projektvorgänge und Supportfälle erheblich zu reduzieren. Das Vorgangs-Dashboard kann mit benutzerdefinierten Konsistenzprüfungen und Wartungsaufgaben erweitert werden. Darüber hinaus ist der Zugriff auf die Daten des Vorgangs-Dashboards über externe Überwachungstools über JMX möglich.

Das Vorgangs-Dashboard:

  • Ist ein Systemstatus mit einem Klick, der Abteilungen bei der Effizienz unterstützt
  • stellt einen zentralen Überblick über die Systemkonsistenz bereit
  • Verringert die Zeit zum Suchen, Analysieren und Beheben von Problemen
  • Bietet eine eigenständige Wartungsautomatisierung, mit der die Kosten für den Projektbetrieb erheblich gesenkt werden können

Sie können auf dem AEM-Begrüßungsbildschirm über Tools > Vorgänge auf das Dashboard zugreifen.

HINWEIS

Um auf das Vorgangs-Dashboard zugreifen zu können, muss der angemeldete Benutzer Teil der Benutzergruppe "Benutzer"sein. Weitere Informationen finden Sie in der Dokumentation zu Verwaltung von Benutzern, Gruppen und Zugriffsrechten.

Konsistenzberichte

Das Health Report System stellt über Sling-Konsistenzprüfungen Informationen zum Zustand einer AEM Instanz bereit. Sie erreichen diesen Vorgang entweder über OSGi-, JMX-, HTTP-Anfragen (über JSON) oder über die Touch-Benutzeroberfläche. Es bietet Messungen und Schwellenwerte für bestimmte konfigurierbare Zähler und bietet manchmal Informationen zur Lösung des Problems.

Es umfasst mehrere Funktionen, die unten beschrieben werden.

Konsistenzprüfungen

Die Konsistenzberichte sind ein System von Karten, die einen guten oder schlechten Gesundheitszustand in einem bestimmten Produktbereich anzeigen. Diese Karten sind Visualisierungen der Sling-Konsistenzprüfungen, die Daten aus JMX und anderen Quellen aggregieren und verarbeitete Informationen erneut als MBeans verfügbar machen. Diese MBeans können auch im JMX-Webkonsoleunter org.apache.sling.healthcheck Domäne.

Sie können auf dem AEM-Willkommensbildschirm über das Menü Tools > Vorgänge > Konsistenzberichte oder über die folgende URL auf die Konsistenzberichte zugreifen:

https://<serveraddress>:port/libs/granite/operations/content/healthreports/healthreportlist.html

chlimage_1-116

Das Kartensystem umfasst drei mögliche Status: OK, WARNUNG und KRITISCH. Diese Statusanzeigen sind das Ergebnis von Regeln und Schwellenwerten. Um diese zu konfigurieren, bewegen Sie den Mauszeiger über die Karte und klicken Sie auf das Zahnradsymbol in der Aktionsleiste:

chlimage_1-117

Konsistenzprüfungstypen

Es gibt zwei Arten von Konsistenzprüfungen in AEM 6:

  1. Individuelle Konsistenzprüfungen
  2. Verbund-Konsistenzprüfungen

Ein Individuelle Konsistenzprüfung ist eine einzelne Konsistenzprüfung, die einer Statuskarte entspricht. Individuelle Konsistenzprüfungen können mit Regeln oder Schwellenwerten konfiguriert werden und können einen oder mehrere Hinweise und Links zur Lösung identifizierter Gesundheitsprobleme bereitstellen. Nehmen wir als Beispiel die Prüfung "Fehler protokollieren": Wenn die Instanzprotokolle FEHLER enthalten, finden Sie diese auf der Detailseite der Konsistenzprüfung. Oben auf der Seite sehen Sie einen Link zum Analyzer "Log Message" im Abschnitt Diagnose-Tools , mit dem Sie diese Fehler detaillierter analysieren und die Logger neu konfigurieren können.

A Composite Health Check ist eine Prüfung, die Informationen aus mehreren individuellen Prüfungen aggregiert.

Verbund-Konsistenzprüfungen werden mithilfe von Filter-Tags. Im Wesentlichen werden alle einzelnen Prüfungen mit demselben Filter-Tag als Verbund-Konsistenzprüfung gruppiert. Eine Verbund-Konsistenzprüfung hat nur dann den Status "OK", wenn alle einzelnen Prüfungen, die sie aggregiert, auch OK-Status aufweisen.

Erstellen von Konsistenzprüfungen

Im Vorgangs-Dashboard können Sie das Ergebnis von individuellen und zusammengesetzten Konsistenzprüfungen visualisieren.

Erstellen einer individuellen Konsistenzprüfung

Die Erstellung einer individuellen Konsistenzprüfung umfasst zwei Schritte: Implementierung einer Sling-Konsistenzprüfung und Hinzufügen eines Eintrags für die Konsistenzprüfung in den Konfigurationsknoten des Dashboards.

  1. Um eine Sling-Konsistenzprüfung zu erstellen, erstellen Sie eine OSGi-Komponente, die die Sling HealthCheck-Schnittstelle implementiert. Fügen Sie diese Komponente in einem Bundle hinzu. Die Eigenschaften der Komponente identifizieren die Konsistenzprüfung vollständig. Nachdem die Komponente installiert wurde, wird automatisch ein JMX MBean für die Konsistenzprüfung erstellt. Siehe Dokumentation zur Sling-Konsistenzprüfung für weitere Informationen.

    Beispiels einer Sling-Konsistenzprüfungs-Komponente, mit OSGi-Dienstkomponenten-Anmerkungen geschrieben:

    @Component(service = HealthCheck.class,
    property = {
        HealthCheck.NAME + "=Example Check",
        HealthCheck.TAGS + "=example",
        HealthCheck.TAGS + "=test",
        HealthCheck.MBEAN_NAME + "=exampleHealthCheckMBean"
    })
     public class ExampleHealthCheck implements HealthCheck {
        @Override
        public Result execute() {
            // health check code
        }
     }
    
    HINWEIS

    Die MBEAN_NAME -Eigenschaft definiert den Namen des MBean, das für diese Konsistenzprüfung generiert wird.

  2. Nach der Erstellung einer Konsistenzprüfung muss ein neuer Konfigurationsknoten erstellt werden, damit er über die Oberfläche des Vorgangs-Dashboards zugänglich ist. Für diesen Schritt müssen Sie den JMX-MBean-Namen der Konsistenzprüfung kennen (die Eigenschaft MBEAN_NAME). Um eine Konfiguration für die Konsistenzprüfung zu erstellen, öffnen Sie CRXDE und fügen Sie einen Knoten (vom Typ nt:unstructured) unter dem folgenden Pfad: /apps/settings/granite/operations/hc

    Legen Sie die folgenden Eigenschaften für den neuen Knoten fest:

    • Name: sling:resourceType

      • Typ: String
      • Wert: granite/operations/components/mbean
    • Name: resource

      • Typ: String
      • Wert: /system/sling/monitoring/mbeans/org/apache/sling/healthcheck/HealthCheck/exampleHealthCheck
    HINWEIS

    Der o. g. Ressourcenpfad wird wie folgt erstellt: Wenn der MBean-Name der Konsistenzprüfung „test“ ist, fügen Sie am Ende des Pfads /system/sling/monitoring/mbeans/org/apache/sling/healthcheck/HealthCheck „test“ hinzu.

    Der endgültige Pfad lautet also:

    /system/sling/monitoring/mbeans/org/apache/sling/healthcheck/HealthCheck/test

    HINWEIS

    Stellen Sie sicher, dass beim Pfad /apps/settings/granite/operations/hc für die folgenden Eigenschaften „true“ festgelegt ist:

    sling:configCollectionInherit

    sling:configPropertyInherit

    Dieser Prozess weist den Konfigurationsmanager an, die neuen Konfigurationen mit den vorhandenen aus zusammenzuführen /libs.

Erstellen einer Verbund-Konsistenzprüfung

Die Rolle einer Verbund-Konsistenzprüfung besteht darin, mehrere individuelle Konsistenzprüfungen mit einer Reihe gemeinsamer Funktionen zu aggregieren. Beispielsweise gruppiert die Security Composite Health Check alle individuellen Konsistenzprüfungen, die sicherheitsbezogene Überprüfungen durchführen. Der erste Schritt zum Erstellen einer zusammengesetzten Prüfung besteht darin, eine OSGi-Konfiguration hinzuzufügen. Damit er im Vorgangs-Dashboard angezeigt wird, muss ein neuer Konfigurationsknoten auf die gleiche Weise hinzugefügt werden wie eine einfache Prüfung.

  1. Wechseln Sie zum Web-Konfigurations-Manager in der OSGi-Konsole. Zugriff https://serveraddress:port/system/console/configMgr

  2. Suchen Sie nach dem Eintrag namens Apache Sling Composite Health Check. Beachten Sie nach der Suche, dass bereits zwei Konfigurationen verfügbar sind: eine für die Systemprüfungen und eine andere für die Sicherheitsprüfungen.

  3. Erstellen Sie eine Konfiguration, indem Sie auf die Schaltfläche "+" rechts in der Konfiguration klicken. Ein neues Fenster wird wie unten gezeigt angezeigt:

    chlimage_1-23

  4. Erstellen Sie eine Konfiguration und speichern Sie sie. Ein MBean wird mit der neuen Konfiguration erstellt.

    Der Zweck jeder Konfigurationseigenschaft lautet wie folgt:

    • Name (hc.name): Der Name der Verbund-Konsistenzprüfung. Es wird ein aussagekräftiger Name empfohlen.
    • Tags (hc.tags): Die Tags für diese Konsistenzprüfung. Wenn diese zusammengesetzte Konsistenzprüfung Teil einer anderen Verbund-Konsistenzprüfung sein soll (z. B. in einer Hierarchie der Konsistenzprüfungen), fügen Sie die Tags hinzu, mit denen dieser Verbund verbunden ist.
    • MBean-Name (hc.mbean.name): Der Name des MBean, das dem JMX MBean dieser zusammengesetzten Konsistenzprüfung übergeben wird.
    • Filter-Tags (filter.tags): Die -Eigenschaft, die für Konsistenzprüfungen für Composite spezifisch ist. Diese Tags werden durch den Verbund aggregiert. Die zusammengesetzte Konsistenzprüfung aggregiert unter ihrer Gruppe alle Konsistenzprüfungen mit Tags, die mit einem der Filter-Tags dieses Verbundes übereinstimmen. Beispiel: eine zusammengesetzte Konsistenzprüfung mit den Filter-Tags test und check, aggregiert alle individuellen und zusammengesetzten Konsistenzprüfungen mit einer der test und check Tags in ihrer Tags-Eigenschaft ( hc.tags).
    HINWEIS

    Ein neues JMX-MBean wird für jede neue Konfiguration des Apache Sling Composite Health Checks erstellt.**

  5. Schließlich muss der Eintrag der erstellten Verbund-Konsistenzprüfung in den Konfigurationsknoten des Vorgangs-Dashboards hinzugefügt werden. Das Verfahren entspricht dem der individuellen Konsistenzprüfungen: Knoten des Typs nt:unstructured muss unter /apps/settings/granite/operations/hc. Die Ressourceneigenschaft des Knotens wird durch den Wert von hc.mean.name in der OSGi-Konfiguration.

    Wenn Sie beispielsweise eine Konfiguration erstellt haben und die Variable hc.mbean.name Wert zu diskusage, sehen die Konfigurationsknoten wie folgt aus:

    • Name: Composite Health Check

      • Typ: nt:unstructured

    Mit den folgenden Eigenschaften:

    • Name: sling:resourceType

      • Typ: String
      • Wert: granite/operations/components/mbean
    • Name: resource

      • Typ: String
      • Wert: /system/sling/monitoring/mbeans/org/apache/sling/healthcheck/HealthCheck/diskusage
    HINWEIS

    Wenn Sie individuelle Konsistenzprüfungen erstellen, die logisch zu einer Composite-Prüfung gehören, die standardmäßig bereits im Dashboard vorhanden ist, werden diese automatisch erfasst und unter der entsprechenden Composite-Prüfung gruppiert. Daher ist es nicht erforderlich, einen Konfigurationsknoten für diese Prüfungen zu erstellen.

    Wenn Sie beispielsweise eine individuelle Sicherheits-Konsistenzprüfung erstellen, weisen Sie ihr den security", und es wird installiert. Sie wird automatisch unter der zusammengesetzten Sicherheitsprüfungen im Vorgangs-Dashboard angezeigt.

Im Lieferumfang von AEM enthaltene Konsistenzprüfungen

Name der Konsistenzprüfung Beschreibung
Abfrageleistung

Diese Konsistenzprüfung wurde vereinfacht. AEM 6.4, und überprüft nun die kürzlich überarbeitete Oak QueryStats MBean, genauer gesagt, das SlowQueries -Attribut. Wenn die Statistiken langsame Abfragen enthalten, gibt die Konsistenzprüfung eine Warnung zurück. Andernfalls wird der Status "OK"zurückgegeben.

Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=queriesStatus,type=HealthCheck.

Länge der Überwachungswarteschlange

Diese Prüfung wird für alle Event-Listener und Hintergrundbeobachter schrittweise durchgeführt. Sie vergleicht die queueSize mit ihrer maxQueueSize und:

  • gibt den Status „Kritisch“ zurück, wenn der Wert für queueSize den Wert für maxQueueSize übersteigt (d. h., wenn Ereignisse entfernt werden)
  • gibt eine Warnung zurück, wenn der Wert für queueSize über dem maxQueueSize * WARN_THRESHOLD liegt (der Standardwert liegt bei 0,75)

Die maximale Länge jeder Warteschlange stammt aus separaten Konfigurationen (Oak und AEM) und kann von dieser Konsistenzprüfung nicht konfiguriert werden. Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=ObservationQueueLengthHealthCheck,type=HealthCheck.

Abfrage-Ausnahmelimits

Diese Prüfung überprüft das MBean QueryEngineSettings, genauer gesagt, die Attribute LimitInMemory und LimitReads, und gibt den folgenden Status zurück:

  • den Status „Warnung“, wenn eines der Limits dem folgenden Wert entspricht oder größer ist Integer.MAX_VALUE
  • den Status „Warnung“, wenn eines der Limits kleiner als 10.000 (die empfohlene Einstellung von Oak) ist
  • den Status „Kritisch“, wenn die QueryEngineSettings oder eines der Limits nicht abgerufen werden können

Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=queryTraversalLimitsBundle,type=HealthCheck.

Synchronisierte Uhren

Diese Prüfung ist nur für Dokumenten-NodeStore-Cluster relevant. Es wird der folgende Status zurückgegeben:

  • gibt den Warnungsstatus zurück, wenn die Instanzuhren nicht mehr synchronisiert sind und einen vordefinierten unteren Schwellenwert überschreiten
  • gibt den Status "Kritisch"zurück, wenn die Instanzuhren nicht mehr synchronisiert sind und einen vordefinierten hohen Schwellenwert überschreiten

Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=slingDiscoveryOakSynchronizedClocks,type=HealthCheck.

Asynchrone Indexe

Die Prüfung der asynchronen Indizes:

  • gibt den Status "Kritisch"zurück, wenn mindestens eine Indizierungsspur fehlschlägt
  • prüft lastIndexedTime für alle Indizierungsspuren und:
    • gibt den Status „Kritisch“ zurück, wenn die Zeit mehr als 2 Stunden zurückliegt
    • gibt den Status „Warnung“ zurück, wenn sie zwischen 2 Stunden und 45 Minuten zurückliegt
    • gibt den Status „OK“ zurück, wenn sie weniger als 45 Minuten zurückliegt
  • Wenn keine dieser Bedingungen erfüllt ist, wird der Status "OK"zurückgegeben.

Die Statusschwellen "Kritisch"und "Warn"sind konfigurierbar. Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=asyncIndexHealthCheck,type=HealthCheck.

Hinweis: Diese Konsistenzprüfung ist in AEM 6.4 und als Backport in AEM 6.3.0.1 verfügbar.

Große Lucene-Indizes

Diese Prüfung nutzt die Daten des MBean Lucene Index Statistics, um große Indizes zu identifizieren, und:

  • gibt den Status „Warnung“ zurück, wenn es einen Index mit mehr als 1 Mrd. Dokumenten gibt
  • Status "Kritisch", wenn ein Index mit mehr als 1,5 Milliarden Dokumenten vorhanden ist

Die Schwellenwerte sind konfigurierbar und das MBean für die Konsistenzprüfung ist org.apache.sling.healthcheck:name=largeIndexHealthCheck,type=HealthCheck.

Hinweis: Diese Prüfung ist in AEM 6.4 verfügbar und wurde auf AEM 6.3.2.0 rückportiert.

Systemwartung

Die Systemwartung ist eine zusammengesetzte Prüfung, die OK zurückgibt, wenn alle Wartungsaufgaben wie konfiguriert ausgeführt werden. Beachten Sie Folgendes:

  • Zu jeder Wartungsaufgabe gehört eine entsprechende Konsistenzprüfung.
  • Wenn eine Aufgabe nicht einem Wartungsfenster hinzugefügt wird, gibt ihre Konsistenzprüfung "Kritisch"zurück
  • die Wartungsaufgaben "Auditprotokoll"und "Workflow-Bereinigung"konfigurieren oder anderweitig aus den Wartungsfenstern entfernen. Wenn diese Aufgaben nicht konfiguriert sind, schlagen sie beim ersten Versuch fehl, sodass die Systemwartungsprüfung den Status "Kritisch"zurückgibt.
  • Mit AEM 6.4, gibt es auch eine Prüfung für die Wartung von Lucene-Binärdateien Aufgabe
  • Bei AEM 6.2 und niedriger gibt die Systemwartungsüberprüfung direkt nach dem Start einen Warnungsstatus zurück, da die Aufgaben nie ausgeführt werden. Ab 6.3 geben sie "OK"zurück, wenn das erste Wartungsfenster noch nicht erreicht wurde.

Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=systemchecks,type=HealthCheck.

Replikations-Warteschlange

Diese Prüfung durchläuft Replikationsagenten und untersucht deren Warteschlangen. Für das Element am Anfang der Warteschlange prüft die Prüfung, wie oft der Agent die Replikation wiederholt hat. Wenn diese Anzahl größer ist als der Wert des Parameters numberOfRetriesAllowed, wird eine Warnung zurückgegeben. Der Parameter numberOfRetriesAllowed ist konfigurierbar.

Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=replicationQueue,type=HealthCheck.

Sling Jobs
Diese Prüfung überprüft die Anzahl an Aufträgen, die sich in der Warteschlange des Auftrags-Managers befinden, vergleicht sie mit dem Schwellenwert maxNumQueueJobs und:
  • gibt den Status „Kritisch“ zurück, wenn sich mehr als maxNumQueueJobs in der Warteschlange befinden
  • gibt "Kritisch"zurück, wenn es aktive Aufträge mit langer Laufzeit gibt, die älter als eine Stunde sind
  • gibt "Kritisch"zurück, wenn Aufträge in der Warteschlange vorhanden sind und die letzte fertige Auftragszeit älter als 1 Stunde ist

Nur der Parameter Maximale Anzahl an Aufträgen in der Warteschlange kann konfiguriert werden und hat den Standardwert 1000.

Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=slingJobs,type=HealthCheck.

Anfrageleistung

Diese Prüfung untersucht die granite.request.metrics.timer Sling-Metrik und:

  • gibt "Kritisch"zurück, wenn der 75. Perzentil-Wert über dem kritischen Schwellenwert liegt (der Standardwert ist 500 Millisekunden)
  • gibt eine Warnung zurück, wenn der 75. Perzentil-Wert über dem Warnschwellenwert liegt (der Standardwert ist 200 Millisekunden)

Das MBean für diese Konsistenzprüfung ist  org.apache.sling.healthcheck:name=requestsStatus,type=HealthCheck.

Fehlerprotokoll

Diese Prüfung gibt den Warnungsstatus zurück, wenn im Protokoll Fehler auftreten.

Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=logErrorHealthCheck,type=HealthCheck.

Festplattenspeicher

Diese Prüfung untersucht das MBean FileStoreStats, ruft die Größe des NodeStores und den Umfang des verfügbaren Festplatten-Speicherplatzes auf der NodeStore-Partition ab und:

  • gibt eine Warnung zurück, wenn das Verhältnis zwischen verfügbarem Speicherplatz und Repository-Größe kleiner als der Warnschwellenwert ist (der Standardwert ist 10)
  • gibt "Kritisch"zurück, wenn das Verhältnis zwischen verfügbarem Speicherplatz und Repository-Größe kleiner als der kritische Schwellenwert ist (der Standardwert ist 2).

Beide Werte sind konfigurierbar. Die Prüfung funktioniert nur auf Instanzen mit einem Segmentspeicher.

Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=DiskSpaceHealthCheck,type=HealthCheck.

Scheduler-Statusprüfung

Diese Prüfung gibt eine Warnung zurück, wenn die Instanz über mehr als 60 Sekunden Quartz-Aufträge verfügt. Der Schwellenwert für die zulässige Dauer ist konfigurierbar.

Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=slingCommonsSchedulerHealthCheck,type=HealthCheck.

Sicherheitsprüfungen

Bei der Sicherheitsprüfung handelt es sich um einen Verbund, der die Ergebnisse mehrerer sicherheitsbezogener Prüfungen zusammenfasst. Diese individuellen Konsistenzprüfungen decken unterschiedliche Aspekte der Sicherheits-Checkliste ab, die auf der Dokumentationsseite zur Sicherheits-Checkliste zu finden ist. Die Prüfung ist als Feuerprobe beim Start der Instanz nützlich.

Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=securitychecks,type=HealthCheck

Aktive Bundles

Aktive Bundles überprüfen den Status aller Bundles und:

  • gibt den Warnungsstatus zurück, wenn eines der Bundles nicht aktiv ist oder (Start, mit verzögerter Aktivierung)
  • Er ignoriert den Status von Bundles in der Ignorierungsliste

Der Parameter "Ignorieren"-Liste kann konfiguriert werden.

Das MBean für diese Konsistenzprüfung ist org.apache.sling.healthcheck:name=inactiveBundles,type=HealthCheck.

Code-Cache-Prüfung

Eine Konsistenzprüfung, die mehrere JVM-Bedingungen überprüft, die auf einen in Java™ 7 vorhandenen CodeCache-Fehler Trigger werden können:

  • gibt eine Warnung zurück, wenn die Instanz unter Java™ 7 ausgeführt wird, wobei die Bereinigung des Code-Cache aktiviert ist
  • gibt eine Warnung zurück, wenn die Instanz auf Java™ 7 ausgeführt wird und die Größe des reservierten Code-Caches kleiner als ein Mindestschwellenwert ist (der Standardwert ist 90 MB)

Der Schwellenwert minimum.code.cache.size ist konfigurierbar. Weitere Informationen zum Fehler finden Sie unter und suchen Sie dann nach der Fehler-ID 8012547..

Das MBean für diese Konsistenzprüfung lautet org.apache.sling.healthcheck:name=codeCacheHealthCheck,type=HealthCheck.

Ressourcen-Suchpfad-Fehler

Prüft, ob unter dem Pfad /apps/foundation/components/primary Ressourcen vorhanden sind, und:

  • gibt eine Warnung aus, wenn hier untergeordnete Knoten vorhanden sind: /apps/foundation/components/primary

Das MBean für diese Konsistenzprüfung lautet org.apache.sling.healthcheck:name=resourceSearchPathErrorHealthCheck,type=HealthCheck.

Konfiguration der Konsistenzprüfung

Standardmäßig werden bei einer vordefinierten AEM-Instanz alle 60 Sekunden Konsistenzprüfungen ausgeführt.

Sie können den Zeitraum in der OSGi-Konfiguration mit der Konfiguration der Konsistenzprüfung von Anfragen (com.adobe.granite.queries.impl.hc.QueryHealthCheckMetrics) festlegen.

Überwachung mit Nagios

Das Konsistenzprüfungs-Dashboard kann über die Granite JMX MB in Nagios integriert werden. Das nachfolgende Beispiel zeigt, wie Sie eine Prüfung hinzufügen, die verwendeten Speicher auf dem Server anzeigt, auf dem AEM ausgeführt wird.

  1. Richten Sie Nagios auf dem Überwachungsserver ein und installieren Sie es.

  2. Installieren Sie anschließend den Nagios Remote Plugin Executor (NRPE).

    HINWEIS

    Weitere Informationen zur Installation von Nagios und NRPE auf Ihrem System finden Sie im Nagios-Dokumentation.

  3. Fügen Sie eine Hostdefinition für den AEM-Server hinzu. Sie können diese Aufgabe über die Nagios XI-Webschnittstelle mithilfe von Configuration Manager durchführen:

    1. Öffnen Sie einen Browser und zeigen Sie auf den Nagios-Server.
    2. Klicken Sie im oberen Menü auf die Schaltfläche Konfigurieren.
    3. Klicken Sie in der linken Spur unter Erweiterte Konfiguration auf Core-Konfigurations-Manager.
    4. Klicken Sie unter dem Abschnitt Überwachung auf den Link Hosts.
    5. Fügen Sie die Hostdefinition hinzu:

    chlimage_1-118

    Nachfolgend finden Sie ein Beispiel einer Host-Konfigurationsdatei unter Verwendung von Nagios Core:

    define host {
       address 192.168.0.5
       max_check_attempts 3
       check_period 24x7
       check-command check-host-alive
       contacts admin
       notification_interval 60
       notification_period 24x7
    }
    
  4. Installieren Sie Nagios und NRPE auf dem AEM-Server.

  5. Installieren Sie die check_http_json -Plug-in auf beiden Servern.

  6. Definieren Sie einen generischen JSON-Prüfbefehl auf beiden Servern:

    define command{
    
        command_name    check_http_json-int
    
        command_line    /usr/lib/nagios/plugins/check_http_json --user "$ARG1$" --pass "$ARG2$" -u 'https://$HOSTNAME$:$ARG3$/$ARG4$' -e '$ARG5$' -w '$ARG6$' -c '$ARG7$'
    
    }
    
  7. Fügen Sie einen Dienst für verwendeten Speicher auf dem AEM-Server hinzu:

    define service {
    
        use generic-service
    
        host_name my.remote.host
    
        service_description AEM Author Used Memory
    
        check_command  check_http_json-int!<cq-user>!<cq-password>!<cq-port>!system/sling/monitoring/mbeans/java/lang/Memory.infinity.json!{noname}.mbean:attributes.HeapMemoryUsage.mbean:attributes.used.mbean:value!<warn-threshold-in-bytes>!<critical-threshold-in-bytes>
    
        }
    
  8. Überprüfen Sie, ob das Nagios-Dashboard den neu erstellten Dienst anzeigt:

    chlimage_1-119

Diagnosetools

Das Vorgangs-Dashboard bietet außerdem Zugriff auf Diagnose-Tools, die Ihnen helfen, die Grundursachen der Warnungen aus dem Konsistenzprüfungs-Dashboard zu finden und zu beheben, und wichtige Debugging-Informationen für Systembetreiber bereitstellen.

Zu den wichtigsten Funktionen gehören:

  • Protokollnachrichten-Analyse
  • Zugriff auf Heap- und Thread-Sicherheitskopien
  • Leistungs-Analyse für Anfragen und Abfragen

Auf den Bildschirm „Diagnose-Tools“ können Sie über den AEM-Begrüßungsbildschirm über Tools > Vorgänge > Diagnose zugreifen. Über die folgende URL können Sie auch direkt auf die Diagnose-Tools zugreifen: https://serveraddress:port/libs/granite/operations/content/diagnosis.html

chlimage_1-120

Protokollmeldungen

Die Protokollmeldungen Die Benutzeroberfläche zeigt standardmäßig alle FEHLER-Meldungen an. Wenn Sie mehr Protokollmeldungen anzeigen möchten, konfigurieren Sie eine Protokollfunktion mit der entsprechenden Protokollebene.

Die Protokollmeldungen nutzen einen In-Memory-Protokoll-Appender und hängen daher nicht mit den Protokolldateien zusammen. Eine weitere Folge ist, dass sich durch die Änderung der Protokollebenen in dieser Benutzeroberfläche die Informationen, die in den herkömmlichen Protokolldateien protokolliert werden, nicht ändern. Das Hinzufügen und Entfernen von Loggern in dieser Benutzeroberfläche wirkt sich nur auf die Speicherprotokollierung aus. Außerdem spiegelt sich das Ändern der Logger-Konfigurationen in der Zukunft des in-Memory-Loggers wider. Die Einträge, die bereits protokolliert sind und nicht mehr relevant sind, werden nicht gelöscht, aber ähnliche Einträge werden in Zukunft nicht protokolliert.

Sie können konfigurieren, was protokolliert wird, indem Sie Logger-Konfigurationen über die Zahnradschaltfläche oben links in der Benutzeroberfläche bereitstellen. Dort können Sie Logger-Konfigurationen hinzufügen, entfernen oder aktualisieren. Eine Logger-Konfiguration besteht aus einer Protokollebene (WARN/INFO/DEBUG) und a Filtername. Die Filtername hat die Rolle, die Quelle der protokollierten Protokollmeldungen zu filtern. Wenn eine Protokollfunktion alle Protokollmeldungen für die angegebene Ebene erfassen soll, sollte der Filtername alternativ "root". Durch Festlegen der Protokollierungsstufe wird die Erfassung aller Nachrichten Trigger, deren Stufe mindestens der angegebenen entspricht.

Beispiele:

  • Wenn Sie alle FEHLER messages - keine Konfiguration erforderlich. Alle FEHLER-Meldungen werden standardmäßig erfasst.

  • Wenn Sie alle FEHLER, WARN und INFO messages - der Logger-Name sollte auf Folgendes festgelegt werden: "root" und der Protokollierungsstufe auf: INFO.

  • Wenn Sie alle Nachrichten aus einem bestimmten Paket erfassen möchten (z. B. com.adobe.granite), sollte der Logger-Name auf Folgendes festgelegt werden: "com.adobe.granite". Und die Protokollierungsebene auf: DEBUG (Dadurch werden alle FEHLER, WARN, INFO und DEBUG Meldungen), wie in der Abbildung unten dargestellt.

chlimage_1-121

HINWEIS

Sie können keinen Logger-Namen festlegen, um nur FEHLER-Nachrichten über einen bestimmten Filter zu erfassen. Standardmäßig werden alle FEHLER-Nachrichten erfasst.

HINWEIS

Die Benutzeroberfläche für Protokollmeldungen gibt nicht das tatsächliche Fehlerprotokoll wieder. Wenn Sie keine anderen Protokollnachrichten in der Benutzeroberfläche konfigurieren, werden nur FEHLER-Meldungen angezeigt. Informationen zum Anzeigen bestimmter Protokollmeldungen finden Sie in den Anweisungen oben.

HINWEIS

Die Einstellungen auf der Diagnoseseite beeinflussen nicht, was in den Protokolldateien protokolliert wird, und umgekehrt. Während das Fehlerprotokoll also möglicherweise INFO-Meldungen erfasst, werden diese möglicherweise nicht in der Benutzeroberfläche für Protokollmeldungen angezeigt. Über die Benutzeroberfläche ist es auch möglich, DEBUG-Meldungen aus bestimmten Paketen zu erfassen, ohne dass dies das Fehlerprotokoll beeinflusst. Weitere Informationen zum Konfigurieren der Protokolldateien finden Sie unter Protokollierung.

HINWEIS

In AEM 6.4 werden Wartungsaufgaben vorkonfiguriert in einem informationsreicheren Format auf INFO-Ebene protokolliert. Dieser Workflow ermöglicht eine bessere Übersicht über den Zustand der Wartungsaufgaben.

Wenn Sie Tools von Drittanbietern (wie Splunk) zur Überwachung und Reaktion auf Wartungsaufgaben verwenden, können Sie die folgenden Protokollanweisungen verwenden:

Log level: INFO
DATE+TIME [MaintanceLogger] Name=<MT_NAME>, Status=<MT_STATUS>, Time=<MT_TIME>, Error=<MT_ERROR>, Details=<MT_DETAILS>

Anfrageleistung

Die Anfrageleistungsseite ermöglicht die Analyse der langsamsten verarbeiteten Seitenanfragen. Auf dieser Seite werden nur Inhaltsanforderungen registriert. Im Einzelnen werden die folgenden Anfragen erfasst:

  1. Anfragen, die auf Ressourcen unter /content zugreifen
  2. Anfragen, die auf Ressourcen unter /etc/design zugreifen
  3. Anfragen mit der Erweiterung ".html"

chlimage_1-122

Die Seite wird angezeigt:

  • die Zeit, zu der die Anfrage erfolgt ist
  • die URL und die Methode der Anfrage
  • Die Dauer in Millisekunden

Standardmäßig werden die langsamsten 20 Seitenanfragen erfasst. Diesen Wert können Sie aber im Konfigurations-Manager ändern.

Abfrageleistung

Auf der Seite "Abfrageleistung"können die langsamsten vom System durchgeführten Abfragen analysiert werden. Diese Informationen werden vom Repository in einem JMX-MBean bereitgestellt. In Jackrabbit stellt das JMX-MBean com.adobe.granite.QueryStat diese Daten bereit, im Oak-Repository werden sie von org.apache.jackrabbit.oak.QueryStats. geliefert.

Die Seite wird angezeigt:

  • Der Zeitpunkt, zu dem die Abfrage durchgeführt wurde
  • Die Sprache der Abfrage
  • Die Häufigkeit, mit der die Abfrage ausgegeben wurde
  • Die Anweisung der Abfrage
  • Die Dauer in Millisekunden

chlimage_1-123

Abfrage erläutern

Bei jeder Abfrage versucht Oak, die beste Ausführungsmethode zu ermitteln, basierend auf den Oak-Indizes, die im Repository unter dem oak:index Knoten. Je nach Abfrage können Oak verschiedene Indizes auswählen. Die Ausführung einer Abfrage durch Oak zu verstehen ist der erste Schritt zur Optimierung der Abfrage.

Die Abfrage erläutern ist ein Tool, das erklärt, wie Oak eine Abfrage ausführt. Sie können darauf zugreifen, indem Sie Tools - Vorgänge - Diagnose über den AEM Begrüßungsbildschirm. Klicken Sie anschließend auf Abfrageleistung und wechseln Sie zur Abfrage erläutern Registerkarte.

Funktionen

  • Unterstützt die Abfragesprachen Xpath, JCR-SQL und JCR-SQL2
  • Meldung der tatsächlichen Ausführungszeit der genannten Abfrage
  • Erkennung langsamer Abfragen und Warnungen zu Abfragen, die möglicherweise langsam ausfallen könnten
  • Gibt den Oak-Index an, der zum Ausführen der Abfrage verwendet wird
  • Zeigt die tatsächliche Erläuterung der Oak-Abfrage-Engine an
  • Bietet eine Liste der langsamen und beliebten Abfragen mit Klicks zum Laden

Wenn Sie sich in der Benutzeroberfläche "Abfrage erläutern"befinden, geben Sie die Abfrage ein und drücken Sie die Erklären Schaltfläche:

chlimage_1-124

Der erste Eintrag im Abschnitt Abfrage-Erläuterung ist die eigentliche Erklärung. Die Erklärung zeigt den Indextyp an, der für die Ausführung der Abfrage verwendet wurde.

Der zweite Eintrag ist der Ausführungsplan.

Tippen Sie auf Ausführungszeit einschließen vor der Ausführung der Abfrage zeigt auch die Dauer der Ausführung der Abfrage an. Die Anzahl der Include-Knoten -Option gibt die Anzahl der Knoten an. Der Bericht enthält weitere Informationen, die zur Optimierung der Indizes für Ihre Anwendung oder Bereitstellung verwendet werden können.

chlimage_1-125

Der Index-Manager

Der Index-Manager soll die Indexverwaltung erleichtern, z. B. die Pflege von Indizes oder die Anzeige ihres Status.

Um auf ihn zuzugreifen, klicken Sie auf dem Begrüßungsbildschirm unter Tools > Vorgänge > Diagnose auf die Schaltfläche Index-Manager.

Darüber hinaus kann auf ihn direkt über diese URL zugegriffen werden: https://serveraddress:port/libs/granite/operations/content/diagnosistools/indexManager.html

Index-Manager

Die Benutzeroberfläche kann verwendet werden, um Indizes in der Tabelle zu filtern, indem die Filterkriterien in das Suchfeld in der oberen linken Ecke des Bildschirms eingegeben werden.

Status-ZIP herunterladen

Diese Aktion Trigger den Download einer ZIP-Datei mit nützlichen Informationen zum Systemstatus und zur Systemkonfiguration. Das Archiv enthält Instanzkonfigurationen, eine Liste von Bundles, OSGI, Sling-Metriken und Statistiken, was zu einer großen Datei führen kann. Um die Auswirkung großer Statusdateien zu minimieren, können Sie das Fenster Status-ZIP herunterladen nutzen. Das Fenster finden Sie unter AEM > Tools > Vorgänge > Diagnose > Status-ZIP herunterladen.

In diesem Fenster können Sie auswählen, was exportiert werden soll (Protokolldateien und/oder Thread-Sicherheitskopien) und wie viele Tage Protokolle im Download im Verhältnis zum aktuellen Datum enthalten sind.

download_status_zip

Thread-Sicherheitskopie herunterladen

Diese Aktion Trigger den Download einer ZIP-Datei mit Informationen zu den im System vorhandenen Threads. Es werden Informationen zu jedem Thread bereitgestellt, wie z. B. sein Status, der Classloader und der Stacktrace.

Stapel-Sicherheitskopie herunterladen

Sie können einen Schnappschuss des Heap herunterladen, um ihn später zu analysieren. Diese Aktion Trigger den Download einer großen (Hunderte von Megabyte) Datei.

Automatisierte Wartungsaufgaben

Auf der Seite "Automatisierte Wartungsaufgaben"können Sie empfohlene Wartungsaufgaben, die für die regelmäßige Ausführung geplant sind, anzeigen und verfolgen. Die Aufgaben sind in das Konsistenzprüfungssystem integriert. Die Aufgaben können auch manuell über die Benutzeroberfläche ausgeführt werden.

Rufen Sie die Seite "Wartung"im Vorgangs-Dashboard im Begrüßungsbildschirm des AEM auf: Tools - Vorgänge - Dashboard - Wartung oder direkt diesem Link folgen:

https://serveraddress:port/libs/granite/operations/content/maintenance.html

Die folgenden Aufgaben sind im Vorgangs-Dashboard verfügbar:

  1. die Aufgabe Revisionsbereinigung, zu finden im Menü Tägliches Wartungsfenster
  2. die Aufgabe Lucene-Binärdateien-Bereinigung, zu finden im Menü Tägliches Wartungsfenster
  3. die Aufgabe Workflow-Bereinigung, zu finden im Menü Wöchentliches Wartungsfenster
  4. die Aufgabe Datenspeicherbereinigung, zu finden im Menü Wöchentliches Wartungsfenster
  5. die Wartungsaufgabe Auditprotokoll, zu finden im Menü Wöchentliches Wartungsfenster
  6. die Wartungsaufgabe Versionsbereinigung, zu finden im Menü Wöchentliches Wartungsfenster

Der Standardzeitrahmen für das tägliche Wartungsfenster beträgt 2:00 Uhr bis 5:00 Uhr. Die für die Ausführung im wöchentlichen Wartungsfenster konfigurierten Aufgaben laufen samstags zwischen 1:00 Uhr und 2:00 Uhr.

Sie können die Timings auch konfigurieren, indem Sie auf einer der beiden Wartungskarten auf das Zahnradsymbol klicken:

chlimage_1-126

HINWEIS

Seit AEM 6.1 können die vorhandenen Wartungsfenster auch so konfiguriert werden, dass sie monatlich ausgeführt werden.

Revisionsbereinigung

Weitere Informationen zur Durchführung der Revisionsbereinigung finden Sie unter finden Sie in diesem speziellen Artikel.

Lucene-Binärdateien-Bereinigung

Mithilfe der Aufgabe Lucene-Binärdateien-Bereinigung können Sie Lucene-Binärdateien bereinigen und die Anforderungen an die Größe des laufenden Datenspeichers reduzieren. Die binäre Abwanderung von Lucene wird täglich anstelle der früheren Abhängigkeit von einer erfolgreichen Speicherbereinigung ausführen.

Obwohl die Wartungsaufgabe entwickelt wurde, um Lucene-bezogenen Überarbeitungsfehler zu reduzieren, gibt es allgemeine Effizienzsteigerungen bei der Ausführung der Aufgabe:

  • Die wöchentliche Ausführung der automatischen Datenspeicherbereinigung kann schneller abgeschlossen werden.
  • Es kann auch die Gesamtleistung der AEM leicht verbessern.

Die Aufgabe „Lucene-Binärdateien-Bereinigung“ finden Sie unter AEM > Tools > Vorgänge > Wartung > Tägliches Wartungsfenster > Lucene-Binärdateien-Bereinigung.

Datenspeicherbereinigung

Weitere Informationen zur automatischen Datenspeicherbereinigung finden Sie in der entsprechenden Dokumentationsseite.

Workflow-Bereinigung

Workflows können auch über das Wartungs-Dashboard bereinigt werden. Gehen Sie wie folgt vor, um die Aufgabe "Workflow-Bereinigung"auszuführen:

  1. Klicken Sie auf Wöchentliches Wartungsfenster Seite.
  2. Klicken Sie auf der folgenden Seite auf Play im Workflow-Bereinigung Karte.
HINWEIS

Weitere Informationen zur Workflow-Wartung finden Sie unter diese Seite.

Auditprotokoll-Wartung

Informationen zur Auditprotokoll-Wartung finden Sie auf der entsprechenden Dokumentationsseite.

Versionsbereinigung

Sie können die Wartungsaufgabe zur Versionsbereinigung planen, um alte Versionen automatisch zu löschen. Diese Aktion minimiert die Notwendigkeit, die Tools zur Versionsbereinigung. Um die Versionsbereinigung zu planen und zu konfigurieren, führen Sie unter Tools > Vorgänge > Wartung > Wöchentliches Wartungsfenster die folgenden Schritte durch:

  1. Klicken Sie auf Hinzufügen.

  2. Wählen Sie aus dem Dropdown-Menü Versionsbereinigung aus.

    version_purge_maintenance_etask

  3. Um die Versionsbereinigung zu konfigurieren, klicken Sie auf das Zahnräder auf der neu erstellten Versionsbereinigungs-Wartungskarte.

    version_purge_taskconfiguration

Mit AEM 6.4 können Sie die Wartungsaufgabe Versionsbereinigung wie folgt beenden:

  • Automatisch - Wenn das geplante Wartungsfenster geschlossen wird, bevor die Aufgabe abgeschlossen werden kann, wird die Aufgabe automatisch beendet. Sie wird fortgesetzt, wenn das nächste Wartungsfenster beginnt.
  • Manuell – Um die Aufgabe manuell anzuhalten, klicken Sie auf der Versionsbereinigungs-Wartungskarte auf das Stopp-Symbol. Bei der nächsten Ausführung wird die Aufgabe sicher fortgesetzt.
HINWEIS

Das Anhalten der Wartungsaufgabe bedeutet, die Ausführung auszusetzen, ohne den bereits ausgeführten Auftrag zu verlieren.

VORSICHT

Um die Repository-Größe zu optimieren, sollten Sie die Versionsbereinigungsaufgabe häufig ausführen. Die Aufgabe sollte außerhalb der Geschäftszeiten geplant werden, wenn nur ein begrenzter Traffic verfügbar ist.

Benutzerdefinierte Wartungsaufgaben

Sie können benutzerdefinierte Wartungsaufgaben als OSGi-Dienste implementieren. Da die Infrastruktur der Wartungsaufgaben auf der Auftragsverarbeitung von Apache Sling basiert, muss eine Wartungsaufgabe die Java™-Schnittstelle implementieren [org.apache.sling.event.jobs.consumer.JobExecutor](https://sling.apache.org/apidocs/sling7/org/apache/sling/event/jobs/consumer/JobExecutor.html). Um als Wartungsaufgabe erkannt zu werden, muss sie zusätzlich mehrere Dienstregistrierungseigenschaften festlegen, wie nachfolgend aufgeführt:

Diensteigenschaftsname
Beschreibung Beispiel
Typ
granite.maintenance.isStoppable Boolesches Attribut, das definiert, ob die Aufgabe vom Benutzer angehalten werden kann. Wenn eine Aufgabe feststellt, dass sie beendet werden kann, muss sie während ihrer Ausführung überprüfen, ob sie beendet wurde, und entsprechend handeln. Der Standardwert ist "false". true Optional
granite.maintenance.mandatory Boolesches Attribut, das definiert, ob eine Aufgabe obligatorisch ist und regelmäßig ausgeführt werden muss. Wenn eine Aufgabe obligatorisch, aber derzeit nicht in einem aktiven Zeitplanfenster vorhanden ist, meldet eine Konsistenzprüfung diesen Fehler. Der Standardwert ist "false". true Optional
granite.maintenance.name Ein eindeutiger Name für die Aufgabe - der Name wird verwendet, um auf die Aufgabe zu verweisen, und ist nur ein einfacher Name. MyMaintenanceTask Erforderlich
granite.maintenance.title Ein Titel für diese Aufgabe wird angezeigt Meine besondere Wartungsaufgabe Erforderlich
job.topics Ein eindeutiges Thema der Wartungsaufgabe.
Die Verarbeitung von Apache Sling-Aufträgen startet einen Auftrag mit genau diesem Thema, um die Wartungsaufgabe auszuführen. Sobald die Aufgabe für dieses Thema registriert ist, wird sie ausgeführt.
Das Thema muss mit com/adobe/granite/maintenance/job/ beginnen.
com/adobe/granite/maintenance/job/MyMaintenanceTask Erforderlich

Neben den oben genannten Diensteigenschaften wird die process() -Methode JobConsumer -Schnittstelle implementiert werden, indem der Code hinzugefügt wird, der für die Wartungsaufgabe ausgeführt werden soll. Mit dem bereitgestellten JobExecutionContext können Sie Statusinformationen ausgeben, prüfen, ob der Auftrag vom Benutzer angehalten wurde, und ein Ergebnis erstellen (Erfolg oder Fehler).

In Situationen, in denen eine Wartungsaufgabe nicht auf allen Installationen ausgeführt werden sollte (z. B. nur auf der Veröffentlichungsinstanz), können Sie den Dienst so einrichten, dass eine Konfiguration aktiv sein muss, indem Sie @Component(policy=ConfigurationPolicy.REQUIRE). Anschließend können Sie die entsprechende Konfiguration im Repository als abhängig vom Ausführungsmodus markieren. Weitere Informationen finden Sie unter Konfigurieren von OSGi.

Nachfolgend finden Sie ein Beispiel für eine benutzerdefinierte Wartungsaufgabe, die Dateien aus einem konfigurierbaren temporären Ordner löscht, die in den letzten 24 Stunden geändert wurden:

src/main/java/com/adobe/granite/samples/maintenance/impl/DeleteTempFilesTask.java

/*

* #%L

* sample-maintenance-task

* %%

* Copyright (C) 2014 Adobe

* %%

* Licensed under the Apache License, Version 2.0 (the "License");

* you may not use this file except in compliance with the License.

* You may obtain a copy of the License at

*

* https://www.apache.org/licenses/LICENSE-2.0

*

* Unless required by applicable law or agreed to in writing, software

* distributed under the License is distributed on an "AS IS" BASIS,

* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

* See the License for the specific language governing permissions and

* limitations under the License.

* #L%

*/

package com.adobe.granite.samples.maintenance.impl;

import java.io.File;

import java.util.Calendar;

import java.util.Collection;

import java.util.Map;

import org.apache.commons.io.FileUtils;

import org.apache.commons.io.filefilter.IOFileFilter;

import org.apache.commons.io.filefilter.TrueFileFilter;

import org.apache.felix.scr.annotations.Activate;

import org.apache.felix.scr.annotations.Component;

import org.apache.felix.scr.annotations.Properties;

import org.apache.felix.scr.annotations.Property;

import org.apache.felix.scr.annotations.Service;

import org.apache.sling.commons.osgi.PropertiesUtil;

import org.apache.sling.event.jobs.Job;

import org.apache.sling.event.jobs.consumer.JobConsumer;

import org.apache.sling.event.jobs.consumer.JobExecutionContext;

import org.apache.sling.event.jobs.consumer.JobExecutionResult;

import org.apache.sling.event.jobs.consumer.JobExecutor;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import com.adobe.granite.maintenance.MaintenanceConstants;

@Component(metatype = true,

label = "Delete Temp Files Maintenance Task",

description = "Maintatence Task which deletes files from a configurable temporary directory which have been modified in the last 24 hours.")

@Service

@Properties({

@Property(name = MaintenanceConstants.PROPERTY_TASK_NAME, value = "DeleteTempFilesTask", propertyPrivate = true),

@Property(name = MaintenanceConstants.PROPERTY_TASK_TITLE, value = "Delete Temp Files", propertyPrivate = true),

@Property(name = JobConsumer.PROPERTY_TOPICS, value = MaintenanceConstants.TASK_TOPIC_PREFIX

+ "DeleteTempFilesTask", propertyPrivate = true) })

public class DeleteTempFilesTask implements JobExecutor {

private static final Logger log = LoggerFactory.getLogger(DeleteTempFilesTask.class);

@Property(label = "Temporary Directory", description="Temporary Directory. Defaults to the java.io.tmpdir system property.")

private static final String PROP_TEMP_DIR = "temp.dir";

private File tempDir;

@Activate

private void activate(Map<string, object=""> properties) {

this.tempDir = new File(PropertiesUtil.toString(properties.get(PROP_TEMP_DIR),

System.getProperty("java.io.tmpdir")));

}

@Override

public JobExecutionResult process(Job job, JobExecutionContext context) {

log.info("Deleting old temp files from {}.", tempDir.getAbsolutePath());

Collection<file> files = FileUtils.listFiles(tempDir, new LastModifiedBeforeYesterdayFilter(),

TrueFileFilter.INSTANCE);

int counter = 0;

for (File file : files) {

log.debug("Deleting file {}.", file.getAbsolutePath());

counter++;

file.delete();

// TODO - capture the output of delete() and do something useful with it

}

return context.result().message(String.format("Deleted %s files.", counter)).succeeded();

}

/**

* IOFileFilter which filters out files which have been modified in the last 24 hours.

*

*/

private static class LastModifiedBeforeYesterdayFilter implements IOFileFilter {

private final long minTime;

private LastModifiedBeforeYesterdayFilter() {

Calendar cal = Calendar.getInstance();

cal.add(Calendar.DATE, -1);

this.minTime = cal.getTimeInMillis();

}

@Override

public boolean accept(File dir, String name) {

// this method is never actually called.

return false;

}

@Override

public boolean accept(File file) {

return file.lastModified() <= this.minTime;

}

}

}

<file></string,>

experiencemanager-java-maintenancetask-sample src/main/java/com/adobe/granite/samples/maintenance/impl/DeleteTempFilesTask.java

Nachdem der Dienst bereitgestellt wurde, wird er der Benutzeroberfläche des Vorgangs-Dashboards angezeigt. Sie können ihn zu einem der verfügbaren Wartungszeitpläne hinzufügen:

chlimage_1-127

Durch diese Aktion wird die entsprechende Ressource unter /apps/granite/operations/config/maintenance/ hinzugefügt.schedule/taskname. Wenn die Aufgabe vom Ausführungsmodus abhängig ist, muss die Eigenschaft granite.operations.conditions.runmode auf diesem Knoten mit den Werten der Ausführungsmodi festgelegt werden, die für diese Wartungsaufgabe aktiv sein müssen.

Systemübersicht

Die Dashboard "Systemübersicht" zeigt einen allgemeinen Überblick über die Konfiguration, Hardware und den Zustand der AEM Instanz. Der Systemzustand ist transparent und alle Informationen werden in einem Dashboard zusammengefasst.

HINWEIS

Eine Einführung in das Systemübersicht-Dashboard erhalten Sie auch in diesem Video.

Zugriff

Um auf das Systemübersicht-Dashboard zuzugreifen, gehen Sie zu Tools > Vorgänge > Systemübersicht.

system_overview_dashboard

Dashboard "Systemübersicht" - Erklärung

In der folgenden Tabelle werden alle im Dashboard "Systemübersicht"angezeigten Informationen beschrieben. Wenn keine relevanten Informationen angezeigt werden (z. B. wird keine Sicherung durchgeführt, es gibt keine kritischen Konsistenzprüfungen), zeigt der entsprechende Abschnitt die Meldung "Keine Einträge"an.

Sie können auch eine JSON Datei, in der die Dashboard-Informationen durch Klicken auf die Download in der oberen rechten Ecke des Dashboards. Die JSON Endpunkt ist /libs/granite/operations/content/systemoverview/export.json und kann in einer curl Skript für die externe Überwachung.

Abschnitt Angezeigte Informationen Wann liegt ein kritischer Status vor Ist verknüpft mit
Konsistenzprüfungen
  • eine Liste der Prüfungen mit dem Status "Kritisch"
  • eine Liste der Prüfungen mit dem Status "Warnung"
Visuell angezeigt:
  • ein rotes Tag für kritische Prüfungen
  • ein orangefarbenes Tag für Warnprüfungen
  • Seite "Konsistenzberichte"
Wartungsaufgaben
  • eine Liste der fehlgeschlagenen Aufgaben
  • eine Liste der Aufgaben, die derzeit ausgeführt werden
  • eine Liste der Aufgaben, die in der letzten Ausführung erfolgreich waren
  • eine Liste von Aufgaben, die noch nie ausgeführt wurden
  • eine Liste von Aufgaben, die nicht geplant sind

Visuell angezeigt:

  • ein rotes Tag für fehlgeschlagene Aufgaben
  • ein orangefarbenes Tag für laufende Aufgaben (da sie sich auf die Leistung auswirken können)
  • graue Tags für jeden anderen Status
  • Seite "Wartungsaufgaben"
System
  • Betriebssystem und Betriebssystemversion (z. B. macOS X)
  • durchschnittliche Systemlast, abgerufen von OperatingSystemMXBeanusable
  • Speicherplatz (auf der Partition, auf der sich das Home-Verzeichnis befindet)
  • maximaler Heap, wie zurückgegeben von MemoryMXBean
Nicht zutreffend Nicht zutreffend
Instanz
  • AEM
  • Liste der Ausführungsmodi
  • das Datum, an dem die Instanz gestartet wurde
Nicht zutreffend Nicht zutreffend
Repository
  • die Oak-Version
  • Typ des Knotenspeichers (Segment Tar oder Dokument)
    • Wenn der Typ document ist, wird der Typ des Dokumentspeichers angezeigt (RDB oder Mongo).
  • wenn ein benutzerdefinierter Datenspeicher vorhanden ist:
    • für einen Dateidatenspeicher wird der Pfad angezeigt
    • für einen S3-Datenspeicher wird der Name des S3-Buckets angezeigt.
    • Für einen freigegebenen S3-Datenspeicher wird der Name des S3-Buckets angezeigt.
    • für einen Azure-Datenspeicher wird der Container angezeigt
  • Wenn kein benutzerdefinierter externer Datenspeicher vorhanden ist, wird eine Meldung angezeigt, die darauf hinweist
Nicht zutreffend Nicht zutreffend
Verteilungsagenten
  • Liste der Agenten mit blockierten Warteschlangen
  • Liste der falsch konfigurierten Agenten ("Konfigurationsfehler")
  • Liste der Agenten, deren Warteschlangenverarbeitung angehalten wurde
  • eine Liste der Leerzeichen-Agenten
  • eine Liste der ausgeführten Agenten (die derzeit Einträge verarbeiten)

Visuell angezeigt:

  • ein rotes Tag für blockierte Agenten oder Konfigurationsfehler
  • ein orangefarbenes Tag für ausgesetzte Agenten
  • ein graues Tag für ausgesetzte, inaktive oder ausgeführte Agenten
Verteilungsseite
Replikations-Agenten
  • Liste der Agenten mit blockierten Warteschlangen
  • eine Liste der Leerzeichen-Agenten
  • eine Liste der ausgeführten Agenten (die derzeit Einträge verarbeiten)

Visuell angezeigt:

  • ein rotes Tag für gesperrte Agenten
  • ein graues Tag für ausgesetzte Agenten
Replikationsseite
Workflows
  • Workflow-Aufträge:
    • Anzahl fehlgeschlagener Workflow-Aufträge (falls vorhanden)
    • Anzahl an abgebrochenen Workflow-Aufträgen (falls vorhanden)
  • Workflow-Anzahl – die Anzahl an Workflows in einem bestimmten Status (falls vorhanden):
    • running
    • fehlgeschlagen
    • ausgesetzt
    • abgebrochen

Für jeden der oben aufgeführten Status wird eine Abfrage mit einer Beschränkung von 400 Millisekunden durchgeführt. Bei 400 Millisekunden wird die Anzahl der bis zu diesem Zeitpunkt erhaltenen Einträge angezeigt.

Nicht interpretiert:

  • Der Benutzer sollte untersuchen, wann Workflows und Aufträge in unerwarteten Status vorhanden sind.
Seite "Workflow-Fehler"
Sling Jobs

Anzahl der Sling-Aufträge - Anzahl der Aufträge in einem bestimmten Status (falls vorhanden):

  • fehlgeschlagen
  • in Warteschlange
  • abgebrochen
  • aktiv

Nicht interpretiert:

  • Der Benutzer sollte untersuchen, wenn Aufträge in unerwarteten Status oder mit hohen Zahlen vorliegen.
Nicht zutreffend
Voraussichtliche Knotenanzahl

Geschätzte Anzahl:

  • Seiten
  • Assets
  • tags
  • authorizables
  • Gesamtanzahl der Knoten

Die Gesamtzahl an Knoten wird vom nodeCounterMBean abgerufen, die übrigen Statistiken dagegen von IndexInfoService.

Nicht zutreffend Nicht zutreffend
Sicherung Zeigt "Online-Sicherung läuft"an, falls dies der Fall ist. Nicht zutreffend Nicht zutreffend
Indizierung

Displays:

  • "Indizierung wird ausgeführt"
  • "Abfrage wird ausgeführt"

Wenn ein Indizierungs- oder Abfragethread im Thread-Dump vorhanden ist.

Nicht zutreffend Nicht zutreffend

Auf dieser Seite