Informazioni sull'osservabilità di Apigee

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Monitoraggio API Apigee, Analisi API Apigee e log di accesso Apigee sono tre potenti strumenti che puoi utilizzare per raccogliere, osservare e comprendere i dati di utilizzo delle API. Ognuno di questi strumenti fornisce approfondimenti diversi ed è consigliato per casi d'uso diversi. Questo documento fornisce una breve panoramica dello scopo di ciascun strumento e del suo utilizzo consigliato, come descritto nelle sezioni seguenti:

Monitoraggio delle API

Lo scopo del monitoraggio delle API è fornire informazioni in tempo reale sulle prestazioni delle API, in modo da poter diagnosticare e risolvere rapidamente i problemi e mantenere le API in funzione come previsto.

Il monitoraggio delle API fornisce dati aggregati dai proxy API su base giornaliera, consentendoti di monitorare attentamente l'integrità e le prestazioni delle tue API. Puoi utilizzare il monitoraggio delle API per configurare avvisi quasi in tempo reale su parametri specificati e sfruttare i dati aggregati durante la risoluzione dei problemi.

L'API Monitoring ti consente di:

  • Mantieni la disponibilità delle tue API.
  • Intervieni sugli avvisi prima che i consumatori ne siano interessati.
  • Utilizza i codici di errore Apigee per velocizzare la diagnosi dei problemi.
  • Isola rapidamente le aree problematiche per diagnosticare la fonte dei problemi di prestazioni e latenza.

I clienti Apigee possono anche utilizzare gli strumenti di Cloud Monitoring per supportare il monitoraggio delle API. Se vuoi eseguire l'integrazione con altri sistemi di monitoraggio, ti consigliamo di utilizzare l'API Monitoring per estrarre le metriche.

Dati sulla latenza quando si utilizza il monitoraggio dell'API

Poiché il monitoraggio dell'API è progettato intenzionalmente per essere scalabile, non registra ogni singola misurazione della latenza in ogni transazione. I bucket di distribuzione vengono utilizzati per misurare le latenze. I bucket di latenza utilizzano intervalli predefiniti per raggruppare i valori di latenza osservati.

Per scoprire di più sull'utilizzo di API Monitoring per le tue API, consulta la panoramica di API Monitoring.

Per scoprire di più sull'utilizzo di Monitoring insieme ad Apigee per configurare gli avvisi, consulta Configurare avvisi e notifiche.

Apigee API Analytics

Apigee API Analytics fornisce analisi delle tendenze storiche e report dettagliati per i metadati delle chiamate API. Lo scopo di Apigee Analytics è aiutarti a comprendere le tendenze a lungo termine del traffico delle API, in modo da assicurarti che le API supportino i requisiti della tua attività o apportare modifiche, se necessario.

Con Apigee API Analytics, puoi scegliere tra circa 50 dimensioni disponibili che specificano i dati da acquisire per ogni chiamata API gestita da un proxy. In seguito, puoi creare report personalizzati per determinare in che modo metriche API specifiche cambiano nel tempo.

I dati di analisi acquisiti vengono archiviati in BigQuery. Puoi utilizzare API Analytics di Apigee per creare report personalizzati in Looker Studio, configurare job di report personalizzati asincroni o esportare i dati di analisi nel tuo Google Cloud repository di archiviazione, ad esempio BigQuery.Se inizi con i prezzi di pagamento a consumo, API Analytics è un componente aggiuntivo facoltativo.

Ecco alcune delle tendenze che puoi identificare utilizzando Apigee Analytics:

  • Quali sono le tendenze del traffico API nel tempo?
  • Quali sono le tue app più utilizzate?
  • Chi sono i tuoi sviluppatori principali?
  • Quando il tempo di risposta dell'API è più rapido o più lento?
  • Quali regioni geografiche generano il maggior volume di traffico API?

Dati sulla latenza quando si utilizza l'analisi dell'API Apigee

La latenza osservata in Apigee API Analytics utilizza una funzione di aggregazione quantile approssimativa sui singoli record archiviati in BigQuery. In questo modo, i dati risultanti sulla latenza sono più precisi rispetto alla logica di raggruppamento utilizzata nel monitoraggio dell'API. La latenza sia in API Monitoring sia in Apigee API Analytics viene misurata dal runtime di Apigee e non include i calcoli della latenza dei hop di rete precedenti, incluso Istio.

Per scoprire di più su Apigee API Analytics, consulta la panoramica di Apigee API Analytics.

Log di accesso di Apigee

I log di accesso di Apigee possono essere utilizzati per risolvere i problemi relativi alle chiamate API ad Apigee e identificare le API che restituiscono determinati codici di risposta HTTP.

I log di accesso di Apigee acquisiscono i log per transazione nel gateway di ingresso di Apigee. In questo modo, puoi filtrare i log in base a codici HTTP specifici e risolvere facilmente i casi limite, ad esempio un codice di stato della risposta 0 su Istio.

Per scoprire di più sull'utilizzo dei log di accesso di Apigee per risolvere i problemi relativi alle API, consulta Log di accesso di Apigee.

Differenze tra i dati visualizzati dai dati di monitoraggio dell'API e da Analytics

Il monitoraggio delle API e l'analisi dell'API Apigee utilizzano pipeline diverse per accedere ai dati dell'API. Di conseguenza, potresti notare alcune discrepanze tra i dati visualizzati dalle dashboard di Apigee API Analytics e quelli disponibili in API Monitoring.

Tempestività e accuratezza

In generale, i dati visualizzati da Apigee API Analytics sono più accurati, ma potrebbero essere leggermente in ritardo (meno di un'ora) rispetto ai dati visualizzati da API Monitoring.

Conservazione dei dati

Apigee API Analytics conserva i dati per un periodo di tempo più lungo rispetto a API Monitoring, il che lo rende più adatto all'analisi delle tendenze a lungo termine.

I periodi di conservazione dei dati per il monitoraggio di Analytics e delle API sono i seguenti:

  • Analytics

    • Consegna standard: 60 giorni
    • Enterprise: 90 giorni
    • Enterprise +: 14 mesi
  • Monitoraggio API: 1 mese