Creazione e gestione di rapporti personalizzati

Questa pagina si applica a Apigee e Apigee ibridi.

Visualizza documentazione di Apigee Edge.

I report personalizzati consentono di visualizzare in dettaglio metriche API specifiche e visualizzare i dati esatti che che vuoi vedere. Puoi creare un report personalizzato utilizzando una qualsiasi delle metriche e dimensioni integrate in Apigee.

Esistono due tipi di report personalizzati:

• Report in tempo reale (chiamati anche report sincroni): quando specifichi ai parametri dei report nella UI di Apigee, i report in tempo reale vengono la UI di Apigee in un paio di minuti.
• Genera report (chiamati anche report asincroni): per i report personalizzati segnalare i job che richiedi e recuperi i risultati in un secondo momento.

Vedi Report in tempo reale e confronto segnala offerte di lavoro.

Disponibilità di report personalizzati

Se sei un cliente in abbonamento Apigee, puoi accedere all'analisi delle API Apigee e al report personalizzato sia inclusa nei tuoi diritti di abbonamento e abilitata automaticamente per ciascuno dei tuoi ambienti Apigee.

Se sei un cliente con Pay-as-you-go, devi abilitare Analytics API Apigee come componente aggiuntivo a pagamento per accedere alle analisi e generare report personalizzati. Per ulteriori informazioni sull'abilitazione del componente aggiuntivo Apigee API Analytics per le tue applicazioni Apigee intermedie o complete ambienti, consulta Gestire il componente aggiuntivo di analisi delle API Apigee.

Se non sai con certezza se stai utilizzando un abbonamento o un pagamento a consumo Apigee contatta l'amministratore della tua organizzazione Apigee.

Informazioni sui report personalizzati

Quando crei un report personalizzato, devi selezionare i dati che vuoi visualizzare (metriche), gruppo i dati in modi significativi (dimensioni) e facoltativamente limitare i dati restituiti in base 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 raggruppate per dimensione del proxy API:

• Colonna: ogni proxy API è rappresentato da una colonna diversa:

  

• Riga: ogni API è rappresentata da una linea diversa:

  

Impostazione di metriche e dimensioni

Le metriche scelte per il report personalizzato specificano la 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 personalizzati raccolti mediante il criterio Data Capture. Consulta Raccolta di dati personalizzati con Data Capture .

Alcune metriche ti consentono di impostare una funzione di aggregazione da eseguire in base alla metrica. Ad esempio, puoi utilizzare le seguenti funzioni di aggregazione con la metrica del 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 su metrics 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 del tempo di risposta. Puoi usare le dimensioni per raggruppare i dati delle metriche per prodotto API, proxy API o email dello sviluppatore (che può essere anche AppGroup Id) 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.
• Linea: ogni linea del grafico corrisponde a un valore di dimensione diverso. e l'asse x rappresenta il tempo.

Filtri per l'impostazione

Un filtro ti consente di limitare i dati delle metriche visualizzati nel report personalizzato impostando caratteristiche specifiche sui 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. maggiore di 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.

Esempi di report personalizzati

Nel tipo più semplice di report personalizzato, devi specificare una singola metrica e una singola dimensione. Ad esempio: devi definire un report personalizzato con le seguenti impostazioni:

• tipo = Colonna
• metrica = Media delle transazioni al secondo
• dimensione = Proxy API

Il report personalizzato contiene un grafico a colonne con l'indicazione "Media transazioni al secondo" metrica Dati raggruppati in base alla dimensione proxy API:

Puoi aggiungere più metriche a un report personalizzato. Ad esempio, definisci un report personalizzato due metriche:

• tipo = Colonna
• metrica = Media delle transazioni al secondo
• metrica = Errori relativi alle norme
• dimensione = 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 le seguenti impostazioni che includono due metriche e due dimensioni:

• tipo = Colonna
• metrica = Media delle transazioni al secondo
• metrica = Errori relativi alle norme
• dimensione = Proxy API
• dimension = verbo di richiesta

Report in tempo reale e job nei report

Apigee Analytics consente di eseguire un report in tempo reale o un job di report.

• Per i report in tempo reale, richiedi il report, che viene visualizzato 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 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 un job di report.

  Vedi Eseguire un report personalizzato.

• Per un job di report, richiedi il report e recupera i risultati in un secondo momento. Alcune situazioni in cui un job di segnalazione può essere le alternative includono:

  • Analisi e creazione di report con ampi intervalli di tempo.
  • Analisi dei dati con varie dimensioni di raggruppamento e altri vincoli che aggiungono complessità alla query.
  • Gestione delle query quando scopri che i volumi di dati sono aumentati in modo significativo per alcuni utenti o organizzazioni.
  Nota: i job di report hanno i seguenti limiti:

  • L'intervallo di tempo massimo è di 365 giorni.
  • Limite di dimensione di 32 MB per i risultati di una query.

  Puoi anche eseguire un job di report utilizzando l'API, come descritto in Utilizzo dell'API dei report personalizzati asincrona. Vedi Visualizzare un job relativo ai report.

Apri la pagina Report personalizzati

Nota: è disponibile una nuova versione della UI di Apigee, integrata con la console Google Cloud. La nuova UI si chiama Apigee nella console Cloud. La le istruzioni nelle prime due schede spiegano come utilizzare Apigee nella console Cloud o nella versione classica di Apigee.

Apigee nella console Cloud

Per aprire la pagina Report personalizzati:

1. Apri l'UI di Apigee nella console Cloud.
2. Seleziona Analytics > Report personalizzati

Viene visualizzata la pagina Report personalizzati, come illustrato di seguito.

La pagina Report personalizzati contiene due schede:

• Report: mostra i report in tempo reale.
• Report job: mostra i job del report.

Vedi Report in tempo reale e confronto segnala offerte di lavoro.

Entrambe le schede mostrano un elenco dei report o dei job di report già creati. Per visualizzare un report o un job di segnalazione, fai clic sul nome del report. Consulta Esegui un report per vedere un esempio.

Report

La scheda Report mostra le seguenti informazioni su ogni report:

• Nome visualizzato: il nome del report.
• Dimensioni: le dimensioni incluse nel report.
• Metriche: le metriche e le funzioni di aggregazione (ad esempio la somma) incluse nella report.
• Ultima modifica: l'ultima data e ora in cui è stato eseguito il report.

Segnalare offerte di lavoro

La scheda Report job mostra le seguenti informazioni su ogni job associato al report:

• Nome report: il nome del report.
• Intervallo di tempo di inizio (UTC): l'ora di inizio del job di report.
• Intervallo di tempo di fine (UTC): l'ora di fine del job del report.
• Stato: lo stato del job di segnalazione, che può essere in esecuzione, completato o scaduto.
• Inviato: la data e l'ora in cui il job di segnalazione è stato inviato.

La pagina Report personalizzati consente di:

• Visualizza un report personalizzato e un job di generazione dei report.
• Crea un report personalizzato o segnala un job.
• Crea un report.
• Modifica un report personalizzato o un job di segnalazione.
• Elimina un report personalizzato o un job di segnalazione.

Nota: intervallo di ritardo dei dati
Dopo che le chiamate API sono state eseguite sui proxy, potrebbero essere necessari fino a 10 minuti prima che i dati vengano visualizzati nelle dashboard, nei rapporti personalizzati e nelle chiamate alle API di gestione.

Versione classica di Apigee

Per aprire la pagina Report personalizzati:

1. Accedi alla UI di Apigee.
2. Seleziona Analizza > Report personalizzati > Report.

La pagina Report personalizzati mostra tutti i report personalizzati che sono stati creati per dell'organizzazione, come illustrato nella figura seguente:

Come evidenziato in figura, la pagina Report personalizzati ti consente di:

• Visualizza un elenco di tutti i report personalizzati.
• Aggiungi un report personalizzato.
• Crea un report personalizzato facendo clic sul nome corrispondente nell'elenco. Il report viene creato utilizzando i dati raccolti nell'ultima ora per impostazione predefinita e i dati vengono visualizzati nel report personalizzato Fitbit.com. Consulta Esplorazione della dashboard dei report personalizzati.
• Cerca nell'elenco dei report personalizzati inserendo tutta o parte di una stringa pertinente nei casella di ricerca. Viene effettuata la ricerca della stringa in tutti i campi visualizzati.
• Elimina un report personalizzato.

Esplorazione della dashboard dei report personalizzati

La dashboard dei report personalizzati mostra i risultati del report personalizzato per un intervallo di tempo specifico. incluso il grafico a colonne o a linee della metrica specificata:

La dashboard dei report personalizzati ti consente di:

• Visualizza i dati dei report personalizzati per l'intervallo di tempo selezionato.
• Seleziona l'Ambiente per il quale vuoi visualizzare i dati dei report personalizzati.
• Seleziona una dimensione specifica per filtrare i dati dei report personalizzati. Quest'area è attiva solo quando specifichi più dimensioni nel report.

• Seleziona la visualizzazione Grafico o Tabella.

  Nota: se il report personalizzato include molte righe nella tabella di riepilogo in fondo allo fai clic su Tabella per visualizzare solo le informazioni tabulari. Nella visualizzazione tabella, utilizza il pulsante Mostra a per controllare il numero di righe da visualizzare nella tabella. Puoi mostrare fino a 200 righe alla volta.
• Analizza una metrica selezionando Icona nella riga della tabella della metrica associata. Visualizzare le anomalie e confrontarle con un periodo precedente o con altre metriche.
• Crea il report personalizzato facendo clic e impostando l'intervallo di tempo.
• Scarica il report personalizzato come file CSV. Il nome del file è il seguente: metric.csv. Ad esempio: Average_of_total_response_time.csv.
• Modifica il report personalizzato.

Nota: intervallo di ritardo dei dati
Dopo che le chiamate API sono state eseguite sui proxy, potrebbero essere necessari fino a 10 minuti prima che i dati vengano visualizzati nelle dashboard, nei rapporti personalizzati e nelle chiamate alle API di gestione.

Creare un report personalizzato

Questa sezione spiega come creare un report personalizzato.

Nota: gli account gratuiti e di prova non possono creare account segnalare i job. Per ulteriori informazioni, vedi Piani tariffari Apigee.

Apigee nella console Cloud

Nella pagina Report personalizzati, puoi creare un report in tempo reale o un job di report. Ecco come fare:

1. Apri la pagina Report personalizzati.
2. Fai clic su + Crea.
3. • Per creare un report in tempo reale, seleziona Report personalizzato.
   • Per creare un job di report, seleziona Job report personalizzato.
4. 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.
5. Le seguenti sezioni dipendono dal fatto che tu stia creando un report in tempo reale di un report offerta di lavoro:
   • Solo per report in tempo reale:

     Dopo Tipo di grafico, seleziona lo stile del grafico per presentare i dati:

     • Colonna: l'asse X rappresenta i gruppi designati dalle dimensioni.
     • Linea: l'asse X rappresenta il tempo.

   • Solo per offerte di lavoro associate ai 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 del report.
     • 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 di report è di 365 giorni. Per i report che richiedono intervalli di date con una precisione al secondo, utilizza l' API Custom Reports per creare il job per il report. L'API accetta input di intervalli di date che includono i secondi.

6. Nella sezione Metriche:
   .
   1. Seleziona la metrica che vuoi e analisi.
   2. Seleziona una funzione aggregata per visualizzare i valori Somma, Media, Min o Max. e i relativi valori.
   3. Fai clic su Fine.

   Nota:oltre alle metriche e alle dimensioni standard, puoi anche selezionare metriche o dimensioni corrispondenti personalizzato raccolti con il criterio Data Capture.

7. Nel campo Dimensioni, seleziona una dimensione. ad esempio "Proxy", per limitare il set di dati utilizzati per generare i report. Puoi aggiungere altre dimensioni per limitare ulteriormente e i dati di Google Cloud.

8. 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 relativi allo sviluppatore o al proxy API Weather [e-mail].

   Innanzitutto, fai clic su Aggiungi un filtro per aprire la sezione Nuovo filtro.

   1. Seleziona il nome dell'entità in base alla quale applicare il filtro, che può essere una metrica. o una dimensione.
   2. Seleziona un operatore, ad esempio = o != e un valore.
   3. Inserisci un valore per la metrica o la dimensione.
   4. Fai clic su Fine per aggiungere il filtro.
9. Fai clic su Salva per salvare il report.

Versione classica di Apigee

Per aggiungere un report personalizzato:

1. Apri la pagina Report personalizzati.
2. Fai clic su + Report personalizzato.
3. Nella sezione Di base, inserisci le seguenti informazioni:

   Campo	Descrizione
   Nome report	Nome del report.
   Descrizione del report	Descrizione del report.
   Tipo di grafico	Seleziona lo stile del grafico da utilizzare per presentare i tuoi dati di analisi personalizzati. Colonna: l'asse X rappresenta i gruppi designati dalle dimensioni. Linea: l'asse X rappresenta il tempo.

4. Nella sezione Metriche:
   1. Fai clic sulla relativa a Metriche.
   2. Seleziona la metrica che vuoi e analisi.
   3. Seleziona una funzione aggregata per visualizzare i valori Somma, Media, Min o Max. e i relativi valori.
   4. Fai clic su Salva.
   5. Fai clic sull'icona per aggiungere altre metriche.

   Nota:oltre alle metriche e alle dimensioni standard, puoi anche selezionare metriche o dimensioni corrispondenti personalizzato raccolti con il criterio Data Capture.

5. Nella sezione Dimensioni, fai clic su e seleziona un dimensione, ad esempio "Proxy", per limitare il set di dati utilizzati per generare i report. Puoi aggiungere altre dimensioni per limitare ulteriormente e i dati di Google Cloud.

6. Nella sezione Filtro, restringi ulteriormente i dati visualizzati aggiungendo filtri alla definizione del report. Ad esempio, potresti aggiungere un filtro che escluda i dati relativi allo sviluppatore o al proxy API Weather [e-mail].

   1. Fai clic su e seleziona il nome del dell'entità in base alla quale applicare il filtro, Operatore come = o != e un valore.
   2. Fai clic su Aggiungi per salvare il filtro.
   3. Fai clic su per aggiungerne altre filtri e seleziona un connettore AND oppure OR.
7. Fai clic su Salva per salvare il report.

Eseguire un report

Apigee nella console Cloud

Per eseguire un report in tempo reale:

1. Apri la pagina Report personalizzati.
2. 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.

Nota: il report mostra solo una dimensione alla volta. Se il report ha più dimensioni, puoi selezionare quella da visualizzare nel campo Dimensione.

Nella pagina del report, puoi selezionare le seguenti opzioni per il report:

• Ambiente: l'ambiente in cui eseguire il report.
• Il periodo di tempo per il report.
  Nota: l'intervallo di tempo massimo per un report personalizzato è 92 giorni. Per creare un report con un intervallo di tempo più lungo, devi inviarlo come job di segnalazione.
• Dimensione: una dimensione per il report. Una sola dimensione possono essere visualizzati contemporaneamente.
• Valore: un valore specifico per la dimensione oppure Tutte per visualizza tutti i valori.

Puoi anche scegliere le seguenti opzioni nella parte superiore della pagina del report:

• Modifica: modifica i dettagli del report.
• Esporta: consente di scaricare i dati del report in un file CSV.
• Invia job: invia il report come job di segnalazione. Quando fai clic su Invia job, si apre una finestra di dialogo con le opzioni descritte in Crea un report personalizzato. Dopo aver inserito le opzioni, fai clic su Crea per creare il job di segnalazione.

Nota: gli intervalli personalizzati non possono superare i 92 giorni per e 365 giorni per le offerte di lavoro associate ai report.

Per ulteriori informazioni sulle offerte di lavoro associate al report, consulta Visualizzare un job relativo ai report.

Versione classica di Apigee

Per eseguire un report personalizzato per un intervallo di tempo specifico:

1. Accedi alla pagina Report personalizzati.
2. Seleziona il report da eseguire. Per impostazione predefinita, nel report vengono visualizzati i dati relativi all'ora precedente.

   Nota:se il report richiede più di 60 secondi per l'esecuzione, verrà convertita automaticamente in un report in tempo reale.

3. Per creare il report per un intervallo di tempo diverso:

   1. Fai clic nell'area dell'intervallo di tempo nella parte superiore del report per aprire la Popup Selezione ora report personalizzata.
   2. Seleziona una delle seguenti opzioni:
      • Un intervallo di tempo predefinito, ad esempio Ultima ora, Ieri o Ultimi 7 giorni.

      • Un intervallo personalizzato selezionando una data Da/A e l'ora o utilizzare il calendario per selezionare le date di inizio e di fine. Fai clic su UTC per utilizzare il fuso orario UTC (Universal Time Coordinated).

        Nota: gli intervalli personalizzati non possono superare i 92 giorni per gli intervalli personalizzati sincroni e 365 giorni per le offerte relative ai report.
   3. Per creare il report, seleziona una delle seguenti opzioni:

      • Applica per eseguire il report. I risultati verranno visualizzati nella dashboard dei report personalizzati al termine del report.

      • Invia job per eseguire il report come job di report. Viene visualizzata la seguente finestra di dialogo:

        

        Fai clic su Visualizza stato nella finestra di dialogo per visualizzare lo stato del job relativo al report.

Visualizzare un job relativo ai report

Apigee nella console Cloud

Per visualizzare un job relativo ai report, seleziona la scheda Segnala job nella parte superiore della pagina Report personalizzati.

Viene visualizzata la scheda Segnala job, come illustrato di seguito:

La pagina Job report consente di:

• Visualizza tutte le offerte di lavoro inviate nel report negli ultimi 7 giorni.

  Nota: i risultati dei job nei report vengono eliminati dopo 7 giorni.

• Seleziona l'ambiente per il quale vuoi visualizzare i job di report.

• Cerca nell'elenco dei report personalizzati inserendo tutta o parte di una stringa pertinente nella casella di ricerca. viene effettuata la ricerca della stringa in tutti i campi visualizzati.

Per visualizzare il report personalizzato, assicurati che il suo Stato sia completato. Fai clic sul nome del report per visualizzarlo.

Nota:

Non puoi visualizzare un job di segnalazione che:

• È ancora in esecuzione.
• Supera le dimensioni di visualizzazione massime di 2 MB.

Versione classica di Apigee

Per visualizzare i job di report, seleziona una delle seguenti opzioni:

• Fai clic su Visualizza stato nella finestra di dialogo Report inviato come lavoro in background.
• Seleziona Analizza > Report personalizzati > Segnala job dalla barra di navigazione a sinistra.

Viene visualizzata la pagina Job report, come illustrato nella figura seguente:

La pagina Job report consente di:

• Visualizza tutti i risultati dei job inviati negli ultimi 7 giorni.

  Nota: i risultati dei job vengono eliminati dopo 7 giorni.

• Seleziona l'ambiente per il quale vuoi visualizzare i job di report.

• Per visualizzare il report personalizzato, assicurati che il suo Stato sia completato. Quindi, sposta il mouse sulla riga corrispondente al report. Un e un Viene visualizzata l'icona . Seleziona il per visualizzare il report.

  Nota:

  Non puoi visualizzare un job di segnalazione che:

  • È ancora in esecuzione.
  • Supera le dimensioni di visualizzazione massime di 2 MB.
  • Non contiene dati (0 MB).

• Scarica il report personalizzato.

Modificare un report personalizzato

Apigee nella console Cloud

Per modificare un report personalizzato:

1. Apri la pagina Report personalizzati.
2. Fai clic sul menu con tre puntini in Azioni.
3. Seleziona Modifica. Viene visualizzata la finestra di dialogo Modifica report personalizzato, in cui puoi modificare le opzioni del report. Le opzioni sono descritte in Crea un report personalizzato.
4. Fai clic su Update (Aggiorna) per salvare le modifiche.

Versione classica di Apigee

Per modificare un report personalizzato:

1. Apri la pagina Report personalizzati.
2. Sposta il mouse sul nome del report da modificare. La modifica ed elimina vengono visualizzate sul lato destro della pagina.
3. Fai clic sull'icona di modifica.
4. Modifica i dettagli del report personalizzato.
5. Fai clic su Salva.

Tornerai ai risultati del report personalizzato.

Eliminare un report personalizzato

Apigee nella console Cloud

1. Apri la pagina Report personalizzati.
2. Fai clic sul menu con tre puntini in Azioni.
3. Fai clic su Elimina per eliminare il report.

Versione classica di Apigee

Per eliminare un report personalizzato:

1. Apri la pagina Report personalizzati.
2. Sposta il mouse sul nome del report da modificare. La modifica ed elimina vengono visualizzate sul lato destro della pagina.
3. Fai clic sull'icona Elimina per eliminare il report.