Per facilitare il monitoraggio e l’analisi dello stato dell’istanza, AEM fornisce una selezione di rapporti predefiniti, che possono essere configurati per le singole esigenze:
Questi rapporti sono disponibili solo nell’interfaccia classica. Per il monitoraggio e il reporting del sistema nell'interfaccia utente moderna, consulta la sezione Dashboard delle operazioni.
È possibile accedere a tutti i rapporti dalla console Strumenti . Seleziona Rapporti nel riquadro a sinistra, quindi fai doppio clic sul rapporto richiesto nel riquadro a destra per aprirlo in modalità di visualizzazione e/o configurazione.
È possibile creare nuove istanze di un rapporto anche dalla console Strumenti . Seleziona Rapporti nel riquadro a sinistra, quindi Nuovo… dalla barra degli strumenti. Definisci un Titolo e Nome, seleziona il tipo di rapporto richiesto, quindi fai clic su Crea. La nuova istanza di report verrà visualizzata nell'elenco. Fai doppio clic su questo per aprire, quindi trascina un componente dalla barra laterale per creare la prima colonna e avviare la definizione del rapporto.
Oltre ai report AEM standard disponibili, puoi sviluppare report personalizzati (completamente nuovi).
Sono disponibili diversi formati di rapporti. Nei rapporti seguenti vengono utilizzate tutte le colonne personalizzabili come descritto nelle sezioni seguenti:
I seguenti rapporti hanno ciascuno un proprio formato e personalizzazione:
Pertanto, le seguenti procedure per la configurazione delle colonne non sono appropriate. Per i dettagli, vedere le descrizioni dei singoli rapporti.
Le colonne possono essere aggiunte, riposizionate o rimosse da uno qualsiasi dei rapporti, sia standard che personalizzati.
La scheda Componenti della barra laterale (disponibile nella pagina del rapporto) elenca tutte le categorie di dati che possono essere selezionate come colonne.
Per modificare la selezione dei dati:
per aggiungere una nuova colonna, trascinate il componente richiesto dalla barra laterale e rilasciatelo nella posizione desiderata
per spostare una colonna, fai clic sull’intestazione, tieni premuto e trascina nella nuova posizione
per rimuovere una colonna, fai clic sul titolo della colonna, tieni premuto e trascina verso l’alto nell’area di intestazione del rapporto (un simbolo meno rosso indica che la posizione non è valida); rilascia il pulsante del mouse e la finestra di dialogo Elimina componenti per richiedere la conferma dell’eliminazione effettiva della colonna.
Ogni colonna del rapporto dispone di un menu a discesa. Questo diventa visibile quando il cursore del mouse si sposta sulla cella del titolo della colonna.
All'estrema destra della cella del titolo viene visualizzata una freccia (da non confondere con la freccia a destra del testo del titolo che indica il meccanismo di ordinamento corrente).
Le opzioni disponibili nel menu dipendono dalla configurazione della colonna (come apportata durante lo sviluppo del progetto), tutte le opzioni non valide saranno disattivate.
I dati possono essere ordinati in base a una colonna specifica in base a:
Nelle colonne appropriate è possibile selezionare Raggruppa per questa colonna dal menu a discesa della colonna 🔗. In questo modo i dati verranno raggruppati in base a ciascun valore distinto all’interno di tale colonna. È possibile selezionare più colonne da raggruppare. L’opzione sarà disattivata quando i dati nella colonna non sono appropriati; Ad esempio, ogni voce è distinta e univoca per cui non è possibile formare alcun gruppo, ad esempio la colonna ID utente del rapporto utente.
Dopo che almeno una colonna è stata raggruppata, in base a questo raggruppamento viene generato un grafico a torta di Dati correnti. Se sono raggruppate più colonne, questo sarà indicato anche nel grafico.
Spostando il cursore sul grafico a torta, viene visualizzato il valore aggregato per il segmento appropriato. Questo utilizza l’aggregato attualmente definito per la colonna; ad esempio, conteggio, minimo, media, tra gli altri.
Sulle colonne appropriate è inoltre possibile configurare Impostazioni filtro e/o Aggregati dal menu a discesa della colonna a5/>.
Le impostazioni filtro consentono di specificare i criteri per le voci da visualizzare. Gli operatori disponibili sono:
contains
equals
Per impostare un filtro:
Per disattivare il filtro:
Puoi anche selezionare un metodo di aggregazione (che può variare a seconda della colonna selezionata):
Questa opzione è disponibile solo quando la colonna Generica è stata utilizzata nel Rapporto utente.
Un grafico della modifica dei dati nel tempo può essere visualizzato in Dati storici. Questo è derivato da istantanee effettuate a intervalli regolari.
I dati sono:
Il rapporto può essere generato:
Imposta Raggruppamento sulla colonna richiesta.
Modifica la configurazione per definire la frequenza con cui devono essere effettuate le istantanee; ogni ora o ogni giorno.
Fine… la definizione per avviare la raccolta di istantanee.
Il pulsante di scorrimento rosso/verde in alto a sinistra indica quando vengono raccolte le istantanee.
Il grafico risultante viene visualizzato in basso a destra:
Una volta avviata la raccolta dei dati, puoi selezionare:
Periodo
Puoi selezionare le date di inizio e fine per i dati del rapporto da visualizzare.
Intervallo
È possibile selezionare Mese, Settimana, Giorno, Ora per la scala e l’aggregazione del rapporto.
Ad esempio, se per febbraio 2011 sono disponibili istantanee giornaliere:
Day
, ogni istantanea viene visualizzata come un singolo valore nel grafico.Month
, tutte le istantanee di febbraio vengono aggregate in un singolo valore (visualizzato come un singolo "punto" nel grafico).Seleziona i requisiti, quindi fai clic su Vai per applicarli al rapporto. Per aggiornare la visualizzazione dopo ulteriori istantanee, fare di nuovo clic su Vai.
Quando vengono raccolte le istantanee, puoi:
Usa Fine… per reinizializzare la raccolta.
Fine : consente di "congelare" la struttura del rapporto (ovvero le colonne assegnate al rapporto e raggruppate, ordinate, filtrate, ecc.) e inizia a scattare istantanee.
Apri la finestra di dialogo Modifica per selezionare Nessuna istantanea di dati per terminare la raccolta finché non richiesto.
Editonly attiva o disattiva la ripresa delle istantanee. Se si riattiva l'acquisizione delle istantanee, lo stato del rapporto dell'ultima volta che è stato terminato per l'esecuzione di ulteriori istantanee.
Le istantanee sono memorizzate in /var/reports/...
dove il resto del percorso riflette il percorso del rispettivo report e ID creato al termine del report.
Le vecchie istantanee possono essere eliminate manualmente, se sei completamente sicuro di non richiedere più tali istanze.
I rapporti preconfigurati non richiedono un'elevata intensità di prestazioni, ma si consiglia comunque di utilizzare istantanee giornaliere in un ambiente di produzione. Se possibile, esegui queste istantanee giornaliere in un momento in cui non c'è molta attività sul tuo sito web; questo può essere definito con il parametro Daily snapshots (repconf.hourofday)
per Day CQ Reporting Configuration; per ulteriori informazioni su come configurare questa funzionalità, consulta Configurazione OSGI .
Anche il rapporto sui dati storici può subire lievi variazioni di aspetto a causa dei limiti che possono essere impostati, in base al numero di risultati per il periodo selezionato.
Ogni linea orizzontale è nota come serie (e corrisponde a una voce nella legenda del grafico), ogni colonna verticale di punti rappresenta le istantanee aggregate.
Per mantenere il grafico pulito per periodi di tempo più lunghi, è possibile impostare dei limiti. Per i rapporti standard, questi sono:
serie orizzontale - sia il valore predefinito che il valore massimo del sistema è 9
istantanee aggregate verticali - il valore predefinito è 35
(per serie orizzontali)
Pertanto, quando i limiti (appropriati) vengono superati, i seguenti:
I rapporti personalizzati possono anche mostrare il valore Totale per tutte le serie. Viene visualizzata come una serie (linea orizzontale e voce nella legenda).
Per i rapporti personalizzati i limiti possono essere impostati in modo diverso.
Il pulsante Modifica apre la finestra di dialogo Modifica rapporto.
Si tratta di una posizione in cui è definito il periodo di raccolta delle istantanee per Dati storici, ma è possibile definire anche diverse altre impostazioni:
Titolo
Puoi definire un titolo personalizzato.
Descrizione
Puoi definire la tua descrizione.
Percorso radice (attivo solo per alcuni rapporti)
Utilizza questo per limitare il report a una sezione (sub) dell'archivio.
Elaborazione dei rapporti
aggiorna i dati automaticamente
I dati del rapporto vengono aggiornati ogni volta che aggiorni la definizione del rapporto.
aggiorna i dati manualmente
Questa opzione può essere utilizzata per evitare i ritardi causati dalle operazioni di aggiornamento automatico in presenza di un grande volume di dati.
Selezionando questa opzione, i dati del rapporto devono essere aggiornati manualmente quando viene modificato un qualsiasi aspetto della configurazione del rapporto. Ciò significa anche che, non appena modifichi qualsiasi aspetto della configurazione, la tabella del rapporto sarà vuota.
Quando questa opzione è selezionata, viene visualizzato il pulsante Load data (accanto a Modifica nel report). Il caricamento dei dati caricherà i dati e aggiornerà i dati del rapporto visualizzati.
IstantaneePuoi definire la frequenza di creazione delle istantanee; quotidianamente, ogni ora o per niente.
Il pulsante Load data è visibile solo se è stato selezionato aggiorna manualmente i dati da Modifica.
Facendo clic su Carica dati verranno ricaricati i dati e aggiornati i rapporti visualizzati.
Se si seleziona per aggiornare manualmente i dati, è possibile:
Non appena modifichi la configurazione del rapporto, i dati della tabella del rapporto saranno disattivati.
Ad esempio, se modifichi il meccanismo di ordinamento di una colonna, i dati non verranno visualizzati.
Se desideri che i dati del rapporto siano nuovamente visualizzati, dovrai fare clic su Carica dati per ricaricare i dati.
Quando si Termina il rapporto:
Questa finestra di dialogo consente di definire o aggiornare il proprio titolo e descrizione per il rapporto risultante.
Il rapporto sui componenti fornisce informazioni sull’utilizzo dei componenti da parte del sito web.
Colonne di informazioni su:
Significato visibile, ad esempio:
Quali componenti vengono utilizzati quando.
Utile, ad esempio, per i test.
Distribuzione delle istanze di un componente specifico.
Questo può essere interessante se si tratta di pagine specifiche (ad es. "pagine pesanti") riscontrano problemi di prestazioni.
Identificare parti del sito con modifiche frequenti/meno frequenti.
Scopri come si sviluppa il contenuto delle pagine nel tempo.
Sono inclusi tutti i componenti, standard di prodotto e specifici per i progetti. Utilizzando la finestra di dialogo Modifica, l'utente può anche impostare un percorso principale che definisce il punto di partenza del rapporto: per il rapporto vengono considerati tutti i componenti che si trovano sotto tale radice.
Il rapporto sull'utilizzo del disco mostra informazioni sui dati memorizzati nel repository.
Il rapporto inizia nella directory principale ( / ) dell'archivio; facendo clic su un particolare ramo è possibile espandere il percorso all'interno dell'archivio (il percorso corrente verrà riportato nel titolo del rapporto).
Questo report analizza il registro delle richieste correnti:
<cq-installation-dir>/crx-quickstart/logs/request.log
per identificare le richieste più costose in un dato periodo di tempo.
Per generare il rapporto puoi specificare:
Periodo (ore)
Numero di ore (passate) da analizzare.
Impostazione predefinita: 24
max. Risultati
Numero massimo di linee di output.
Impostazione predefinita: 50
max Richieste
Numero massimo di richieste da analizzare.
Predefinito: -1
(tutti)
Indirizzo e-mail
Invia i risultati a un indirizzo e-mail.
Facoltativo; Predefinito: vuoto
Esegui ogni giorno alle (hh: mm)
Specifica l’ora in cui il rapporto deve essere eseguito automaticamente su base giornaliera.
Facoltativo; Predefinito: vuoto
Il rapporto di attività della pagina elenca le pagine e le azioni effettuate su di esse.
Colonne di informazioni su:
Consente di monitorare:
Il rapporto di attività della pagina prende tutte le informazioni dal registro di controllo. Per impostazione predefinita, il percorso principale è configurato nel registro di controllo in /var/audit/com.day.cq.wcm.core.page
.
Questo rapporto fornisce informazioni sul contenuto generato dall’utente; siano commenti, valutazioni o forum.
Colonne delle informazioni:
Consente di:
Questo rapporto fornisce informazioni su tutti gli utenti che hanno registrato un account e/o un profilo; può includere sia autori all’interno dell’organizzazione che visitatori esterni.
Colonne di informazioni (se disponibili) su:
Consente di:
La colonna Generic è disponibile nel rapporto utente in modo da poter accedere a informazioni personalizzate, in genere dai profili utente; ad esempio, Colore preferito come descritto in Aggiunta di campi alla definizione del profilo.
La finestra di dialogo della colonna Generico si aprirà quando:
Dalla scheda Definizioni è possibile definire:
Titolo
Titolo personalizzato per la colonna generica.
Proprietà
Il nome della proprietà memorizzato nell’archivio, in genere all’interno del profilo dell’utente.
Percorso
Di solito la proprietà viene prelevata da profile
.
Tipo
Seleziona il tipo di campo da String
, Number
, Integer
, Date
.
Aggregato predefinito
Definisce l’aggregato utilizzato per impostazione predefinita se la colonna è separata in un rapporto con almeno una colonna raggruppata. Seleziona l’aggregato richiesto da Count
, Minimum
, Average
, Maximum
, Sum
.
Ad esempio, Count per un campo String
significa che per la colonna nello stato aggregato viene visualizzato il numero di valori String
distinti.
Nella scheda Extended è inoltre possibile definire gli aggregati e i filtri disponibili:
Questo offre una panoramica concisa che fornisce informazioni sulle singole istanze dei flussi di lavoro, sia in esecuzione che completati.
Colonne di informazioni su:
Ciò significa che puoi:
Questo fornisce statistiche chiave sui flussi di lavoro in esecuzione nell’istanza.
Una volta configurati i rapporti in base a requisiti specifici, puoi attivarli per trasferire la configurazione nell’ambiente di pubblicazione.
Se desideri Dati storici per l'ambiente di pubblicazione, Termina il rapporto sull'ambiente di authoring prima di attivare la pagina.
La relazione appropriata sarà quindi accessibile in
/etc/reports
Ad esempio, il rapporto Contenuto generato dall’utente si trova in:
http://localhost:4503/etc/reports/ugcreport.html
Questo ora genera rapporti sui dati raccolti dall’ambiente di pubblicazione.
Poiché nell’ambiente di pubblicazione non è consentita la configurazione di rapporti, i pulsanti Modifica e Fine non sono disponibili. Tuttavia, è possibile selezionare i rapporti Punto e Intervallo per i rapporti Dati storici se vengono raccolte istantanee.
L'accesso a tali relazioni può costituire una questione di sicurezza; pertanto, ti consigliamo di configurare il Dispatcher in modo che /etc/reports
non sia disponibile per i visitatori esterni. Per ulteriori informazioni, consulta la Lista di controllo protezione .
Le autorizzazioni necessarie dipendono dall’azione :
In un’installazione standard di AEM sono preimpostate le seguenti autorizzazioni per i rapporti:
Report utente
user administrators
- lettura e scrittura
Report attività pagina
contributors
- lettura e scrittura
Report componente
contributors
- lettura e scrittura
Report per contenuti generati dall'utente
contributors
- lettura e scrittura
Report di istanze flusso di lavoro
workflow-users
- lettura e scrittura
Tutti i membri del gruppo administrators
dispongono dei diritti necessari per creare nuovi report.