Utilizzo della visualizzazione Investigate (Esamina)

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

La vista Analisi del monitoraggio delle API mostra tabelle pivot di metriche e attributi per tutto il traffico API, per aiutarti a confrontare l'attività per metriche diverse.

Per accedere alla visualizzazione di indagine, segui i passaggi descritti in Accesso al monitoraggio delle API e seleziona Indaga.

Seleziona la visualizzazione indagine.

La figura seguente mostra l'interfaccia utente in cui è selezionata l'opzione Esamina.

Visualizzazione indagine API Monitoring

Per impostazione predefinita, la vista Esamina mostra tre tabelle:

  • Codice di errore in base all'ora
  • Codice di guasto per codice di stato
  • Origine del guasto tramite proxy

Come nella Visualizzazione cronologica, puoi selezionare qualsiasi combinazione di tabelle dal menu Grafici da mostrare. Tutte le altre opzioni del grafico sono le stesse della visualizzazione Timeline.

Ogni cella di una tabella mostra il numero di risposte per un sottoinsieme di dati. Ad esempio, dai un'occhiata alle prime tre colonne della tabella Codice di errore per ora.

Codice di errore in base alla tabella degli orari.

La prima cella nella riga 1 mostra il numero di risposte (444) con il codice di errore steps.json2xml.SourceUnavailable restituite da 18:18 - 18:24, nella data selezionata.

La prima cella nella riga 2 mostra il numero di risposte (64) nello stesso intervallo di tempo per il quale il codice di errore non è stato impostato per qualche motivo.

Per scoprire di più su questo particolare codice di errore, consulta la pagina Risoluzione degli errori di runtime dei criteri da JSON a XML.

Codici di stato 2xx

Le richieste che restituiscono un codice di stato 2xx sono state ricevute e comprese correttamente. Normalmente, la maggior parte delle richieste restituisce un codice di stato 2xx. Se ti interessa principalmente la visualizzazione dei dati relativi alle richieste non riuscite, ti consigliamo di limitare i dati visualizzati alle richieste con codici di stato diversi da 2xx, per semplificare l'interpretazione dei dati. A tale scopo, imposta il pulsante Mostra codice di stato 2xx sulla posizione sinistra (off) in alto a destra nella visualizzazione Esamina.

Mostra il pulsante Codice di stato 2xx.

Con questa impostazione, la visualizzazione Esamina mostra solo i dati delle richieste con codici di risposta diversi da 2xx.

Visualizzazione della distribuzione dei dati di una cella

Puoi ottenere una visualizzazione più granulare dei dati per una singola cella della tabella facendo clic sulla cella. Viene visualizzata la distribuzione dei dati della cella in base a diversi attributi.

Per visualizzare un esempio, seleziona prima Regione nel menu Grafici per visualizzare la tabella di seguito.

Regione in base alla tabella temporale.

Nei dati per questo esempio è presente una sola regione, us-central1. Se ci fossero dati per altre regioni, nella tabella vedresti righe aggiuntive.

Ora, fai clic sulla prima cella della tabella.

Fai clic sulla prima cella della regione per tabella temporale.

Questa mostra diverse tabelle nel riquadro di destra della vista Indaga. Di seguito è mostrata la prima tabella.

Tabelle di distribuzione

Nella parte superiore del riquadro vengono visualizzate le condizioni che specificano i dati della cella, in questo caso la regione e l'intervallo di tempo.

Sotto, la tabella "Distribuzione per codice di guasto" mostra il numero di risposte per ogni codice di guasto nei dati. In questo esempio, ci sono solo due valori di codice di errore:

Codice di errore Conteggio
steps.json2xml.SourceUnavailable 432
not set 64

Il numero totale di codici di errore viene sommato a 496, il numero totale nella cella.

Per fare un altro esempio, scorri verso il basso nel riquadro a destra fino a raggiungere la tabella denominata "Distribuzione per codice di stato", come mostrato di seguito.

Tabelle di distribuzione

In questo caso, i dati contengono due codici di stato:

  • 500: 432
  • 200: 64
Codice di stato Conteggio
500 432
200 64

Anche in questo caso, la somma dei conteggi è pari a 496.

Utilizzare la visualizzazione Esamina per diagnosticare un problema

Puoi utilizzare la vista Esamina per diagnosticare i problemi relativi all'API. Ad esempio, supponi di ricevere un avviso che indica che la percentuale di errori 5xx supera la soglia specificata. Per analizzare questo problema, potresti eseguire le seguenti attività nella visualizzazione Esamina:

  • Visualizza la tabella CODICE FAULT PER ORA per visualizzare l'attività del codice di errore nell'ultima ora.
  • Visualizza la tabella FAULT CODE BY STATUS CODE per identificare i codici di stato HTTP specifici associati ai codici di errore il cui numero è aumentato nell'ultima ora, come identificato nel passaggio precedente.
  • Visualizza la matrice FAULT CODE BY PROXY per identificare i proxy API che attivano i codici di errore identificati nel passaggio precedente.
  • Configura un avviso per aiutarti ulteriormente a diagnosticare il problema.