Monitorare il traffico API recente

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

La dashboard recente ti consente di monitorare il traffico API recente per tutti i proxy API e i servizi di destinazione nella tua organizzazione nell'ultima ora. I dati di monitoraggio delle API possono essere visualizzati come elenco dettagliato o mappa termica. Esplora ciascuna visualizzazione nelle seguenti sezioni:

• Utilizzare la visualizzazione elenco
• Utilizzare la mappa termica

Utilizzare la visualizzazione elenco

La visualizzazione elenco mostra informazioni di riepilogo per i proxy API e i servizi di destinazione della tua organizzazione che hanno registrato traffico nel recente passato.

Esplorare la visualizzazione elenco

Per vedere la visualizzazione elenco, seleziona Analizza > Monitoraggio API > Recenti nell'interfaccia utente Edge.

Per impostazione predefinita, viene visualizzata la visualizzazione elenco. Torna alla visualizzazione elenco in qualsiasi momento facendo clic su nella dashboard Recenti.

Come evidenziato nella figura, la Visualizzazione elenco consente di:

• Visualizza le informazioni di riepilogo per tutti i proxy API e i servizi di destinazione della tua organizzazione che hanno registrato transazioni nell'ultima ora. I servizi di destinazione e proxy API sono elencati per regione e ambiente. Per una visualizzazione storica più ampia, consulta Identificare le tendenze nei dati di monitoraggio delle API.
• Identifica rapidamente i proxy API e i servizi di destinazione dotati di avvisi. Per informazioni sulla configurazione degli avvisi, vedi Configurare avvisi e notifiche.
• Fai clic sul nome di un proxy API o di un servizio di destinazione nell'elenco per visualizzare i dati dettagliati nel riquadro a destra.

• Utilizzando il contesto corrente, esegui rapidamente le seguenti attività (le opzioni non sono selezionabili se non sono applicabili al contesto attualmente selezionato):

  • Crea un report personalizzato e aggiungi altre dimensioni. Fai clic su .
  • Crea un avviso e aggiungi altre condizioni, imposta notifiche e genera un report personalizzato basato sull'avviso.
  • Visualizza il contesto corrente nella dashboard Sequenza temporale o Indaga. Fai clic rispettivamente su > Visualizza in Spostamenti o Visualizza in Esamina.

• Cerca in visualizzazione elenco per nome o URL (ad esempio https://acme.com/api). Inserisci l'intera stringa o parte di una stringa pertinente nella casella di ricerca. Puoi cercare contenuti nei campi Proxy, Destinazioni o Regione.

  Nota: se è selezionato il filtro Solo avvisi, nei risultati di ricerca verranno elencati solo i proxy API o i servizi di destinazione che presentano avvisi.

• Attiva o disattiva l'aggiornamento automatico della pagina, come richiesto.

• Mostra e nascondi i dettagli del servizio di destinazione nell'elenco.

Identifica i proxy API e i servizi di destinazione che presentano avvisi

Nella visualizzazione elenco, un'icona di avviso rossa e una linea del bordo sinistro rossa indicano per quali proxy API e servizi di destinazione sono presenti avvisi.

Fai clic su Solo avvisi per visualizzare solo i proxy API o i target di servizio che presentano avvisi.

Per visualizzare un riepilogo del numero di errori 4xx e 5xx e della percentuale di errori complessiva, passa il puntatore del mouse su uno dei valori numerici nella tabella.

Visualizzare dati dettagliati per un proxy API o un servizio di destinazione

Per visualizzare i dati dettagliati per un proxy API o un servizio di destinazione, fai clic sul nome corrispondente nella visualizzazione elenco. I dati dettagliati vengono visualizzati nel riquadro di destra.

Fai clic sulle seguenti schede per visualizzare ulteriori informazioni:

• Dettagli
• Tendenze
• Log

Inoltre, utilizzando il contesto corrente, puoi eseguire rapidamente le seguenti attività:

Nota: le opzioni non sono selezionabili se non sono applicabili al contesto attualmente selezionato.

• Crea un report personalizzato e aggiungi altre dimensioni. Fai clic su .
• Crea un avviso e aggiungi altre condizioni, imposta notifiche e genera un report personalizzato basato sull'avviso. Fai clic su > Crea avviso.
• Visualizza il contesto corrente nella dashboard Sequenza temporale o Indaga. Fai clic rispettivamente su > Visualizza in Spostamenti o Visualizza in Esamina.

Dettagli

La scheda Dettagli fornisce una visualizzazione rapida dei dati sul traffico per la sequenza temporale specificata (mostrata nella figura precedente), tra cui:

Dettagli	Descrizione
Traffico totale	Numero totale di transazioni.
Totale errori	Numero totale di errori.
Tasso di errori totali	Percentuale di traffico che ha generato errori (errori totali/traffico totale). Nota: il monitoraggio delle API confronta questa percentuale con le condizioni di avviso che hai impostato. Se il tasso di errore totale supera le soglie, nella UI vengono visualizzati degli indicatori di avviso.
TPS medi	Media di transazioni al secondo.
Latenza totale (P99)	Valore di latenza totale della risposta nel 99° percentile calcolato su una finestra temporale continuativa di 5 minuti. Nota: questa opzione viene visualizzata solo per i proxy API.
Latenza target (P99)	Valore di latenza della risposta target nel 99° percentile calcolato su una finestra continuativa di 5 minuti. Nota: questa opzione viene visualizzata solo per i proxy API.
Origine errore	Suddivisione e percentuale totale di errori del bundle proxy API (4xx e 5xx) che si sono verificati.

Trends

La scheda Tendenze mostra i seguenti grafici relativi al componente selezionato:

• Percentuale di errori per gli errori 4xx e 5xx
• Traffico (TPS)
• Latenza totale (ms)

• Latenza tutti i target

Passa il mouse sopra punti diversi del grafico per visualizzare istantaneamente le percentuali di errore, il conteggio totale del traffico e le latenze in ciascun punto.

Log

Nella scheda Log, filtra per 4xx, 5xx o Tutti gli errori e restringi l'origine degli errori in base al proxy API, al servizio di destinazione (il tuo servizio) o ad Apigee (infrastruttura Apigee).

Fai clic su un errore per aprire la finestra di dialogo dei log ed espandere i dettagli corrispondenti nell'elenco.

Utilizzare la mappa termica

La mappa termica fornisce una visualizzazione a blocchi di colori che ti consente di identificare gli ambienti per i quali sono presenti avvisi.

• Il colore verde indica che le soglie delle condizioni di avviso non sono state superate.
• Rosso indica che le soglie delle condizioni di avviso sono state superate e sono stati attivati avvisi.

Esplorazione della mappa termica

Fai clic su nella pagina Recenti per visualizzare la mappa termica, mostrata nella figura che segue.

Come mostrato nella figura precedente, la mappa termica ti consente di:

• Identifica rapidamente i proxy API e i servizi di destinazione provvisti di avvisi. Per informazioni sulla configurazione degli avvisi, consulta Configurazione di avvisi e notifiche.
• Filtra la visualizzazione selezionando i componenti dagli elenchi a discesa o facendo doppio clic su una casella per visualizzare ulteriori dettagli. Negli elenchi a discesa Proxy e destinazioni puoi applicare un filtro utilizzando una raccolta. Ad esempio:
• Fai clic su un blocco nella mappa termica per visualizzare i dati dettagliati nel riquadro a destra.

• Utilizzando il contesto corrente, esegui rapidamente le seguenti attività (le opzioni non sono selezionabili se non sono applicabili al contesto attualmente selezionato):

  • Crea un report personalizzato e aggiungi altre dimensioni. Fai clic su .
  • Crea un avviso e aggiungi altre condizioni, imposta notifiche e genera un report personalizzato basato sull'avviso. Fai clic su > Crea avviso.
  • Visualizza il contesto corrente nella dashboard Sequenza temporale o Indaga. Fai clic rispettivamente su > Visualizza in Spostamenti o Visualizza in Esamina.

• Imposta la scala di visualizzazione della mappa termica impostando scalata di su logaritmico o lineare. Linee guida per ridimensionare le caselle in base ai rapporti di traffico complessivi. Ad esempio, un proxy con 200 chiamate è due volte le dimensioni di un proxy con 100 chiamate.

  

• Effettua una ricerca nella mappa termica inserendo tutta o parte di una stringa pertinente nella casella di ricerca. Puoi cercare contenuti nelle mappe della regione, dell'ambiente, del proxy o di destinazione, a seconda di ciò che è attualmente visualizzato.

  Nota: se è selezionato il filtro Solo avvisi, nei risultati di ricerca verranno elencati solo i proxy API o i servizi di destinazione che presentano avvisi.

• Attiva o disattiva l'aggiornamento automatico della pagina, come richiesto.

Identifica i proxy API e i servizi di destinazione che presentano avvisi

Quando visualizzi la mappa termica, un blocco red indica quali ambienti, proxy API e servizi di destinazione presentano avvisi. Per ulteriori informazioni sulla configurazione degli avvisi, consulta l'articolo Configurare avvisi e notifiche.

Ad esempio, la figura seguente mostra due ambienti:

• L'ambiente test è red perché le percentuali di errore del traffico hanno superato la soglia della condizione di avviso impostata per la sequenza temporale specificata.
• L'ambiente prod è verde perché le percentuali di errori di traffico non hanno superato la soglia della condizione di avviso per la sequenza temporale specificata.

Filtra la visualizzazione selezionando i componenti dagli elenchi a discesa. In alternativa, fai doppio clic su una casella per visualizzare in dettaglio la mappa dell'ambiente fino a una mappa proxy API e una mappa del proxy API alla mappa dei target dei servizi per quel proxy API per identificare i proxy API e i servizi di destinazione che presentano avvisi.

Ambiente >>	Proxy >>	Target

Fai clic su Solo avvisi per visualizzare solo gli ambienti, i proxy API o i target di servizio che dispongono di avvisi, a seconda di ciò che viene visualizzato al momento.

Per tornare indietro di un livello, fai clic su .

Visualizzare dati dettagliati per un ambiente, un proxy API o un servizio di destinazione

Per visualizzare dati dettagliati per un ambiente, un proxy API o un servizio di destinazione, fai clic sulla casella corrispondente nella mappa termica. I dati dettagliati vengono visualizzati nel riquadro di destra.

Le schede forniscono le stesse informazioni presenti nella visualizzazione elenco. Per ulteriori informazioni, vedi:

• Dettagli
• Tendenze
• Log

Se fai clic su una casella nella mappa vengono visualizzati anche il numero di chiamate e il tasso di errori nell'ultima ora.

Creare un report personalizzato dalla dashboard Recenti

Crea un report personalizzato basato sull'insieme di condizioni selezionato. Puoi modificare il report personalizzato dopo averlo creato per aggiungere o eliminare metriche e dimensioni, se necessario. Ad esempio, potresti voler limitare la tua indagine a un determinato token di accesso, app per sviluppatori o proxy API. Per saperne di più, consulta l'articolo Informazioni di riferimento su metriche, dimensioni e filtri di Analytics.

Per scoprire di più, consulta la sezione Creazione di report personalizzati.

Per creare un report personalizzato dalla dashboard Recenti:

1. Fai clic su Analizza > Monitoraggio API > Recenti nell'interfaccia utente Edge.

2. Per visualizzare ulteriori dettagli, seleziona un proxy API o un servizio di destinazione nei menu a discesa dei filtri Visualizzazione elenco o Mappa termica. Nota: i report personalizzati non sono disponibili se i filtri Proxy e Target sono impostati su All.

3. Nell'angolo a destra, fai clic su .

   

   La pagina del report personalizzato viene visualizzata in una nuova scheda con i campi pertinenti precompilati e le dimensioni e metriche predefinite. Per impostazione predefinita, il nome del report personalizzato è il seguente: API Monitoring Recent Generated Nota: se esiste già un report personalizzato per il contesto corrente, questo viene aperto.

4. Modifica il report personalizzato come preferisci e fai clic su Salva.

5. Fai clic sul nome del report nell'elenco ed esegui il report personalizzato.