Um Ihnen bei der Überwachung und Analyse des Status Ihrer Instanz zu helfen, stellt AEM eine Auswahl an Standardberichten bereit, die für Ihre individuellen Anforderungen konfiguriert werden können:
Diese Berichte sind nur in der klassischen Benutzeroberfläche verfügbar. Informationen zur Systemüberwachung und -berichterstellung in der modernen Benutzeroberfläche finden Sie in der Vorgangs-Dashboard.
Über die Konsole Tools kann auf alle Berichte zugegriffen werden. Wählen Sie im linken Bereich Berichte aus und doppelklicken Sie dann im rechten Bereich auf den benötigten Bericht, um ihn zur Anzeige und/oder Konfiguration zu öffnen.
Neue Instanzen eines Berichts können auch über die Konsole Tools erstellt werden. Wählen Sie im linken Bereich Berichte aus und anschließend Neu… in der Symbolleiste. Legen Sie Titel und Name fest, wählen Sie den benötigten Berichtstyp aus und klicken Sie dann auf Erstellen. Ihre neue Berichtsinstanz wird in der Liste angezeigt. Doppelklicken Sie darauf, um Sie zu öffnen und ziehen Sie dann eine Komponente aus dem Sidekick, um die erste Spalte zu erstellen und mit der Berichtsdefinition zu beginnen.
Zusätzlich zu den standardmäßigen AEM-Berichten können Sie auch Ihren eigenen (vollständig neuen) Bericht entwickeln.
Es stehen verschiedene Berichtsformate zur Verfügung. Die folgenden Berichte nutzen alle Spalten, die wie in den folgenden Abschnitten beschrieben angepasst werden können.
Die folgenden Berichte verfügen alle über ihr eigenes Format und ihre eigene Anpassung:
Die folgenden Verfahren zur Spaltenkonfiguration sind also nicht geeignet. Weitere Informationen finden Sie in den Beschreibungen der einzelnen Berichte.
Spalten können in allen Berichten hinzugefügt, neu positioniert oder entfernt werden – sowohl in standardmäßigen als auch in angepassten Berichten.
Auf der Registerkarte Komponenten des Sidekicks (verfügbar auf der Berichtsseite) sind alle Kategorien von Daten aufgeführt, die als Spalten ausgewählt werden können.
Zum Ändern der Datenauswahl gehen Sie wie folgt vor:
Ziehen Sie zum Hinzufügen einer neuen Spalte die erforderliche Komponente aus dem Sidekick und legen Sie sie in der gewünschten Position ab.
Um eine Spalte zu verschieben, klicken Sie auf die Kopfzeile, halten Sie sie gedrückt und ziehen Sie sie an die neue Position.
Um eine Spalte zu entfernen, klicken Sie auf den Spaltentitel, halten Sie ihn gedrückt und ziehen Sie ihn nach oben in den Bereich der Berichtskopfzeile (ein rotes Minussymbol zeigt an, dass die Position gültig ist) und lassen Sie die Maustaste los. Das Dialogfeld „Komponente(n) löschen“ fordert Sie nun auf, die Löschung der Spalte zu bestätigen.
Jede Spalte des Berichts verfügt über ein Dropdown-Menü. Es wird angezeigt, wenn der Mauszeiger über die Zelle mit dem Spaltentitel bewegt wird.
Ganz rechts neben der Zelle mit dem Titel wird eine Pfeilspitze angezeigt (die nicht mit der Pfeilspitze direkt rechts neben dem Titeltext verwechselt werden sollte, die den aktuellen Sortiermechanismus anzeigt).
Die im Menü verfügbaren Optionen hängen von der (während der Projektentwicklung vorgenommenen) Konfiguration der Spalte ab. Alle ungültigen Optionen werden ausgegraut.
Die Daten können mithilfe folgender Möglichkeiten nach einer bestimmten Spalte angezeigt werden:
In geeigneten Spalten können Sie Nach Spalte gruppieren im Dropdown-Menü der Spalte auswählen. Hierdurch werden die Daten nach jedem einzelnen Wert innerhalb dieser Spalte gruppiert. Sie können mehrere Spalten für die Gruppierung auswählen. Die Option werden ausgegraut, wenn in der Spalte nicht geeignete Daten vorhanden sind, d. h. wenn jeder Eintrag einzeln zu betrachten und einzigartig ist, sodass keine Gruppen gebildet werden können. Dies gilt zum Beispiel für die Spalte mit der Benutzer-ID im Benutzerbericht.
Nach der Gruppierung mindestens einer Spalte wird auf Grundlage dieser Gruppierung ein Tortendiagramm der aktuellen Daten generiert. Wenn mehrere Spalten gruppiert werden, wird dies ebenfalls im Diagramm angegeben.
Wenn Sie Ihren Mauszeiger über das Tortendiagramm bewegen, wird der zusammengefasste Wert zum entsprechenden Segment angezeigt. Hierbei wird die aktuell zu der Spalte festgelegte Zusammenfassung verwendet, so zum Beispiel Anzahl, Minimum oder Durchschnitt.
In geeigneten Spalten können Sie außerdem die Filtereinstellungen und/oder Zusammenfassungen im Dropdown-Menü der Spalte konfigurieren.
Mithilfe der Filtereinstellungen können Sie die Kriterien für anzuzeigende Einträge festlegen. Die verfügbaren Operatoren lauten:
contains
equals
Sie können wie folgt einen Filter festlegen:
Sie können den Filter wie folgt deaktivieren:
Sie können auch eine Zusammenfassungsmethode auswählen (diese können je nach ausgewählter Spalte variieren):
Diese Option ist nur verfügbar, wenn die Generische Spalte im Benutzerbericht verwendet wurde.
Ein Diagramm zu den Änderungen an Ihren Daten im Zeitverlauf kann unter Frühere Daten angezeigt werden. Dieses wird aus in regelmäßigen Intervallen aufgenommenen Momentaufnahmen abgeleitet.
Die Daten werden:
Der Bericht kann wie folgt generiert werden:
Legen Sie zur erforderlichen Spalte Gruppierung fest.
Bearbeiten Sie die Konfiguration, um festzulegen, wie häufig Momentaufnahmen erstellt werden sollten – stündlich oder täglich.
Beenden… Sie die Definition, um die Sammlung von Momentaufnahmen zu starten.
Die roten/grünen Reglerschaltflächen oben links zeigen an, wenn Momentaufnahmen erfasst werden.
Das daraus resultierende Diagramm wird unten rechts angezeigt:
Sobald die Datenerfassung begonnen hat, können Sie Folgendes auswählen:
Zeitraum
Sie können für die Anzeige der Berichtsdaten zwischen und wählen.
Intervall
Monat, Woche, Tag, Stunde können für die Skalierung und Aggregation des Berichts ausgewählt werden.
Wenn zum Beispiel für Februar 2011 tägliche Momentaufnahmen verfügbar sind:
Day
, wird jeder Schnappschuss als einzelner Wert im Diagramm angezeigt.Month
, werden alle Momentaufnahmen für Februar in einem einzigen Wert zusammengefasst (in der Grafik als einzelner "Punkt"angezeigt).Wählen Sie Ihre Anforderungen aus und klicken Sie dann auf Los, um sie auf den Bericht anzuwenden. Um die Anzeige nach der Anfertigung weiterer Momentaufnahmen zu aktualisieren, klicken Sie erneut auf Los.
Wenn die Momentaufnahmen erfasst werden, können Sie:
Beenden… verwenden, um die Sammlung erneut zu initialisieren.
Durch Beenden wird die Berichtsstruktur (d. h. die dem Bericht zugewiesenen Spalten und welche gruppiert, sortiert, gefiltert sind usw.) „eingefroren“ und es wird mit dem Anfertigen von Momentaufnahmen begonnen.
Öffnen Sie das Dialogfeld Bearbeiten, um Keine Datenmomentaufnahmen auszuwählen und die Sammlung zu beenden, bis sie erforderlich ist.
Durch Bearbeiten wird lediglich das Anfertigen von Momentaufnahmen ein- oder ausgeschaltet. Wenn das Anfertigen von Momentaufnahmen erneut eingeschaltet wird, wird der Status des Berichts bei dessen letzter Fertigstellung zum Anfertigen weiterer Momentaufnahmen verwendet.
Schnappschüsse werden unter /var/reports/...
wobei der Rest des Pfads dem Pfad des entsprechenden Berichts und der ID entspricht, die beim Abschluss des Berichts erstellt wurden.
Alte Momentaufnahmen können manuell gelöscht werden, wenn Sie vollkommen sicher sind, dass Sie diese Instanzen nicht mehr benötigen.
Die vorkonfigurierten Berichte sind nicht leistungsintensiv, es wird jedoch dennoch empfohlen, tägliche Momentaufnahmen in einer Produktionsumgebung zu verwenden. Führen Sie diese täglichen Momentaufnahmen nach Möglichkeit zu einer Tageszeit aus, zu der auf Ihrer Website nicht viel Aktivität stattfindet. Dies kann mit der Daily snapshots (repconf.hourofday)
Parameter für Day CQ-Berichtkonfiguration; see OSGi-Konfiguration für weitere Informationen zur Konfiguration.
Die Darstellung des Berichts zu den früheren Daten kann sich aufgrund von festlegbaren Beschränkungen auch leicht ändern – je nach der Anzahl der Ergebnisse zum ausgewählten Zeitraum.
Jede horizontale Zeile ist als eine Reihe bekannt (und entspricht einem Eintrag in der Diagrammlegende) und jede vertikale Spalte von Punkten stellt die aggregierten Momentaufnahmen dar.
Damit das Diagramm über längere Zeiträume hinweg aufgeräumt bleibt, können Beschränkungen festgelegt werden. Für die Standardberichte sind dies:
horizontale Reihe – sowohl Standard als auch Systemmaximum ist 9
vertikale aggregierte Momentaufnahmen – Standardwert ist 35
(pro horizontaler Reihe)
Wenn die entsprechenden Beschränkungen überschritten werden:
In benutzerspezifischen Berichten kann auch der Wert Insgesamt für die ganze Reihe angezeigt werden. Dies wird als eine Reihe angezeigt (horizontale Linie und Eintrag in der Legende).
Für benutzerspezifische Berichte können die Beschränkungen anders festgelegt werden.
Über die Schaltfläche Bearbeiten wird das Dialogfeld Bericht bearbeiten geöffnet.
Dies ist ein Speicherort, an dem der Zeitraum für die Erfassung früherer Daten festgelegt wird. Es können jedoch auch diverse andere Einstellungen festgelegt werden:
Titel
Sie können einen eigenen Titel definieren.
Beschreibung
Sie können eine eigene Beschreibung definieren.
Stammpfad (nur aktiv für bestimmte Berichte)
Verwenden Sie dies, um den Bericht auf einen (Unter-)Abschnitt des Repositorys zu beschränken.
Berichtsverarbeitung
Daten automatisch aktualisieren
Die Berichtsdaten werden jedes Mal aktualisiert, wenn Sie die Berichtsdefinition aktualisieren.
Daten manuell aktualisieren
Diese Option kann verwendet werden, um Verzögerungen zu verhindern, die durch automatische Aktualisierungsvorgänge bei einem großen Datenvolumen verursacht werden.
Diese Auswahl zeigt an, dass die Berichtsdaten manuell aktualisiert werden müssen, wenn sich ein beliebiger Aspekt der Berichtskonfiguration verändert hat. Außerdem bedeutet dies, dass die Berichtstabelle bei jeder Änderung eines Aspekts der Konfiguration ausgeblendet wird.
Wenn dies ausgewählt ist, wird die Schaltfläche Daten laden (neben Bearbeiten im Bericht) angezeigt. Mithilfe von Daten laden werden die Daten geladen und die angezeigten Berichtsdaten werden aktualisiert.
Momentaufnahmen Sie können festlegen, wie oft Momentaufnahmen angefertigt werden sollen: täglich, stündlich oder gar nicht.
Die Schaltfläche Daten laden wird nur angezeigt, wenn Daten manuell aktualisieren unter Bearbeiten ausgewählt wurde.
Durch das Klicken auf Daten laden werden die Daten neu geladen und der angezeigte Beicht wird erneut geladen.
Die Auswahl von „Daten manuell aktualisieren“ bedeutet Folgendes:
Sobald Sie die Berichtkonfiguration ändern, wird die Tabelle der Berichtsdaten ausgeblendet.
Wenn Sie beispielsweise den Sortiermechanismus einer Spalte ändern, werden die Daten nicht angezeigt.
Wenn Sie möchten, dass die Berichtsdaten erneut angezeigt werden, müssen Sie zum erneuten Laden der Daten auf Daten laden klicken.
Wenn Sie den Bericht beenden, geschieht Folgendes:
Mit diesem Dialogfeld können Sie Ihren eigenen Titel und Ihre eigene Beschreibung für den resultierenden Bericht definieren oder aktualisieren.
Der Komponentenbericht stellt Informationen dazu bereit, wie Ihre Website die Komponenten verwendet.
Bedeutet, dass Sie zum Beispiel Folgendes sehen können:
Welche Komponenten wo verwendet werden
Dies ist beispielsweise bei Tests nützlich.
Wie Instanzen einer bestimmten Komponente verteilt sind
Dies kann interessant sein, wenn bei bestimmten Seiten (d. h. „umfangreichen Seiten“) Leistungsprobleme auftreten.
Teile der Website mit häufigen/weniger häufigen Veränderungen
Wie ein Seiteninhalt sich im Laufe der Zeit verändert
Alle Komponenten werden als Produktstandard und projektspezifisch einbezogen. Mithilfe des Dialogfelds Bearbeiten kann der Benutzer auch ein Stammverzeichnis festlegen, das den Startpunkt des Berichts definiert. Alle Komponenten unter diesem Stammverzeichnis werden für den Bericht berücksichtigt.
Der Bericht zur Speichernutzung zeigt Informationen zu den innerhalb Ihres Repositorys gespeicherten Daten an.
Der Bericht beginnt im Stamm ( / ) des Repositorys. Durch das Klicken auf einen bestimmten Zweig können Sie innerhalb des Repositorys einen Drilldown durchführen (der aktuelle Pfad wird im Berichtstitel wiedergegeben).
Dieser Bericht analysiert das aktuelle Anfrageprotokoll:
<cq-installation-dir>/crx-quickstart/logs/request.log
um Ihnen zu helfen, die teuersten Anforderungen innerhalb eines bestimmten Zeitraums zu identifizieren.
Zum Generieren des Berichts können Sie Folgendes Festlegen:
Zeitraum (Stunden)
Die Anzahl der zu analysierenden Stunden (Vergangenheit).
Standard: 24
max. Ergebnisse
Maximale Anzahl an Ausgabezeilen.
Standard: 50
max. Anforderungen
Maximale Anzahl der zu analysierenden Anforderungen.
Standard: -1
(alle)
E-Mail-Adresse
Ergebnisse an eine E-Mail-Adresse senden.
Optional; Standard: leer
Täglich ausführen um (hh:mm)
Geben Sie eine Zeit an, zu der der Bericht automatisch täglich ausgeführt werden soll.
Optional; Standard: leer
Im Seitenaktivitätsbericht werden die Seiten und die auf ihnen vorgenommenen Aktionen aufgeführt.
Bedeutet, dass Sie Folgendes überwachen können:
Der Seitenaktivitätsbericht bezieht alle Informationen aus dem Auditprotokoll. Standardmäßig ist der Stammpfad für das Prüfprotokoll unter /var/audit/com.day.cq.wcm.core.page
.
Dieser Bericht stellt Informationen zu benutzergenerierten Inhalten bereit – seien es Kommentare, Bewertungen oder Foren.
Damit können Sie:
Dieser Bericht bietet Informationen zu allen Benutzern, die sich mit einem Konto und/oder Profil registriert haben. Dies umfasst sowohl Autoren innerhalb Ihrer Organisation als auch externe Besucher
Spalten mit Informationen (sofern verfügbar) zu:
Damit können Sie:
Die Generische Spalte ist im Benutzerbericht verfügbar, sodass Sie auf benutzerdefinierte Informationen zugreifen können – in der Regel über die Benutzerprofile, wie zum Beispiel Lieblingsfarbe. Dies erfolgt, wie unter „Hinzufügen von Feldern zur Profildefinition“ erläutert.
Das Dialogfeld „Generische Spalte“ wird geöffnet, wenn Sie entweder:
Über die Registerkarte Definitionen können Sie Folgendes festlegen:
Titel
Ihr eigener Titel für die generische Spalte.
Eigenschaft
Der Eigenschaftsname, der im Repository gespeichert ist, normalerweise im Profil des Benutzers.
Pfad
Normalerweise wird die Eigenschaft aus dem profile
.
Typ
Wählen Sie den Feldtyp aus String
, Number
, Integer
, Date
.
Standardaggregat
Dies definiert das standardmäßig verwendete Aggregat, wenn die Gruppierung der Spalte in einem Bericht mit mindestens einer gruppierten Spalte aufgehoben wird. Wählen Sie das gewünschte Aggregat aus Count
, Minimum
, Average
, Maximum
, Sum
.
Beispiel: Count für String
-Feld bedeutet, dass die Anzahl der einzelnen String
-Werte für die Spalte im aggregierten Status angezeigt.
In der Spalte Erweitert können Sie außerdem die verfügbaren Zusammenfassungen und Filter festlegen:
Dies bietet Ihnen einen knappen Überblick und stellt Ihnen Informationen zu den einzelnen Instanzen der Workflows bereit – sowohl zu den laufenden als auch zu den abgeschlossenen.
Dies bedeutet, dass Sie:
Dies stellt wichtige Statistiken zu den auf Ihrer Instanz ausgeführten Workflows bereit.
Sobald Sie die Berichte für Ihre spezifischen Anforderungen konfiguriert haben, können Sie sie für die Übertragung der Konfiguration in die Veröffentlichungsumgebung aktivieren.
Wenn Sie frühere Daten für die Veröffentlichungsumgebung möchten, beenden Sie vor dem Aktivieren der Seite den Bericht in der Autorenumgebung.
Der entsprechende Bericht wird dann unter
/etc/reports
Der Bericht für benutzergenerierte Inhalte ist beispielsweise hier zu finden:
http://localhost:4503/etc/reports/ugcreport.html
In dem Bericht sind Daten enthalten, die aus einer Veröffentlichungsumgebung erfasst wurden.
Da in der Veröffentlichungsumgebung keine Berichtskonfiguration zulässig ist, sind die Schaltflächen Bearbeiten und Fertigstellen nicht verfügbar. Sie können allerdings den Zeitraum und das Intervall für die Berichte zu früheren Daten auswählen, wenn Momentaufnahmen erfasst werden.
Der Zugriff auf diese Berichte kann ein Sicherheitsproblem sein. Daher empfehlen wir, den Dispatcher so zu konfigurieren, dass /etc/reports
steht externen Besuchern nicht zur Verfügung. Weitere Informationen finden Sie unter Sicherheitscheckliste.
Die benötigten Berechtigungen hängen von der Aktion ab:
In einer standardmäßigen AEM-Installation werden die folgenden Berechtigungen für die Berichte voreingestellt:
Benutzerbericht
user administrators
- Lesen und Schreiben
Seitenaktivitätsbericht
contributors
- Lesen und Schreiben
Komponentenbericht
contributors
- Lesen und Schreiben
Bericht für benutzergenerierte Inhalte
contributors
- Lesen und Schreiben
Bericht der Workflow-Instanz
workflow-users
- Lesen und Schreiben
Alle Mitglieder der Gruppe administrators
verfügen über die erforderlichen Rechte zur Erstellung neuer Berichte.