Reporting reporting
Um Ihnen bei der Überwachung und Analyse des Status Ihrer Instanz zu helfen, bietet AEM eine Auswahl von Standardberichten, die für Ihre individuellen Anforderungen konfiguriert werden können:
Ü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 Instrumente Konsole. Auswählen Berichte im linken Bereich, dann Neu… aus der Symbolleiste. Definieren Sie eine Titel und Name, wählen Sie den gewünschten Berichtstyp aus und klicken Sie 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.
Die Grundlagen der Berichtsanpassung the-basics-of-report-customization
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 Konsistenzprüfung nutzt Auswahlfelder, um die Daten anzugeben, zu denen Sie einen Bericht erstellen möchten.
- Festplattenauslastung verwendet Links zum Drilldown in der Repository-Struktur.
- Workflow-Bericht bietet einen Überblick über die Workflows, die auf Ihrer Instanz ausgeführt werden.
Auswählen und Positionieren der Datenspalten selecting-and-positioning-the-data-columns
Spalten können zu allen Berichten hinzugefügt, neu positioniert oder aus ihnen entfernt werden, entweder standardmäßig oder individuell.
Die Komponenten im Sidekick (auf der Berichtsseite verfügbar) werden alle Datenkategorien aufgelistet, die als Spalten ausgewählt werden können.
So ändern Sie die Datenauswahl:
-
Ziehen Sie zum Hinzufügen einer neuen Spalte die erforderliche Komponente aus dem Sidekick und legen Sie sie in der gewünschten Position ab.
- Ein grünes Häkchen zeigt an, wann die Position gültig ist, und ein Pfeile zeigt genau an, wo sie platziert wird
- Ein rotes "No-go"-Symbol zeigt an, wenn die Position ungültig ist
-
Um eine Spalte zu verschieben, klicken Sie auf die Kopfzeile, halten Sie die Taste gedrückt und ziehen Sie sie an die neue Position
-
Um eine Spalte zu entfernen, klicken Sie auf den Spaltentitel, halten Sie die Maustaste gedrückt und ziehen Sie sie in den Berichtskopfbereich (ein rotes Minuszeichen weist darauf hin, dass die Position ungültig ist). Lassen Sie die Maustaste los und das Dialogfeld Komponente(n) löschen fordert eine Bestätigung dazu an, dass Sie die Spalte wirklich löschen möchten.
Dropdown-Menü "Spalte" column-drop-down-menu
Jede Spalte im Bericht 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.
Sortieren der Daten sorting-the-data
Die Daten können nach einer bestimmten Spalte sortiert werden:
- Durch das Klicken auf die jeweilige Spaltenkopfzeile wechselt die Sortierung von einer aufsteigenden zu einer absteigenden Sortierung, was durch eine Pfeilspitze direkt neben dem Titeltext angezeigt wird.
- die Dropdown-Menü der Spalte Wählen Sie entweder Aufsteigende Sortierung oder Absteigende Sortierung; erneut wird dies durch eine Pfeilspitze direkt neben dem Titeltext angezeigt
Gruppen und das aktuelle Datendiagramm groups-and-the-current-data-chart
In den entsprechenden Spalten können Sie Nach dieser Spalte gruppieren von Dropdown-Menü der Spalte. Dadurch werden die Daten nach jedem eindeutigen Wert in dieser Spalte gruppiert. Sie können mehrere Spalten auswählen, die gruppiert werden sollen. Die Option wird ausgegraut, wenn in der Spalte keine geeigneten 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.
Filter und Aggregate filters-and-aggregates
In den entsprechenden Spalten können Sie auch Filtereinstellungen und/oder Aggregate von Dropdown-Menü der Spalte.
Filter filters
Mit den Filtereinstellungen können Sie die Kriterien für die anzuzeigenden Einträge festlegen. Folgende Operatoren stehen zur Verfügung:
contains
equals
Sie können wie folgt einen Filter festlegen:
- Wählen Sie den gewünschten Operator aus der Dropdown-Liste aus.
- Geben Sie den Text ein, nach dem gefiltert werden soll.
- Klicken Sie auf Übernehmen.
So deaktivieren Sie den Filter:
- Entfernen Sie den Filtertext.
- Klicken Sie auf Übernehmen.
Aggregate aggregates
Sie können auch eine Zusammenfassungsmethode auswählen (diese können je nach ausgewählter Spalte variieren):
Spalteneigenschaften column-properties
Diese Option ist nur verfügbar, wenn Generische Spalte im Benutzerbericht verwendet wurde.
Frühere Daten historic-data
Eine Grafik der Änderungen Ihrer Daten im Zeitverlauf finden Sie unter Historische Daten. Dies wird aus regelmäßig durchgeführten Momentaufnahmen abgeleitet.
Die Daten sind:
- Wird, sofern verfügbar, von der ersten sortierten Spalte erfasst, andernfalls von der ersten (nicht gruppierten) Spalte
- Nach der entsprechenden Spalte gruppiert
Der Bericht kann wie folgt generiert werden:
-
Satz Gruppierung in der erforderlichen Spalte.
-
Bearbeiten die Konfiguration, mit der festgelegt wird, wie oft die Momentaufnahmen erstellt werden sollen; stündlich oder täglich.
-
Beenden… 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 Ab- und Bis-Daten für die angezeigten Berichtsdaten auswählen.
-
Intervall
Monat, Woche, Tag oder Stunde können für die Skalierung und Zusammenfassung des Berichts ausgewählt werden.
Wenn zum Beispiel für Februar 2011 tägliche Momentaufnahmen verfügbar sind:
- Wenn das Intervall auf
Day
festgelegt ist, wird jede Momentaufnahme als einzelner Wert im Diagramm angezeigt. - Wenn das Intervall auf
Month
festgelegt ist, werden alle Momentaufnahmen aus dem Monat Februar in einem einzelnen Wert zusammengefasst (der im Diagramm als einzelner „Punkt“ angezeigt wird).
- Wenn das Intervall auf
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 Momentaufnahmen erfasst werden, können Sie Folgendes tun:
-
Verwendung Beenden… erneut, um die Sammlung neu zu initialisieren.
Durch Beenden wird die Berichtsstruktur (d. h. die dem Bericht zugewiesenen Spalten und welche gruppiert, sortiert, gefiltert sind usw.) „eingefroren“. und beginnt mit der Aufnahme von Momentaufnahmen.
-
Öffnen Sie die Bearbeiten Dialogfeld auswählen Keine Daten-Momentaufnahmen , um 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.
/var/reports/...
gespeichert, wo der übrige Pfad den Pfad des jeweiligen Berichts sowie die bei der Fertigstellung des Berichts erstellte ID wiedergibt.Daily snapshots (repconf.hourofday)
für Day CQ Reporting Configuration festlegen. Unter OSGi-Konfiguration erhalten Sie weitere Informationen dazu, wie Sie dies konfigurieren können.Anzeigebeschränkungen display-limits
Der Bericht zu historischen Daten kann sich aufgrund von Beschränkungen, die je nach Anzahl der Ergebnisse für den ausgewählten Zeitraum festgelegt werden können, auch geringfügig ändern.
Jede horizontale Zeile wird als Reihe bezeichnet (und entspricht einem Eintrag in der Diagrammlegende) und jede vertikale Spalte von Punkten stellt die zusammengefassten Momentaufnahmen dar.
Um das Diagramm über längere Zeiträume hinweg sauber zu halten, können Einschränkungen festgelegt werden. Für die Standardberichte sind dies:
-
horizontale Reihe – Standardwert und Systemmaximum ist
9
-
vertikale zusammengefasste Momentaufnahmen – Standardwert ist
35
(pro horizontaler Reihe)
Wenn also die (entsprechenden) Grenzwerte überschritten werden, gilt Folgendes:
- werden die Punkte nicht angezeigt
- Die Legende für das historische Datendiagramm zeigt möglicherweise eine andere Anzahl von Einträgen als die des aktuellen Datendiagramms.
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).
Bearbeiten (Bericht) edit-report
Die Bearbeiten -Schaltfläche öffnet die Bericht bearbeiten Dialogfeld.
Dies ist ein Speicherort, an dem der Zeitraum für die Erfassung von Momentaufnahmen für frühere Daten festgelegt wird. Es können jedoch auch diverse andere Einstellungen festgelegt werden:
-
Titel
Sie können Ihren eigenen Titel festlegen.
-
Beschreibung
Sie können Ihre eigene Beschreibung festlegen.
-
Stammpfad (nur für bestimmte Berichte aktiv)
Verwenden Sie diese Einstellung, um den Bericht auf einen Abschnitt oder Unterabschnitt des Repositorys zu beschränken.
-
Berichtsverarbeitung
-
Daten automatisch aktualisieren
Die Berichtsdaten werden bei jeder Aktualisierung der Berichtsdefinition aktualisiert.
-
Daten manuell aktualisieren
Diese Option kann verwendet werden, um bei einer großen Datenmenge durch automatische Aktualisierungsvorgänge verursachte Verzögerungen zu verhindern.
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.
Daten laden load-data
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 Bericht wird aktualisiert.
Die Auswahl von „Daten manuell aktualisieren“ bedeutet Folgendes:
-
Sobald Sie die Berichtskonfiguration ändern, wird die Tabelle der Berichtsdaten ausgeblendet.
Wenn Sie beispielsweise den Sortiermechanismus einer Spalte ändern, werden die Daten nicht angezeigt.
-
Wenn die Berichtsdaten erneut angezeigt werden sollen, müssen Sie auf Daten laden , um die Daten neu zu laden.
Beenden (Bericht) finish-report
Wenn Sie Beenden Bericht:
- Die Berichtsdefinition ab diesem Zeitpunkt wird für die Aufnahme von Momentaufnahmen verwendet (anschließend können Sie weiter an einer Berichtsdefinition arbeiten, da sie dann von den Momentaufnahmen getrennt ist).
- Alle vorhandenen Momentaufnahmen werden entfernt.
- Neue Momentaufnahmen werden für die Historische Daten.
Mit diesem Dialogfeld können Sie Ihren eigenen Titel und Ihre eigene Beschreibung für den resultierenden Bericht definieren oder aktualisieren.
Berichtstypen report-types
Komponentenbericht component-report
Der Komponentenbericht stellt Informationen dazu bereit, wie Ihre Website die Komponenten verwendet.
- Autor
- Komponentenpfad
- Komponententyp
- Zuletzt geändert
- Seite
Mittel, das Sie beispielsweise sehen können:
-
Welche Komponenten werden dort verwendet?
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.
-
Identifizieren Sie Teile der Site mit häufigen/weniger häufigen Änderungen.
-
Erfahren Sie, wie sich der Seiteninhalt im Laufe der Zeit entwickelt.
Alle Komponenten sind enthalten, dem Produktstandard und dem Projekt entsprechend. Mithilfe des Dialogfelds Bearbeiten kann der Benutzer auch einen Stammpfad festlegen, der den Startpunkt des Berichts definiert. Alle Komponenten unter diesem Stammpfad werden für den Bericht berücksichtigt.
Speichernutzung disk-usage
Der Bericht zur Festplattenauslastung zeigt Informationen zu den in Ihrem Repository 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).
Konsistenzprüfung health-check
Dieser Bericht analysiert das aktuelle Anforderungsprotokoll
<cq-installation-dir>/crx-quickstart/logs/request.log
,
um Ihnen zu helfen, die aufwändigsten Anforderungen innerhalb eines bestimmten Zeitraums zu identifizieren.
Zum Generieren des Berichts können Sie Folgendes festlegen:
-
Zeitraum (Stunden)
Die zu analysierende Anzahl von (vergangenen) Stunden.
Standard:
24
-
max. Ergebnisse
Maximale Anzahl an Ausgabezeilen.
Standard:
50
-
max. Anforderungen
Maximale Anzahl an zu analysierenden Anforderungen.
Standard:
-1
(alle) -
E-Mail-Adresse
Senden Sie die Ergebnisse an eine E-Mail-Adresse.
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
Seitenaktivitätsbericht page-activity-report
Im Seitenaktivitätsbericht werden die Seiten und die auf ihnen vorgenommenen Aktionen aufgeführt.
- Seite
- Zeit
- Typ
- Benutzer
Das bedeutet, dass Sie überwachen können:
- Die neuesten Änderungen.
- Autoren, die auf bestimmten Seiten arbeiten.
- Seiten, die in letzter Zeit nicht geändert wurden, sodass möglicherweise Handlungsbedarf besteht.
- Seiten, die am häufigsten/am seltensten geändert werden.
- Die meisten/am wenigsten aktiven Benutzer.
Der Seitenaktivitätsbericht übernimmt alle Informationen aus dem Auditprotokoll. Standardmäßig wird der Stammpfad im Administratorprotokoll unter /var/audit/com.day.cq.wcm.core.page
konfiguriert.
Bericht für benutzergenerierte Inhalte user-generated-content-report
Dieser Bericht stellt Informationen zu benutzergenerierten Inhalten bereit – seien es Kommentare, Bewertungen oder Foren.
Spalten mit Informationen auf:
- Datum
- IP-Adresse
- Seite
- Referrer
- Typ
- Benutzer Kennung
Ermöglicht Ihnen Folgendes:
- Ermitteln Sie, welche Seiten die meisten Kommentare erhalten.
- Einen Überblick über alle Kommentare gewinnen, die bestimmte Besucher der Website hinterlassen, und ob die Themen miteinander zusammenhängen
- Beurteilen, ob neue Inhalte Kommentare zur Folge haben, indem überwacht wird, wann Kommentare auf einer Seite vorgenommen werden
Benutzerbericht user-report
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) über:
- Alter
- Land
- Domain
- Nachname
- Geschlecht
- Generisch
- Vorname
- Info
- Interesse
- Sprache
- NTLM-Hashcode
- Benutzer-ID
Ermöglicht Ihnen Folgendes:
- Sehen Sie die demografische Ausbreitung Ihrer Benutzer.
- Berichte zu benutzerdefinierten Feldern, die Sie den Profilen hinzugefügt haben.
Allgemeine Spalte generic-column
Die Generisch -Spalte ist im Benutzerbericht verfügbar, sodass Sie auf benutzerdefinierte Informationen zugreifen können, die normalerweise über die Benutzerprofile; Beispiel: Favoritenfarbe, wie unter Felder zur Profildefinition hinzufügen beschrieben.
Das Dialogfeld Generische Spalte wird geöffnet, wenn Sie entweder:
- Ziehen Sie die Komponente "Generisch"aus dem Sidekick in den Bericht.
- Wählen Sie die Spalteneigenschaften für eine vorhandene generische Spalte aus.
Über die Registerkarte Definitionen können Sie Folgendes festlegen:
-
Titel
Ihr eigener Titel für die generische Spalte.
-
Eigenschaft
Der Name der Eigenschaft wie er im Repository gespeichert wird, in der Regel innerhalb des Benutzerprofils.
-
Pfad
Diese Eigenschaft wird in der Regel aus
profile
entnommen. -
Typ
Wählen Sie den Feldtyp als
String
,Number
,Integer
oderDate
aus. -
Standardaggregat
Dies legt die standardmäßig verwendete Zusammenfassung fest, wenn die Spalte in einem Bericht mit mindestens einer gruppierten Spalte nicht gruppiert ist. Wählen Sie die gewünschte Zusammenfassung als
Count
,Minimum
,Average
,Maximum
oderSum
aus.Anzahl bedeutet bei einem
String
-Feld zum Beispiel, dass die Anzahl der einzelnenString
-Werte für die Spalte im zusammengefassten Zustand angezeigt wird.
In der Spalte Erweitert können Sie außerdem die verfügbaren Zusammenfassungen und Filter festlegen:
Bericht der Workflow-Instanz workflow-instance-report
Auf diese Weise erhalten Sie einen kurzen Überblick über die einzelnen Instanzen von Workflows, die sowohl ausgeführt als auch abgeschlossen werden.
- Abgeschlossen
- Dauer
- Initiator
- Modell
- Payload
- Gestartet
- Status
Sie können Folgendes tun:
- Überwachen der durchschnittlichen Dauer von Workflows; Wenn dies regelmäßig geschieht, können Probleme mit dem Workflow hervorgehoben werden.
Workflow-Bericht workflow-report
Dieser Bericht stellt wichtige Statistiken zu den auf Ihrer Instanz ausgeführten Workflows bereit.
Verwenden von Berichten in einer Veröffentlichungsumgebung using-reports-in-a-publish-environment
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.
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 Beenden 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.
/etc/reports
für externe Besucher nicht verfügbar ist. Weitere Informationen finden Sie unter Sicherheitscheckliste.Für die Ausführung von Berichten erforderliche Berechtigungen permissions-needed-for-running-reports
Die benötigten Berechtigungen hängen von der Aktion ab:
- Berichtsdaten werden im Grunde mit den Berechtigungen des aktuellen Benutzers erfasst.
- Historische Daten werden mit den Berechtigungen des Benutzers erfasst, der den Bericht abgeschlossen hat.
In einer standardmäßigen AEM-Installation sind 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.