Generazione rapporti reporting
Per aiutarti a monitorare e analizzare lo stato dell’istanza, Adobe Experience Manager (AEM) fornisce una selezione di rapporti predefiniti che possono essere configurati per i tuoi requisiti individuali:
È possibile accedere a tutti i rapporti da Strumenti console. Seleziona Rapporti nel riquadro di sinistra, fare doppio clic sul report richiesto nel riquadro di destra per aprirlo per la visualizzazione, la configurazione o entrambe.
È possibile creare nuove istanze di un rapporto anche dalla sezione Strumenti console. Seleziona Rapporti nel riquadro di sinistra, quindi Nuovo… dalla barra degli strumenti. Definisci un Titolo e Nome, seleziona il tipo di rapporto desiderato, quindi fai clic su Crea. La nuova istanza di report viene visualizzata nell’elenco. Fai doppio clic su questo per aprire, quindi trascina un componente dalla barra laterale in modo da creare la prima colonna e avviare la definizione del rapporto.
Nozioni di base sulla personalizzazione dei rapporti the-basics-of-report-customization
Sono disponibili vari formati di rapporti. Tutti i rapporti seguenti utilizzano colonne che possono essere personalizzate come descritto nelle sezioni seguenti:
- Verifica stato utilizza i campi di selezione per specificare i dati sui quali si desidera creare rapporti.
- Utilizzo disco utilizza i collegamenti per eseguire il drill-down della struttura dell’archivio.
- Flusso di lavoro offre una panoramica dei flussi di lavoro in esecuzione nell’istanza.
Selezione e posizionamento delle colonne di dati selecting-and-positioning-the-data-columns
Le colonne possono essere aggiunte, riposizionate o rimosse da qualsiasi rapporto, sia standard che personalizzato.
Il Componenti Nella scheda della barra laterale (disponibile nella pagina del report) sono elencate tutte le categorie di dati che è possibile selezionare come colonne.
Per modificare la selezione dei dati:
-
per aggiungere una colonna, trascina il componente richiesto dalla barra laterale e rilascialo nella posizione desiderata
- un segno di spunta verde indica quando la posizione è valida e una coppia di frecce indica esattamente dove viene posizionata
- un simbolo rosso "no-go" indica quando la posizione non è valida
-
per spostare una colonna, fare clic sull'intestazione, tenere premuto e trascinare nella nuova posizione
-
per rimuovere una colonna, fare clic sul titolo della colonna, tenere premuto e trascinare verso l'alto nell'area dell'intestazione del report (un simbolo meno rosso indica che la posizione non è valida). Rilasciare il pulsante del mouse e la finestra di dialogo Elimina componenti richiede la conferma dell'eliminazione effettiva della colonna.
Menu a discesa delle colonne column-drop-down-menu
Ogni colonna del rapporto ha un menu a discesa. Questa opzione diventa visibile quando il cursore del mouse si sposta sulla cella del titolo della colonna.
Viene visualizzata una freccia all'estrema destra della cella del titolo (da non confondere con la freccia immediatamente a destra del testo del titolo che indica meccanismo di ordinamento corrente).
Le opzioni disponibili nel menu dipendono dalla configurazione della colonna (effettuata durante lo sviluppo del progetto), mentre le opzioni non valide vengono disattivate (disattivate).
Ordinamento dei dati sorting-the-data
I dati possono essere ordinati in base a una colonna specifica:
- facendo clic sull'intestazione di colonna appropriata; l'ordinamento passa da crescente a decrescente e viene indicato da una freccia posta immediatamente accanto al testo del titolo
- utilizzare il menu a discesa della colonna per selezionare in modo specifico Ordinamento crescente o Ordine decrescente; anche in questo caso, viene indicata da una freccia accanto al testo del titolo
Grafico dei gruppi e dei dati correnti groups-and-the-current-data-chart
Nelle colonne appropriate, puoi selezionare Raggruppa per questa colonna dal menu a discesa della colonna. Raggruppa i dati in base a ogni valore distinto all’interno di quella colonna. È possibile selezionare più colonne da raggruppare. L’opzione è disattivata (disattivata) quando i dati nella colonna non sono appropriati. In altre parole, ogni voce è distinta e univoca, quindi non è possibile formare gruppi. Ad esempio, la colonna ID utente del report utente.
Dopo aver raggruppato almeno una colonna, un grafico a torta Dati correnti viene generato, in base a questo raggruppamento. Se sono raggruppate più colonne, ciò viene indicato nel grafico.
Spostando il cursore sul grafico a torta viene visualizzato il valore aggregato per il segmento appropriato. Utilizza l’aggregato attualmente definito per la colonna, ad esempio conteggio, minimo, media, tra gli altri.
Filtri e aggregati filters-and-aggregates
Nelle colonne appropriate, puoi anche configurare Impostazioni filtro e/o Aggregati dal menu a discesa della colonna.
Filtri filters
Impostazioni filtro consente di specificare i criteri per le voci da visualizzare. Gli operatori disponibili sono:
contains
equals
Per impostare un filtro:
- Seleziona l’operatore desiderato dall’elenco a discesa.
- Immettere il testo su cui applicare il filtro.
- Fai clic su Applica.
Per disattivare il filtro:
- Rimuovi il testo del filtro.
- Fai clic su Applica.
Aggregati aggregates
Puoi anche selezionare un metodo di aggregazione (che può variare a seconda della colonna selezionata):
Proprietà colonna column-properties
Questa opzione è disponibile solo quando Colonna generica è stato utilizzato in Report utente.
Dati storici historic-data
Un grafico della variazione dei dati nel tempo può essere visto in Dati storici. Questo deriva da istantanee scattate a intervalli regolari.
Dati:
- Raccolto da, se disponibile, la prima colonna ordinata, altrimenti la prima colonna (non raggruppata)
- Raggruppato per la colonna appropriata
Il rapporto può essere generato:
-
Imposta Raggruppamento nella colonna richiesta.
-
Modifica la configurazione che consente di definire istantanee orarie o giornaliere.
-
Fine… la definizione per avviare la raccolta di snapshot.
Il pulsante cursore rosso/verde in alto a sinistra indica quando vengono raccolte le istantanee.
Il grafico risultante è mostrato in basso a destra:
Quando inizia la raccolta dei dati, puoi selezionare:
-
Periodo
È possibile selezionare le date di inizio e di fine per la visualizzazione dei dati del rapporto.
-
Intervallo
Mese, Settimana, Giorno, Ora possono essere selezionati per la scala e l’aggregazione del rapporto.
Ad esempio, se per febbraio 2011 sono disponibili snapshot giornaliere:
- Se l'intervallo è impostato su
Day
, ogni istantanea viene visualizzata come un singolo valore nel grafico. - Se l'intervallo è impostato su
Month
, tutte le istantanee di febbraio vengono aggregate in un singolo valore (visualizzato come un singolo punto nel grafico).
- Se l'intervallo è impostato su
Seleziona le tue esigenze, quindi fai clic su Vai per applicarli al report. Per aggiornare la visualizzazione dopo aver creato ulteriori snapshot, fare clic su Vai di nuovo.
Quando si raccolgono gli snapshot, è possibile:
-
Utilizzare Fine… per reinizializzare la raccolta.
Fine "congela" la struttura del report (ovvero le colonne assegnate al report e che sono raggruppate, ordinate, filtrate e così via) e inizia a creare snapshot.
-
Apri Modifica finestra di dialogo per selezionare Nessuna istantanea di dati per terminare la raccolta fino a quando non è necessario.
Modifica attiva o disattiva solo l'acquisizione di istantanee. Se l'acquisizione delle istantanee viene nuovamente attivata, viene utilizzato lo stato del report al termine dell'ultima esecuzione per l'acquisizione di ulteriori istantanee.
/var/reports/...
dove il resto del percorso rispecchia il percorso del rispettivo rapporto e ID creati al termine del rapporto.Daily snapshots (repconf.hourofday)
parametro per Configurazione reporting Day CQ. Consulta Configurazione OSGI per ulteriori dettagli su come configurarlo.Limiti di visualizzazione display-limits
Il rapporto sui dati storici può anche cambiare leggermente nell’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 gli snapshot aggregati.
Per mantenere il grafico pulito per periodi di tempo più lunghi, è possibile impostare alcuni limiti. Per i rapporti standard:
-
serie orizzontale: valore predefinito e massimo del sistema.
9
-
snapshot aggregati verticali: il valore predefinito è
35
(per serie orizzontale)
Pertanto, quando i limiti (appropriati) vengono superati:
- i punti non vengono visualizzati
- la legenda del grafico dati cronologici potrebbe mostrare un numero di voci diverso da quello del grafico dati corrente
I rapporti personalizzati possono anche mostrare Totale per tutte le serie. Viene visualizzata come una serie (linea orizzontale e voce nella legenda).
Modifica (Report) edit-report
Il Modifica apre il pulsante Modifica Report Finestra di dialogo.
Questa è una posizione in cui il periodo per la raccolta degli snapshot per Dati storici è definito, ma è possibile definire anche diverse altre impostazioni:
-
Titolo
Puoi definire un titolo personalizzato.
-
Descrizione
Puoi definire una tua descrizione.
-
Percorso directory principale (attivo solo per alcuni rapporti)
Utilizzare questa opzione per limitare il report a una sezione (secondaria) dell’archivio.
-
Elaborazione rapporto
-
aggiorna i dati automaticamente
I dati del rapporto vengono aggiornati ogni volta che si aggiorna la definizione del rapporto.
-
aggiorna i dati manualmente
Questa opzione può essere utilizzata per evitare ritardi causati da operazioni di aggiornamento automatico quando il volume di dati è elevato.
Selezionando questa opzione, i dati del rapporto devono essere aggiornati manualmente quando viene modificato un qualsiasi aspetto della configurazione del rapporto. Significa anche che quando modifichi un aspetto della configurazione, la tabella del rapporto risulta vuota.
Quando selezionato, il Carica dati viene visualizzato (accanto a Modifica sulla relazione). Carica dati carica i dati e aggiorna i dati del rapporto visualizzati.
-
-
Snapshot
È possibile definire la frequenza delle istantanee, giornaliera, oraria o non.
Carica dati load-data
Il Carica dati è visibile solo quando aggiorna dati manualmente è stato selezionato da Modifica.
Clic Carica dati ricarica i dati e aggiorna il rapporto visualizzato.
Selezionando di aggiornare manualmente i dati si ottiene quanto segue:
-
Quando modifichi la configurazione del rapporto, la tabella dei dati del rapporto risulta vuota.
Ad esempio, se modifichi il meccanismo di ordinamento di una colonna, i dati non vengono visualizzati.
-
Se si desidera visualizzare nuovamente i dati del report, è necessario fare clic su Carica dati per ricaricare i dati.
Fine (rapporto) finish-report
Quando Fine la relazione:
- Definizione del rapporto a partire da quel momento viene utilizzato per creare le istantanee. In seguito, è possibile continuare a lavorare su una definizione di report perché è separata dalle istantanee.
- Eventuali snapshot esistenti vengono rimossi.
- Vengono raccolti nuovi snapshot per Dati storici.
Questa finestra di dialogo consente di definire o aggiornare il titolo e la descrizione del report risultante.
Tipi di rapporti report-types
Report componente component-report
Il rapporto sui componenti fornisce informazioni sull’utilizzo dei componenti da parte del sito web.
Colonne di informazioni informazioni su:
- Autore
- Percorso componente
- Tipo componente
- Ultima modifica
- Pagina
Ciò significa che è possibile visualizzare quanto segue:
-
Quali componenti vengono utilizzati e dove vengono utilizzati.
Utile, ad esempio, durante il test.
-
Come vengono distribuite le istanze di un componente specifico.
Questo può essere interessante se pagine specifiche (ovvero, "pagine pesanti") riscontrano problemi di prestazioni.
-
Identificare le parti del sito con modifiche frequenti/meno frequenti.
-
Scopri come il contenuto della pagina si sviluppa nel tempo.
Tutti i componenti sono inclusi, standard per prodotto e specifici per progetto. Utilizzo di Modifica l'utente può anche impostare una Percorso directory principale che definisce il punto d’inizio del rapporto: tutti i componenti sotto tale radice vengono considerati per il rapporto.
Utilizzo disco disk-usage
Il report sull'utilizzo del disco mostra informazioni sui dati archiviati nel repository.
Il report inizia nella directory principale ( / ) dell’archivio facendo clic su un ramo specifico che è possibile espandere all’interno dell’archivio (il percorso corrente si riflette nel titolo del report).
Verifica stato health-check
Questo rapporto analizza il registro di richieste corrente:
<cq-installation-dir>/crx-quickstart/logs/request.log
Per aiutarti a identificare le richieste più costose in un dato periodo.
Per generare il rapporto, puoi specificare quanto segue:
-
Periodo (ore)
Il numero di ore (passate) da analizzare.
Predefiniti:
24
-
max. Risultati
Numero massimo di righe di output.
Predefiniti:
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)
Specificare un orario per l'esecuzione automatica giornaliera del report.
Facoltativo; predefinito: vuoto
Report attività pagina page-activity-report
Il rapporto di attività della pagina elenca le pagine e le relative azioni.
Colonne di informazioni informazioni su:
- Pagina
- stimato
- Tipo
- User
Ciò consente di monitorare:
- Modifiche più recenti.
- Autori che lavorano su pagine specifiche.
- Pagine che non sono state modificate di recente, quindi potrebbe essere necessario intervenire.
- Pagine modificate più/meno frequentemente.
- Utenti più/meno attivi.
Il rapporto attività pagina prende tutte le sue informazioni dal registro di audit. Per impostazione predefinita, il percorso della directory principale è configurato per il registro di controllo in /var/audit/com.day.cq.wcm.core.page
.
Report di contenuti generati dall'utente user-generated-content-report
Questo rapporto fornisce informazioni sui contenuti generati dagli utenti, che si tratti di commenti, valutazioni o forum.
- Data
- Indirizzo IP
- Pagina
- Referrer
- Tipo
- Identificatore utente
Consente di:
- Scopri quali pagine ricevono il maggior numero di commenti.
- Ottieni una panoramica di tutti i commenti lasciati da specifici visitatori del sito, forse correlati ai problemi.
- Valuta se i nuovi contenuti provocano commenti monitorando quando vengono aggiunti commenti su una pagina.
Report utente user-report
Questo rapporto fornisce informazioni su tutti gli utenti che hanno registrato un account e/o un profilo, che può includere sia autori all’interno della tua organizzazione che visitatori esterni.
Colonne di informazioni (se disponibile) informazioni su:
- Età
- Paese
- Dominio
- Cognome
- Genere
- Generico
- Nome assegnato
- Info
- Interesse
- Lingua
- Hashcode NTLM
- ID utente
Consente di:
- Scopri la distribuzione demografica degli utenti.
- Generare rapporti sui campi personalizzati aggiunti ai profili.
Colonna generica generic-column
Il Generico è disponibile nel Report utente, in modo da poter accedere a informazioni personalizzate, in genere profili utentead esempio, Colore preferito come descritto in Aggiunta di campi alla definizione del profilo.
La finestra di dialogo Colonna generica (Generic column) viene aperta quando eseguite una delle seguenti operazioni:
- Trascina il componente generico dalla barra laterale al rapporto.
- Selezionare le Proprietà colonna per una colonna generica esistente.
Dalla sezione Definizioni scheda che puoi definire:
-
Titolo
Titolo personalizzato per la colonna generica.
-
Proprietà
Il nome della proprietà come memorizzato nell’archivio, in genere all’interno del profilo dell’utente.
-
Percorso
Di solito la proprietà viene ricavata 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: Conteggio per un
String
campo indica che il numero diString
vengono visualizzati i valori per la colonna nello stato aggregato.
In Esteso , puoi anche definire gli aggregati e i filtri disponibili:
Report di istanze flusso di lavoro workflow-instance-report
Questo offre una panoramica concisa, fornendo informazioni sulle singole istanze dei flussi di lavoro, sia in esecuzione che completati.
Colonne di informazioni informazioni su:
- Completato
- Durata
- Iniziatore
- Modello
- Payload
- Avviato
- Stato
Ciò significa che è possibile:
- Monitora la durata media dei flussi di lavoro; se ciò accade regolarmente, può evidenziare i problemi con il flusso di lavoro.
Report di workflow workflow-report
Vengono fornite statistiche chiave sui flussi di lavoro in esecuzione nell’istanza.
Utilizzo dei rapporti in un ambiente di pubblicazione using-reports-in-a-publish-environment
Dopo aver configurato i rapporti in base a esigenze specifiche, puoi attivarli per trasferire la configurazione nell’ambiente di pubblicazione.
Il report appropriato è quindi accessibile in
/etc/reports
Ad esempio, il rapporto User-Generated Content (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 alcuna configurazione di report, il Modifica e Fine non sono disponibili. Tuttavia, puoi selezionare Periodo e Interval per Dati storici segnala se gli snapshot vengono raccolti.
/etc/reports
non è disponibile per i visitatori esterni. Consulta la Elenco di controllo della sicurezza per ulteriori dettagli.Autorizzazioni necessarie per l’esecuzione dei rapporti permissions-needed-for-running-reports
Le autorizzazioni necessarie dipendono dall’azione:
- I dati del rapporto vengono raccolti utilizzando i privilegi dell’utente corrente.
- I dati storici vengono raccolti utilizzando i privilegi dell’utente che ha completato il rapporto.
In un’installazione standard dell’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 di contenuti generati dall'utente
contributors
- lettura e scrittura -
Report di istanze flusso di lavoro
workflow-users
- lettura e scrittura
Tutti i membri del administrators
dispongono dei diritti necessari per creare rapporti.