Questa pagina si applica ad Apigee e Apigee hybrid.
Visualizza la documentazione di
Apigee Edge.
I report personalizzati ti consentono di visualizzare in dettaglio metriche API specifiche e di visualizzare i dati esatti che vuoi vedere. Puoi creare un report personalizzato utilizzando una delle metriche e delle dimensioni integrate in Apigee.
Esistono due tipi di report personalizzati:
- Report in tempo reale (chiamati anche report sincroni): quando specifichi i parametri dei report nell'interfaccia utente di Apigee, i report in tempo reale vengono visualizzati nell'interfaccia utente di Apigee entro un paio di minuti.
- Job di report (chiamati anche report asincroni): per i job di report personalizzati, richiedi il report e recupera i risultati in un secondo momento.
Consulta la sezione Report in tempo reale rispetto ai job di report.
Disponibilità dei report personalizzati
Se hai un abbonamento Apigee, l'accesso ad Apigee API Analytics e alla funzionalità dei report personalizzati è incluso nei tuoi diritti di abbonamento e abilitato automaticamente per ciascuno dei tuoi ambienti Apigee.
Se sei un cliente Pay-as-you-go, devi attivare Apigee API Analytics come componente aggiuntivo a pagamento per accedere alle analisi e generare report personalizzati. Per saperne di più sull'attivazione del componente aggiuntivo Apigee API Analytics per gli ambienti Apigee Intermedio o Completo, consulta Gestire il componente aggiuntivo Apigee API Analytics.
Se non sai se utilizzi un'organizzazione Apigee con abbonamento o con pagamento a consumo, contatta l'amministratore dell'organizzazione Apigee.
Informazioni sui report personalizzati
Quando crei un report personalizzato, selezioni i dati che vuoi visualizzare (metriche), raggruppi i dati in modo significativo (dimensioni) e, facoltativamente, limiti i dati restituiti in base a caratteristiche specifiche (filtri) dei dati.
Puoi anche impostare il tipo di grafico visualizzato nel report personalizzato come grafico a colonne o a linee. Le seguenti immagini mostrano esempi di grafici per la metrica Transazioni al secondo raggruppata in base alla dimensione Proxy API:
Colonna: ogni proxy API è rappresentato da una colonna diversa:
Riga: ogni API è rappresentata da una riga diversa:
Impostazione di metriche e dimensioni
Le metriche che scegli per il report personalizzato specificano i dati che stai cercando di misurare. Le metriche più comuni includono:- Transazioni al secondo
- Data/ora della risposta
- Errori dei criteri
Oltre alle metriche e alle dimensioni standard, puoi anche creare report personalizzati per i dati personalizzati raccolti utilizzando il criterio DataCapture. Consulta Raccolta di dati personalizzati con il criterio DataCapture.
Alcune metriche ti consentono di impostare una funzione di aggregazione da applicare alla metrica. Ad esempio, puoi utilizzare le seguenti funzioni di aggregazione con la metrica Tempo di risposta:
avg
: restituisce il tempo di risposta medio.min
: restituisce il tempo di risposta minimo.max
: restituisce il tempo di risposta massimo.sum
: restituisce la somma di tutti i tempi di risposta.
Non tutte le metriche supportano tutte le funzioni di aggregazione. La documentazione sulle
metriche contiene una tabella che specifica il nome della metrica
e la funzione (sum
, avg
, min
, max
) supportata dalla metrica.
La dimensione specifica come raggruppare i dati delle metriche. Ad esempio, vuoi creare un report personalizzato che mostri la metrica Tempo di risposta. Puoi utilizzare le dimensioni per raggruppare i dati delle metriche in base al prodotto API, al proxy API o all'email dello sviluppatore (che può essere anche l'ID gruppo di app) per ottenere:
- Il tempo di risposta per prodotto API
- Il tempo di risposta per proxy API
- Il tempo di risposta per email dello sviluppatore
Il modo in cui la dimensione viene visualizzata nel grafico del report personalizzato dipende dal tipo di grafico:
- Colonna: ogni colonna corrisponde a un valore di dimensione diverso.
- A linee: ogni linea del grafico corrisponde a un valore di dimensione diverso e l'asse X rappresenta il tempo.
Impostazione dei filtri
Un filtro ti consente di limitare i dati delle metriche visualizzati nel report personalizzato impostando caratteristiche specifiche per i dati delle metriche da restituire. Ad esempio, puoi creare un filtro in modo da visualizzare i dati delle metriche solo per un tempo di risposta superiore a un valore specifico o solo per un proxy API con un nome specifico.
Puoi creare filtri complessi utilizzando la sintassi condizionale e operatori come eq
, ne
, gt
, lt
e altri ancora.
Esempi di report personalizzati
Nel tipo più semplice di report personalizzato, specifichi una singola metrica e una singola dimensione. Ad esempio, definisci un report personalizzato con le seguenti impostazioni:
- type = Colonna
- metrica = Transazioni medie al secondo
- dimension = Proxy API
Il report personalizzato contiene un grafico a colonne con i dati della metrica "Transazioni medie al secondo" raggruppati per dimensione API proxy:
Puoi aggiungere più metriche a un report personalizzato. Ad esempio, definisci un report personalizzato con due metriche:
- type = Colonna
- metrica = Transazioni medie al secondo
- metrica = Errori dei criteri
- dimension = Proxy API
Il report personalizzato contiene un grafico separato per ogni metrica:
Puoi aggiungere più dimensioni a un report personalizzato. Ad esempio, definisci un report personalizzato con le seguenti impostazioni che includono due metriche e due dimensioni:
- type = Colonna
- metrica = Transazioni medie al secondo
- metrica = Errori dei criteri
- dimension = Proxy API
- dimension = Verbo richiesta
Report in tempo reale e job di report
Apigee Analytics ti consente di eseguire un report in tempo reale o un job di report.
Per i report in tempo reale, la richiesta viene visualizzata non appena il server di analisi fornisce una risposta. Tuttavia, poiché un report potrebbe dover elaborare una grande quantità di dati (ad esempio centinaia di GB), un report in tempo reale potrebbe non riuscire a causa di un timeout.
Un report in tempo reale può avere un intervallo di tempo massimo di 92 giorni. Se selezioni un intervallo di tempo superiore, il report viene eseguito come job di report.
Per un job di report, richiedi il report e recupera i risultati in un secondo momento. Ecco alcune situazioni in cui un job di report potrebbe essere una buona alternativa:
- Analisi e creazione di report che coprono intervalli di tempo ampi.
- Analisi dei dati con una serie di dimensioni di raggruppamento e altri vincoli che aumentano la complessità della query.
- Gestire le query quando scopri che i volumi di dati sono aumentati in modo significativo per alcuni utenti o organizzazioni.
Puoi anche eseguire un job di generazione di report utilizzando l'API, come descritto in Utilizzo dell'API dei report personalizzati asincroni. Consulta Visualizzare un job di report.
Apri la pagina Report personalizzati
Apigee nella console Cloud
Per aprire la pagina Report personalizzati:
- Apri la UI di Apigee nella console Cloud.
- Seleziona Analytics > Report personalizzati.
Viene visualizzata la pagina Report personalizzati, come mostrato di seguito.
La pagina Report personalizzati contiene due schede:
- Report: vengono visualizzati i report in tempo reale.
- Esecuzioni report: mostra le esecuzioni report.
Consulta la sezione Report in tempo reale rispetto ai job di report.
Entrambe le schede mostrano un elenco dei report o dei job di report già creati. Per visualizzare un report o un job di report, fai clic sul nome del report. Per un esempio, consulta Eseguire un report.
Report
La scheda Report mostra le seguenti informazioni su ciascun report:
- Nome visualizzato: il nome del report.
- Dimensioni: le dimensioni incluse nel report.
- Metriche: le metriche e le funzioni di aggregazione (ad es. somma) incluse nel report.
- Ultima modifica: l'ora e la data dell'ultima esecuzione del report.
Report Job
La scheda Job report mostra le seguenti informazioni su ogni job report:
- Nome report: il nome del report.
- Intervallo di ora di inizio (UTC): l'ora di inizio del job di report.
- Intervallo di ora di fine (UTC): l'ora di fine del job di report.
- Stato: lo stato del job del report, che può essere in esecuzione, completato o scaduto.
- Inviata: la data e l'ora in cui è stato inviato il job di generazione del report.
La pagina Report personalizzati ti consente di:
- Visualizzare un report e un job di report personalizzati.
- Crea un report personalizzato o un job di report.
- Esegui un report.
- Modifica un report personalizzato o un job di report.
- Eliminare un report personalizzato o un job di report.
Creare un report personalizzato
Questa sezione spiega come creare un report personalizzato.
Apigee nella console Cloud
Nella pagina Report personalizzati, puoi creare un report in tempo reale o un job di report. Ecco come fare:
- Apri la pagina Report personalizzati.
- Fai clic su + Crea.
- Per creare un report in tempo reale, seleziona Report personalizzato.
- Per creare un job di report, seleziona Job di report personalizzato.
- Nella sezione Base, inserisci le seguenti informazioni:
- Nome report: il nome del report.
- Solo per un report in tempo reale, puoi anche inserire una descrizione facoltativa del report.
- Le sezioni seguenti dipendono dal fatto che tu stia creando un report in tempo reale di un job di report:
- Solo per i report in tempo reale:
Dopo Tipo di grafico, seleziona lo stile di grafico per presentare i dati:
- Colonna: l'asse X rappresenta i gruppi designati dalle dimensioni.
- Linea: l'asse X rappresenta il tempo.
- Solo per i job di report:
- Dettagli report: nel campo Ambiente, seleziona l'ambiente in cui vuoi eseguire il report. Tieni presente che per i report in tempo reale, puoi selezionare l'ambiente nella pagina del report dopo l'esecuzione.
- Intervallo di date del report: seleziona Ora di inizio e Ora di fine per il report.
Nota:l'intervallo di date massimo per un job relativo al report è di 365 giorni. Per i report che richiedono intervalli di date precisi al secondo, utilizza l' API Custom Reports per creare il job di report. L'API accetta input di intervalli di date che includono secondi.
- Solo per i report in tempo reale:
- Nella sezione Metriche:
- Seleziona la metrica da analizzare.
- Seleziona una funzione di aggregazione per visualizzare i valori di somma, media, minimo o massimo.
- Fai clic su Fine.
Nota:oltre alle metriche e alle dimensioni standard, puoi anche selezionare le metriche o le dimensioni corrispondenti ai dati personalizzati raccolti con il criterio DataCapture.
- Nel campo Dimensioni, seleziona una dimensione, come "Proxy", per limitare il set di dati utilizzato per generare i report. Puoi aggiungere altre dimensioni per limitare ulteriormente i dati.
Nella sezione Filtro, puoi restringere ulteriormente i dati visualizzati aggiungendo filtri alla definizione del report. Ad esempio, potresti aggiungere un filtro che escluda i dati per il proxy dell'API meteo o per lo sviluppatore jane@example.com.
Innanzitutto, fai clic su Aggiungi un filtro per aprire la sezione Nuovo filtro.
- Seleziona il nome dell'entità in base alla quale vuoi filtrare, che può essere una metrica o una dimensione.
- Seleziona un operatore, ad esempio = o !=, e un valore.
- Inserisci un valore per la metrica o la dimensione.
- Fai clic su Fine per aggiungere il filtro.
- Fai clic su Salva per salvare il report.
Esegui un report
Apigee nella console Cloud
Per eseguire un report in tempo reale:
- Apri la pagina Report personalizzati.
- Nella scheda Report, seleziona il report da eseguire.
Quando il report è pronto, viene visualizzato come mostrato di seguito.
Il report mostra un grafico dei dati e una tabella di riepilogo.
Nella pagina del report, puoi selezionare le seguenti opzioni:
- Ambiente: l'ambiente in cui eseguire il report.
- Un periodo di tempo per il report.
- Dimensione: una dimensione per il report. È possibile visualizzare una sola dimensione alla volta.
- Valore: un valore specifico per la dimensione o Tutti per visualizzare tutti i valori.
Nella parte superiore della pagina del report puoi anche scegliere le seguenti opzioni:
- Modifica: per modificare i dettagli del report.
- Esporta: scarica i dati del report in un file CSV.
- Invia job: invia il report come job di report. Quando fai clic su Invia job, si apre una finestra di dialogo che ti offre le opzioni descritte in Creare un report personalizzato. Dopo aver inserito le opzioni, fai clic su Crea per creare il job del report.
Per ulteriori informazioni sui job di report, consulta Visualizzare un job di report.
Visualizzare un job di report
Apigee nella console Cloud
Per visualizzare un job di report, seleziona la scheda Job di report nella parte superiore della pagina Report personalizzati.
Viene visualizzata la scheda Job report, come mostrato di seguito:

La pagina Report job ti consente di:
Visualizza tutti i job di generazione di report inviati negli ultimi 7 giorni.
Seleziona l'ambiente per cui vuoi visualizzare i job di report.
Cerca nell'elenco dei report personalizzati inserendo tutto o parte di una stringa pertinente nella casella di ricerca. La stringa viene cercata in tutti i campi visualizzati.
Per visualizzare il report personalizzato, assicurati che lo stato sia completato. Poi fai clic sul nome del report per visualizzarlo.
Modificare un report personalizzato
Apigee nella console Cloud
Per modificare un report personalizzato:
- Apri la pagina Report personalizzati.
- Fai clic sul menu con tre puntini in Azioni.
- Seleziona Modifica. Si apre la finestra di dialogo Modifica report personalizzato, in cui puoi modificare le opzioni del report. Le opzioni sono descritte in Creare un report personalizzato.
- Fai clic su Update (Aggiorna) per salvare le modifiche.
Eliminare un report personalizzato
Apigee nella console Cloud
- Apri la pagina Report personalizzati.
- Fai clic sul menu con tre puntini in Azioni.
- Fai clic su Elimina per eliminare il report.