Rapportering reporting
För att hjälpa dig att övervaka och analysera instansens tillstånd finns AEM ett urval av standardrapporter som kan konfigureras för dina individuella krav:
Alla rapporter finns på verktyg konsol. Välj Rapporter i den vänstra rutan dubbelklickar du på önskad rapport i den högra rutan för att öppna den för visning och/eller konfiguration.
Nya instanser av en rapport kan också skapas från verktyg konsol. Välj Rapporter i den vänstra rutan och Nytt… i verktygsfältet. Definiera en Titel och Namn, väljer den rapporttyp som du behöver och klickar sedan på Skapa. Den nya rapportinstansen visas i listan. Dubbelklicka på det här för att öppna och dra sedan en komponent från sidosparken för att skapa den första kolumnen och starta rapportdefinitionen.
Grunderna i anpassning av rapporter the-basics-of-report-customization
Det finns olika format för rapporter. I följande rapporter används kolumner som kan anpassas enligt följande avsnitt:
- Hälsokontroll använder urvalsfält för att ange data som du vill rapportera om.
- Diskanvändning använder länkar för att gå igenom databasstrukturen.
- Arbetsflödesrapport ger en översikt över arbetsflödena som körs på instansen.
Markera och placera datakolumner selecting-and-positioning-the-data-columns
Kolumner kan läggas till, flyttas på eller tas bort från alla rapporter, antingen som standard eller anpassade.
The Komponenter -fliken (som är tillgänglig på rapportsidan) listar alla datakategorier som kan markeras som kolumner.
Så här ändrar du datamarkeringen:
-
om du vill lägga till en ny kolumn drar du den nödvändiga komponenten från sidosparken och släpper den på önskad plats
- en grön bock visar när positionen är giltig och ett par pilar anger exakt var den kommer att placeras
- en röd no go-symbol anger när positionen är ogiltig
-
om du vill flytta en kolumn klickar du på rubriken, håller ned och drar till den nya positionen
-
Om du vill ta bort en kolumn klickar du på kolumnrubriken, håller ned och drar uppåt i rapportrubrikområdet (ett rött minustecken anger att positionen inte är giltig). släpper du musknappen så begär dialogrutan Ta bort komponent(er) en bekräftelse på att du verkligen vill ta bort kolumnen.
Nedrullningsbar meny för kolumn column-drop-down-menu
Varje kolumn i rapporten har en nedrullningsbar meny. Detta visas när muspekaren flyttas över kolumntitelcellen.
En pilspets visas längst till höger i rubrikcellen (ska inte blandas ihop med pilhuvudet direkt till höger om den titeltext som anger aktuell sorteringsmekanism).
Vilka alternativ som är tillgängliga på menyn beror på hur kolumnen är konfigurerad (vilket sker under projektutvecklingen). Alla ogiltiga alternativ är nedtonade.
Sortera data sorting-the-data
Data kan sorteras efter en viss kolumn genom att antingen:
- klicka på lämplig kolumnrubrik, sorteringen växlar mellan stigande och fallande, vilket anges med en pilspets omedelbart intill titeltexten
- använder kolumnens nedrullningsbara meny för att välja Sortera stigande eller Sortera fallande; detta markeras med en pilspets omedelbart intill rubriktexten
Grupper och det aktuella dataramarmet groups-and-the-current-data-chart
I lämpliga kolumner kan du välja Gruppera efter den här kolumnen från kolumnens nedrullningsbara meny. Detta grupperar data efter varje distinkt värde i den kolumnen. Du kan markera mer än en kolumn som ska grupperas. Alternativet kommer att tonas ned när uppgifterna i kolumnen inte är lämpliga. Det vill säga att alla poster är distinkta och unika så att inga grupper kan formas, till exempel kolumnen Användar-ID i användarrapporten.
Efter att minst en kolumn har grupperats i ett cirkeldiagram över Aktuella data kommer att genereras baserat på den här grupperingen. Om flera kolumner är grupperade, visas även detta i diagrammet.
Om du för markören över cirkeldiagrammet visas det sammanlagda värdet för det aktuella segmentet. Här används den mängd som för närvarande är definierad för kolumnen. t.ex. antal, minimum, genomsnitt, bland annat.
Filter och aggregat filters-and-aggregates
I lämpliga kolumner kan du även konfigurera Filterinställningar och/eller Aggregat från kolumnens nedrullningsbara meny.
Filter filters
Med Filterinställningar kan du ange villkor för poster som ska visas. De tillgängliga operatorerna är:
contains
equals
Så här anger du ett filter:
- Välj den operator som du vill använda i listrutan.
- Ange texten som ska filtreras.
- Klicka Använd.
Så här inaktiverar du filtret:
- Ta bort filtertexten.
- Klicka Använd.
Aggregat aggregates
Du kan också välja en aggregeringsmetod (dessa kan variera beroende på vilken kolumn som är vald):
Kolumnegenskaper column-properties
Det här alternativet är bara tillgängligt när Allmän kolumn har använts i Användarrapport.
Historiska data historic-data
En tabell över hur data ändras över tid finns nedan Historiska data. Detta kommer från ögonblicksbilder som tagits med regelbundna intervall.
Data:
- Insamlat av, om tillgängligt, den första sorterade kolumnen, i annat fall den första kolumnen (icke-grupperad)
- Grupperad efter lämplig kolumn
Rapporten kan genereras:
-
Ange Gruppering i den obligatoriska kolumnen.
-
Redigera konfigurationen för att definiera hur ofta ögonblicksbilderna ska göras, Varje timme eller dag.
-
Slutför… Definitionen som startar samlingen av ögonblicksbilder.
Den röda/gröna reglageknappen längst upp till vänster anger när ögonblicksbilder samlas in.
Det resulterande diagrammet visas längst ned till höger:
När datainsamlingen har startat kan du välja:
-
Period
Du kan välja från- och till-datum för rapportdata som ska visas.
-
Intervall
Månad, Vecka, Dag, Timme kan väljas för rapportens skala och aggregering.
Om det t.ex. finns dagliga ögonblicksbilder för februari 2011:
- Om intervallet är inställt på
Day
visas varje fixering som ett värde i diagrammet. - Om intervallet är inställt på
Month
, sammanställs alla ögonblicksbilder för februari till ett enda värde (visas som en enda punkt i diagrammet).
- Om intervallet är inställt på
Välj dina behov och klicka sedan på Gå för att tillämpa dem på rapporten. Om du vill uppdatera visningen när fler ögonblicksbilder har gjorts klickar du på Gå igen.
När ögonblicksbilder samlas in kan du:
-
Använd Slutför… igen för att initiera om samlingen.
Slutför "fryser" rapportens struktur (dvs. de kolumner som tilldelats rapporten och som grupperas, sorteras, filtreras osv.) och börjar ta ögonblicksbilder.
-
Öppna Redigera dialogruta att välja Inga ögonblicksbilder av data för att avsluta insamlingen tills det krävs.
Redigera aktiverar eller inaktiverar bara tagning av ögonblicksbilder. Om ögonblicksbilder aktiveras igen används rapportens tillstånd när den senast var klar för att ta ytterligare ögonblicksbilder.
/var/reports/...
där resten av sökvägen speglar sökvägen för respektive rapport och ID som skapades när rapporten var klar.Daily snapshots (repconf.hourofday)
parameter för Konfiguration av CQ-rapportering dag; se OSGI-konfiguration om du vill ha mer information om hur du konfigurerar det här.Visningsgränser display-limits
Rapporten med historiska data kan också ändra utseendet något på grund av begränsningar som kan anges enligt antalet resultat för den valda perioden.
Varje vågrät linje kallas en serie (och motsvarar en post i teckenförklaringen). Varje lodrät punktkolumn representerar de aggregerade fixeringarna.
För att hålla diagrammet rent under längre tidsperioder finns det begränsningar som kan anges. Följande gäller för standardrapporterna:
-
vågrät serie - både standard- och systemmaximum är
9
-
lodräta aggregerade ögonblicksbilder - standard är
35
(per horisontella serier)
Så när (lämpliga) gränser överskrids:
- punkterna inte visas
- teckenförklaringen för det historiska datatecknet kan visa ett annat antal poster än det aktuella datatecknet
Anpassade rapporter kan även visa Totalt värde för alla serier. Detta visas som en serie (vågrät linje och post i teckenförklaringen).
Redigera (rapport) edit-report
The Redigera knappen öppnar Redigera rapport Dialogruta.
Detta är en plats där perioden för insamling av ögonblicksbilder för Historiska data är definierad, men olika andra inställningar kan också definieras:
-
Titel
Du kan definiera en egen titel.
-
Beskrivning
Du kan definiera en egen beskrivning.
-
Rotsökväg (endast aktiv för vissa rapporter)
Använd det här om du vill begränsa rapporten till en (under) del av databasen.
-
Rapportbearbetning
-
uppdatera data automatiskt
Rapportdata uppdateras varje gång du uppdaterar rapportdefinitionen.
-
uppdatera data manuellt
Det här alternativet kan användas för att förhindra fördröjningar som orsakas av automatiska uppdateringsåtgärder när det finns stora datamängder.
Om du väljer det här alternativet måste rapportdata uppdateras manuellt när någon aspekt av rapportkonfigurationen har ändrats. Det innebär också att så snart du ändrar någon aspekt av konfigurationen kommer rapporttabellen att tas bort.
När det här alternativet är markerat visas Läs in data knappen visas (bredvid Redigera på rapporten). Läs in data läser in data och uppdaterar rapportdata som visas.
-
-
Fixeringar
Du kan definiera hur ofta ögonblicksbilder ska tas; varje dag, timme eller inte alls.
Läs in data load-data
The Läs in data knappen visas bara när uppdatera data manuellt har valts från Redigera.
Klicka på Läs in data läser in data igen och uppdaterar rapporten som visas.
Om du väljer att uppdatera data manuellt innebär det att:
-
Så snart du ändrar rapportkonfigurationen tas rapportdatatabellen bort.
Om du t.ex. ändrar sorteringsmekanismen för en kolumn visas inte data.
-
Om du vill att rapportdata ska visas igen måste du klicka på Läs in data för att läsa in data igen.
Slutför (rapport) finish-report
När du Slutför rapporten:
- Rapportdefinitionen vid den tidpunkten används för att ta ögonblicksbilder (därefter kan du fortsätta arbeta med en rapportdefinition eftersom den sedan är åtskild från ögonblicksbilderna).
- Alla befintliga ögonblicksbilder tas bort.
- Nya ögonblicksbilder samlas in för Historiska data.
I den här dialogrutan kan du definiera, eller uppdatera, din egen titel och beskrivning för den resulterande rapporten.
Rapporttyper report-types
Komponentrapport component-report
Komponentrapporten innehåller information om hur din webbplats använder komponenterna.
- Författare
- Komponentsökväg
- Komponenttyp
- Senast ändrad
- Sida
Betydelse som du kan se, till exempel:
-
Vilka komponenter som används där.
Användbar, till exempel vid testning.
-
Hur instanser av en viss komponent distribueras.
Detta kan vara intressant om vissa sidor (t.ex. "stora sidor") har prestandaproblem.
-
Identifiera delar av sajten med frekventa/mindre frekventa ändringar.
-
Se hur sidinnehåll utvecklas över tid.
Alla komponenter ingår, som är standard och projektspecifika. Använda Redigera kan användaren också ange en Rotsökväg som definierar rapportens startpunkt - alla komponenter under den roten beaktas för rapporten.
Diskanvändning disk-usage
Diskanvändningsrapporten innehåller information om de data som lagras i databasen.
Rapporten börjar i databasens rot ( / ); genom att klicka på en viss gren kan du gå ned i databasen (den aktuella sökvägen visas i rapportrubriken).
Hälsokontroll health-check
Den här rapporten analyserar den aktuella begärandeloggen:
<cq-installation-dir>/crx-quickstart/logs/request.log
för att hjälpa dig att identifiera de mest dyra förfrågningarna inom en viss period.
Så här skapar du rapporten:
-
Period (timmar)
Antalet timmar (tidigare) som ska analyseras.
Standard:
24
-
max. Resultat
Maximalt antal utdatarader.
Standard:
50
-
max. Begäranden
Maximalt antal begäranden som ska analyseras.
Standard:
-1
(all) -
E-postadress
Skicka resultat till en e-postadress.
Valfritt Standard: blank
-
Kör dagligen (hh:mm)
Ange en tidpunkt då rapporten ska köras automatiskt varje dag.
Valfritt Standard: blank
Sidaktivitetsrapport page-activity-report
Sidaktivitetsrapporten innehåller en lista över sidor och åtgärder som har utförts på dem.
- Sida
- Tid
- Typ
- Användare
Betydelse som du kan övervaka:
- De senaste ändringarna.
- Författare som arbetar med specifika sidor.
- Sidor som inte har ändrats nyligen kan behöva åtgärdas.
- Sidor som ändras oftast eller oftast.
- De flesta/minst aktiva användarna.
Sidaktivitetsrapporten hämtar all information från granskningsloggen. Som standard är rotsökvägen konfigurerad till granskningsloggen på /var/audit/com.day.cq.wcm.core.page
.
Användargenererad innehållsrapport user-generated-content-report
Denna rapport innehåller information om användargenererat innehåll; vara kommentarer, omdömen eller forum.
Informationskolumner den:
- Datum
- IP-adress
- Sida
- Referent
- Typ
- Användar-ID
Tillåt dig att:
- Se vilka sidor som får flest kommentarer.
- Få en översikt över alla kommentarer som specifika besökare lämnar webbplatsen, kanske problemen är relaterade.
- Se om nytt innehåll ger upphov till kommentarer genom att övervaka när kommentarer görs på en sida.
Användarrapport user-report
Denna rapport innehåller information om alla användare som har registrerat ett konto och/eller en profil. detta kan omfatta både författare inom organisationen och externa besökare.
Informationskolumner (om tillgängligt) om:
- Ålder
- Land
- Domän
- E-post
- Efternamn
- Kön
- Allmän
- Förnamn
- Info
- Ränta
- Språk
- NTLM Hashcode
- Användar-ID
Tillåt dig att:
- Se användarnas demografiska spridning.
- Rapportera om anpassade fält som du har lagt till i profilerna.
Allmän kolumn generic-column
The Allmän -kolumnen är tillgänglig i användarrapporten så att du kan komma åt anpassad information, vanligtvis från användarprofiler; till exempel Favoritfärg enligt beskrivningen i Lägg till fält i profildefinitionen.
Dialogrutan Allmän kolumn öppnas när du antingen:
- Dra den allmänna komponenten från sidosparken till rapporten.
- Markera kolumnegenskaperna för en befintlig allmän kolumn.
Från Definitioner -flik som du kan definiera:
-
Titel
Din egen rubrik för den generiska kolumnen.
-
Egenskap
Egenskapsnamnet som lagrats i databasen, vanligtvis i användarens profil.
-
Bana
Vanligtvis hämtas egenskapen från
profile
. -
Typ
Välj fälttyp från
String
,Number
,Integer
,Date
. -
Standardaggregering
Detta definierar den mängd som används som standard om kolumnen delas upp i en rapport med minst en grupperad kolumn. Välj önskad mängd från
Count
,Minimum
,Average
,Maximum
,Sum
.Till exempel: Antal för
String
fält betyder att antalet distinktaString
värden visas för kolumnen i aggregerat läge.
I Utökad kan du även definiera de aggregat och filter som är tillgängliga:
Instansrapport för arbetsflöde workflow-instance-report
Detta ger en kortfattad översikt som ger information om de enskilda instanserna av arbetsflöden, både som körs och slutförda.
- Slutförd
- Varaktighet
- Initierare
- Modell
- Nyttolast
- Startat
- Status
Betyder att du kan:
- övervaka arbetsflödenas genomsnittliga varaktighet, om detta händer regelbundet kan det lyfta fram problem med arbetsflödet.
Arbetsflödesrapport workflow-report
Här finns viktig statistik om arbetsflödena som körs på instansen.
Använda rapporter i en publiceringsmiljö using-reports-in-a-publish-environment
När du har konfigurerat rapporterna efter dina specifika krav kan du aktivera dem för att överföra konfigurationen till publiceringsmiljön.
Den lämpliga rapporten finns sedan tillgänglig under
/etc/reports
Rapporten User Generated Content finns under:
http://localhost:4503/etc/reports/ugcreport.html
Nu rapporteras data som samlats in från publiceringsmiljön.
Eftersom ingen rapportkonfiguration tillåts i publiceringsmiljön, Redigera och Slutför är inte tillgängliga. Du kan dock välja Period och Intervall för Historiska data rapporterar om ögonblicksbilder samlas in.
/etc/reports
är inte tillgängligt för externa besökare. Se Säkerhetschecklista för mer information.Behörigheter krävs för att köra rapporter permissions-needed-for-running-reports
Behörigheterna som krävs beror på åtgärden:
- Rapportdata samlas i princip in med den aktuella användarens behörighet.
- Historiska data samlas in med behörigheten för användaren som slutförde rapporten.
I en AEM är följande behörigheter förinställda för rapporterna:
-
Användarrapport
user administrators
- läsa och skriva -
Sidaktivitetsrapport
contributors
- läsa och skriva -
Komponentrapport
contributors
- läsa och skriva -
Användargenererad innehållsrapport
contributors
- läsa och skriva -
Instansrapport för arbetsflöde
workflow-users
- läsa och skriva
Alla medlemmar i administrators
gruppen har de rättigheter som krävs för att skapa nya rapporter.