Rapportering

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:

OBSERVERA

Rapporterna är bara tillgängliga i det klassiska användargränssnittet. Systemövervakning och rapportering i det moderna användargränssnittet finns i Operations Dashboard.

Alla rapporter kan nås från Verktyg-konsolen. Välj Rapporter i den vänstra rutan och dubbelklicka sedan 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 konsolen Verktyg. Välj Rapporter i den vänstra rutan och Nytt… från verktygsfältet. Definiera en titel och Namn, välj den rapporttyp som du behöver och klicka 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.

OBSERVERA

Förutom de AEM standardrapporter som finns tillgängliga direkt kan du utveckla egna (helt nya) rapporter.

Grunderna i anpassning av rapporter

Det finns olika format för rapporter. I följande rapporter används kolumner som kan anpassas enligt följande avsnitt:

OBSERVERA

Följande rapporter har sina egna format och anpassningar:

  • Hälsokontroller använder urvalsfält för att ange data som du vill rapportera om.
  • Disk Usageanvänder länkar för att gå igenom databasstrukturen.
  • Arbetsflödesrapporter ger en översikt över arbetsflödena som körs på instansen.

Följande procedurer för kolumnkonfiguration är därför inte lämpliga. Mer information finns i beskrivningarna av de enskilda rapporterna.

Markera och placera datakolumner

Kolumner kan läggas till, flyttas på eller tas bort från alla rapporter, antingen som standard eller anpassade.

Fliken Komponenter i sidosparken (som finns 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

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 titelcellen (ska inte blandas ihop med pilhuvudet direkt till höger om den titeltext som anger aktuell sorteringsmekanism).

reportcolumnsort

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

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änd listrutan för kolumnen för att välja antingen Sortera stigande eller Sortera fallande; detta markeras med en pilspets omedelbart intill rubriktexten

Grupper och det aktuella datatabellen

I lämpliga kolumner kan du välja Gruppera efter den här kolumnen i listrutan för kolumnen. 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.

När minst en kolumn har grupperats kommer ett cirkeldiagram av Aktuella data att genereras baserat på den här grupperingen. Om flera kolumner är grupperade, visas även detta i diagrammet.

reportuser

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

I lämpliga kolumner kan du även konfigurera Filterinställningar och/eller Aggregat i listrutan för kolumnen.

Filter

Med Filterinställningar kan du ange villkor för poster som ska visas. De tillgängliga operatorerna är:

  • contains
  • equals

reportfilter

Så här anger du ett filter:

  1. Välj den operator som du vill använda i listrutan.
  2. Ange texten som ska filtreras.
  3. Klicka på Använd.

Så här inaktiverar du filtret:

  1. Ta bort filtertexten.
  2. Klicka på Använd.

Aggregat

Du kan också välja en aggregeringsmetod (dessa kan variera beroende på vilken kolumn som är vald):

reportagregate

Kolumnegenskaper

Det här alternativet är endast tillgängligt när den allmänna kolumnen har använts i användarrapporten.

Historiska data

Ett diagram över dataändringar över tid finns under 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:

  1. Ange Gruppering för den obligatoriska kolumnen.

  2. Ändra konfigurationen för att definiera hur ofta ögonblicksbilder ska tas. Varje timme eller dag.

  3. 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:

reportrens

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).

Välj dina krav och klicka sedan på för att tillämpa dem på rapporten. Om du vill uppdatera visningen när fler ögonblicksbilder har gjorts klickar du på igen.

chlimage_1-43

När ögonblicksbilder samlas in kan du:

  • Använd Slutför… igen för att initiera om samlingen.

    Slutför rapportens struktur (dvs. kolumnerna som tilldelats rapporten och som grupperas, sorteras, filtreras osv.) och börjar ta ögonblicksbilder.

  • Öppna dialogrutan Redigera och välj Inga datarappningar för att avsluta samlingen tills det behövs.

    Med Redigeraren aktiveras eller inaktiveras tagningen av ögonblicksbilder. Om ögonblicksbilder aktiveras igen används rapportens tillstånd när den senast var klar för att ta ytterligare ögonblicksbilder.

OBSERVERA

Ögonblicksbilder lagras under /var/reports/..., där resten av sökvägen speglar sökvägen för respektive rapport och ID som skapades när rapporten slutfördes.

Gamla ögonblicksbilder kan rensas manuellt om du är helt säker på att du inte längre behöver dessa förekomster.

OBSERVERA

De förkonfigurerade rapporterna är inte prestandakrävande, men det rekommenderas ändå att du använder dagliga ögonblicksbilder i en produktionsmiljö. Om möjligt kan du köra dessa dagliga ögonblicksbilder vid en tidpunkt på dagen när det inte finns mycket aktivitet på din webbplats. detta kan definieras med parametern Daily snapshots (repconf.hourofday) för Day CQ Reporting Configuration; Mer information om hur du konfigurerar detta finns i OSGI Configuration.

Visningsgränser

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.

chlimage_1-44

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 vågrät serie)

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

chlimage_1-45

Anpassade rapporter kan även visa Totalt-värdet för alla serier. Detta visas som en serie (vågrät linje och post i teckenförklaringen).

OBSERVERA

För anpassade rapporter kan gränserna anges på ett annat sätt.

Redigera (rapport)

Knappen Redigera öppnar dialogrutan Redigera rapport.

Detta är en plats där perioden för insamling av ögonblicksbilder för historiska data har definierats, men olika andra inställningar kan också definieras:

reportedit

  • 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 detta är markerat visas knappen Läs in data (bredvid Redigera i rapporten). Läs in data läser in data och uppdaterar rapportdata som visas.

  • ÖgonblicksbilderDu kan definiera hur ofta ögonblicksbilder ska tas.
    varje dag, timme eller inte alls.

Läs in data

Knappen Läs in data visas bara när uppdatera data manuellt har valts i Redigera.

chlimage_1-46

Om du klickar på Läs in data läses data in igen och rapporten uppdateras.

Om du väljer att uppdatera data manuellt innebär det att:

  1. Så snart du ändrar rapportkonfigurationen tas rapportdatatabellen bort.

    Om du t.ex. ändrar sorteringsmekanismen för en kolumn visas inte data.

  2. 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)

När du slutför rapporten:

  • Rapportdefinitionen från och med den tidpunkten kommer att användas 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.

reportfinish

Rapporttyper

Komponentrapport

Komponentrapporten innehåller information om hur din webbplats använder komponenterna.

Kolumner med information om:

  • Författare
  • Komponentsökväg
  • Komponenttyp
  • Senast ändrad
  • Sidan

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. Med dialogrutan Redigera kan användaren även ange en rotsökväg som definierar rapportens startpunkt. Alla komponenter under den roten beaktas för rapporten.

rapportkomponentrapportcompentall

Diskanvändning

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).

diskus

Hälsokontroll

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 (alla)

  • 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

reporthealth

Sidaktivitetsrapport

Sidaktivitetsrapporten innehåller en lista över sidor och åtgärder som har utförts på dem.

Kolumner med information om:

  • Sidan
  • Time
  • 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.

reportpageaktivitet

Användargenererad innehållsrapport

Denna rapport innehåller information om användargenererat innehåll; vara kommentarer, omdömen eller forum.

Kolumner med information om:

  • Date
  • IP-adress
  • Sidan
  • 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.

reportusercontent

Användarrapport

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 sådana finns) om:

  • Ålder
  • Land
  • Domän
  • E-post
  • Efternamn
  • Kön
  • Allmän
  • Förnamn
  • Information
  • 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.

reportusercanned

Allmän kolumn

Kolumnen Allmän är tillgänglig i användarrapporten så att du kan komma åt anpassad information, vanligtvis från användarprofiler; t.ex. Favoritfärg enligt beskrivningen under 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.

reportusrgenericcolm

På fliken Definitioner kan du 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.

    Exempel: Antal för ett String-fält betyder att antalet distinkta String-värden visas för kolumnen i aggregerat läge.

På fliken Extended kan du även definiera de aggregat och filter som är tillgängliga:

reportusrgenericcolmextented

Instansrapport för arbetsflöde

Detta ger en kortfattad översikt som ger information om de enskilda instanserna av arbetsflöden, både som körs och slutförda.

Kolumner med information om:

  • 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.

reportworkflowintance

Arbetsflödesrapport

Här finns viktig statistik om arbetsflödena som körs på instansen.

rapportarbetsflöde

Använda rapporter i en publiceringsmiljö

När du har konfigurerat rapporterna efter dina specifika krav kan du aktivera dem för att överföra konfigurationen till publiceringsmiljön.

FÖRSIKTIGHET

Om du vill historikdata för publiceringsmiljön slutför rapporten om redigeringsmiljön innan du aktiverar sidan.

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 är knapparna Redigera och Slutför inte tillgängliga. Du kan dock välja Period och Intervall för Historiska data-rapporter om ögonblicksbilder samlas in.

rapportersucgpublish

FÖRSIKTIGHET

Tillgång till dessa rapporter kan vara en säkerhetsfråga. Därför rekommenderar vi att du konfigurerar Dispatcher så att /etc/reports inte är tillgängligt för externa besökare. Se Säkerhetschecklistan för mer information.

Behörigheter krävs för att köra rapporter

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 den behörighet som krävs för att skapa nya rapporter.

På denna sida