Esaminare i problemi

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

La dashboard Esamina consente di visualizzare tabelle pivot di metriche e attributi per tutto il traffico API e di confrontare l'attività relazionale tra le metriche per esaminare e diagnosticare i problemi più velocemente. Nella dashboard puoi accedere ai dati degli ultimi 30 giorni.

Seleziona Analizza > Monitoraggio API > Esamina nell'interfaccia utente Edge per aprire la dashboard Esamina. La dashboard ha due aree principali:

• Codice di stato consente di esaminare le metriche del codice di stato per i proxy API e i servizi di destinazione.
• La latenza consente di esaminare i problemi di latenza per i proxy API e i servizi di destinazione.

Nella dashboard Esamina puoi anche analizzare i problemi causati da un avviso specifico. Quando si verifica un avviso, fai clic sul suo nome nella pagina Cronologia avvisi per aprirlo nella dashboard Invesitgate.

Utilizzare la dashboard di indagine per diagnosticare un problema

Ad esempio, ricevi un avviso che indica che la percentuale di errori 5xx supera la soglia specificata. Per esaminare questo problema, potresti eseguire le seguenti attività nella dashboard di indagine:

1. Visualizza la matrice codice di errore e orario per vedere l'attività del codice di errore nell'ultima ora.
2. Passa alla matrice codice di errore e stato HTTP per identificare i codici di stato HTTP specifici associati ai codici di errore il cui numero è aumentato nell'ultima ora, come indicato nel passaggio precedente.
3. Passa alla matrice Codice di errore e proxy per identificare i proxy API che attivano i codici di errore identificati nel passaggio precedente.
4. Fai clic su una casella nella matrice associata a un proxy API con un volume elevato di codici di errore per visualizzare ulteriori dettagli e accedere ai log.
5. Configura un avviso e crea un report personalizzato per diagnosticare ulteriormente il problema.

6. troubleshoot il proxy API utilizzando traccia e altri strumenti per identificare una soluzione al problema.

Utilizzare la dashboard dei codici di stato

La dashboard Codice di stato ti consente di esaminare le metriche del codice di stato per i proxy API e i servizi di destinazione nella tua organizzazione. Puoi visualizzare le metriche del codice di stato per un periodo di un'ora o di quattro ore in qualsiasi momento negli ultimi 30 giorni.

Esplorare la dashboard dei codici di stato

Per visualizzare la dashboard Codice di stato, seleziona Analizza > Monitoraggio API > Esamina nell'interfaccia utente Edge. Per impostazione predefinita, la dashboard Codice di stato visualizza:

Come evidenziato nella figura, la dashboard di indagine ti consente di:

• Configura ogni matrice impostando i relativi assi X e Y per confrontare l'attività relazionale tra le metriche e ottenere maggiori informazioni.
• Identifica rapidamente le metriche con i volumi relativi più elevati in base all'ombreggiatura dei colori di un blocco. Più scuro è il blocco, più alto è il volume relativo.
• Fai clic su un blocco nella matrice per visualizzare i dettagli della metrica.
• Filtra i dati in base a:
  • Ambiente
  • Regione
  • Proxy
  • Codici di stato (incluso tutto il traffico, tutti gli errori, 2xx, 4xx o 5xx)
  • Data e ora negli ultimi 30 giorni
  • Finestra di 1 o 4 ore

Utilizza la dashboard per eseguire rapidamente le seguenti attività:

• Accedi ai log nel riquadro dei dettagli delle metriche.
• Visualizza il contesto corrente in Recenti o nella Cronologia o nella dashboard facendo clic rispettivamente su > > o >.
• Crea un report personalizzato e aggiungi altre dimensioni facendo clic su .
• Crea un avviso e aggiungi altre condizioni, imposta notifiche e genera un report personalizzato basato sull'avviso.

Configurazione della matrice del codice di stato

Quando selezioni la dashboard Codice di stato, per impostazione predefinita vengono visualizzate le seguenti matrici:

• Codice di errore e ora
• Codice di errore e stato HTTP
• Origine di errore e proxy API

Configura ogni matrice per confrontare due delle seguenti metriche selezionando un valore per gli elenchi a discesa x- e x-:

• Codice di errore
• Criterio di errore
• Origine errore
• Stato HTTP
• Proxy
• Ora
• Regione
• Target (servizio di destinazione o le norme sui callout di servizio). Se il target è una norma di callout di servizio, il valore visualizzato è preceduto da sc://. ad esempio sc://my.endpoint.net.

Visualizza i dettagli della metrica Codice di stato

Visualizza i dettagli di una metrica specifica facendo clic sul blocco corrispondente nella matrice.

I dettagli relativi alla causa sospetta vengono visualizzati nel riquadro a destra, tra cui:

• Ambiente
• Organizzazione
• Regione
• Origine dell'errore (proxy, destinazione o infrastruttura Apigee)

I dettagli possono includere anche:

• Criterio di errore: informazioni sul criterio che ha attivato l'errore di runtime, inclusi il tipo di criterio (nome interno) e il nome del criterio definito dall'utente. Devi definire il nome quando alleghi il criterio al flusso proxy API.
• Nome proxy
• Codice di stato HTTP
• Codice di errore

Se la cardinalità è maggiore di uno per una metrica specifica, il riquadro dei dettagli potrebbe includere dettagli sulla distribuzione degli errori, ad esempio Distribuzione tramite app sviluppatore, Norme sulla distribuzione per errore, Distribuzione per codice di errore, Distribuzione per stato HTTP e così via. Ad esempio:

Se l'origine del errore è il target, il riquadro dei dettagli includerà il tasso di errori per target. Ad esempio:

Utilizzare la dashboard Latenza

La dashboard Latenza mostra informazioni sulla latenza per i proxy API e i servizi di destinazione nella tua organizzazione. Puoi esaminare le metriche di latenza per una finestra di un'ora in qualsiasi momento negli ultimi 30 giorni.

Esplorare la dashboard Latenza

Per visualizzare la dashboard Latenza, seleziona Analizza > Monitoraggio API > Esamina nell'interfaccia utente perimetrale. Per impostazione predefinita viene visualizzata la dashboard Codice di stato. Seleziona Latenza nell'area dei filtri per visualizzare la dashboard Latenza.

Quando selezioni la dashboard Latenza, per impostazione predefinita vengono visualizzate le seguenti matrici:

• Proxy e tempo (latenza massima in millisecondi)
• Latenza proxy e latenza totale (latenza massima in millisecondi)
• Latenza del proxy e di tutti i target (latenza massima in millisecondi)

Utilizza la casella a discesa Proxy per selezionare Destinazione in modo da visualizzare le latenze di destinazione.

Per impostazione predefinita, la dashboard Latenza mostra le informazioni relative ai 10 proxy con la latenza P99 totale più elevata nell'ora precedente. In alternativa, utilizza la casella a discesa Primi 10 per selezionare un proxy o una raccolta specifica.

La dashboard Latenza include tutte le funzionalità della dashboard Codice di stato, con le seguenti differenze:

• È possibile configurare solo il percentile di latenza totale di risposta (p50, p90, p95, p99).
• Puoi selezionare solo una finestra di un'ora per le metriche di latenza.
• Non puoi selezionare Qualsiasi per Regione nei filtri. Devi selezionare una regione specifica da visualizzare.

Visualizza dettagli della metrica Latenza

Visualizza i dettagli di una metrica specifica facendo clic sul blocco corrispondente nella matrice.

I dettagli relativi alla latenza di un proxy (linea blu) e di un target (linea viola) sono visualizzati nel riquadro a destra, tra cui:

• Latenza totale (latenza proxy più latenza target)
• Latenza per target (tempo di risposta target)
• Distribuzione per stato HTTP

Passa il mouse sopra il grafico per visualizzare informazioni dettagliate:

Il grafico Latenza per target mostra i primi 16 target in base alla latenza massima, con un grafico per target. Passa il mouse sopra un grafico o seleziona l'elenco a discesa per determinare il grafico corrispondente a ciascun target.

Visualizza i log dai dettagli delle metriche

Quando visualizzi i dettagli delle metriche per codici di stato o latenza, fai clic su Visualizza log per visualizzare tutti i log relativi alla metrica selezionata:

Viene visualizzata la finestra di dialogo Log di traffico, che visualizza un massimo di 1000 voci di log. Fai clic su una voce di log per espanderne i dettagli nell'elenco:

Puoi filtrare ulteriormente i log in base a:

• Sorgente di traffico
• Tipo di errore
• Tempo minimo di risposta

Non puoi scaricare i dati dei log dalla finestra di dialogo Log di traffico. Tuttavia, puoi creare un report personalizzato o scaricare i dati di analisi nel tuo repository di dati, come Google Cloud Storage o BigQuery, per eseguire l'analisi dei tuoi dati.

Creare un report personalizzato dalla dashboard di indagine

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 rapporto personalizzato, procedi nel seguente modo:

1. Fai clic su un blocco nella matrice per visualizzare ulteriori dettagli.

   

2. Nel riquadro a destra, fai clic su .

   

   La pagina del report personalizzato viene visualizzata in una nuova scheda con i campi pertinenti precompilati.

   Nota: per ulteriori informazioni sulle impostazioni predefinite dei report personalizzati, consulta Creazione di report personalizzati.

   

3. Modifica il report personalizzato come richiesto. Consulta Gestire i report personalizzati.

4. Fai clic su Salva per salvare il report personalizzato.

Per impostazione predefinita, il report viene eseguito utilizzando i dati raccolti nell'ultima ora e i dati vengono visualizzati nella dashboard dei report personalizzati. Consulta Esplorazione della dashboard dei report personalizzati.

Nella pagina Report, i report personalizzati generati mediante API Monitoring hanno il seguente formato: API Monitoring Investigate Generated.

Esaminare un avviso specifico

Per esaminare un avviso specifico, seleziona il nome dell'avviso nella pagina Cronologia avvisi. Viene visualizzata la dashboard di indagine. Nota che contiene un grafico nella parte superiore della dashboard e include solo informazioni specifiche nell'avviso:

• Visualizza i dettagli del traffico API nel momento in cui è stato attivato l'avviso.
• Visualizza le informazioni contestuali sull'avviso, inclusa l'ora in cui è stato attivato, al centro del grafico.
• Fai clic su Dettagli condizione per visualizzare i dettagli della condizione dell'avviso in una finestra popup.

• Fai clic su Playbook (se disponibile) per visualizzare la guida pratica per l'avviso:

  

• Fai clic su Gestisci avviso per modificare l'avviso.

• Fai clic su Visualizza report (se disponibile) per visualizzare un report personalizzato.

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