Condividi tramite


Ottenere analisi API in Gestione API di Azure

SI APPLICA A: Developer | Basic | Basic v2 | Standard | Standard v2 | Premium

Gestione API di Azure offre analitica per le API in modo da poter analizzare l'utilizzo e le prestazioni. Usare l'analisi per il monitoraggio generale e la risoluzione dei problemi delle API. Per altre funzionalità di monitoraggio, incluse le metriche near real-time e i log delle risorse per la diagnostica e il controllo, vedere Esercitazione: monitorare le API pubblicate.

Screenshot dell'analisi API nel portale.

Nota

Attualmente, questa funzionalità non è disponibile nelle aree di lavoro.

Informazioni sulle analisi API

  • Gestione API fornisce analisi usando un dashboard basato su Monitoraggio di Azure. Il dashboard aggrega i dati in un'area di lavoro Log Analytics di Azure.

  • Nei livelli di servizio di Gestione API classica, l'istanza di Gestione API include anche analisi predefinite nel portale di Azure e i dati di analisi sono accessibili usando l'API REST di Gestione API. Dati molto simili vengono visualizzati nel dashboard basato su Monitoraggio di Azure e nell'analisi predefinita.

Importante

  • Il dashboard basato su Monitoraggio di Azure è il modo consigliato per accedere ai dati analitici.
  • L'analisi predefinita (classica) non è disponibile nei livelli v2.

Con le analisi delle API, analizzare l'utilizzo e le prestazioni delle API nell'istanza di Gestione API su diverse dimensioni, tra cui:

  • Time
  • Geografia
  • API
  • Operazioni API
  • Prodotti
  • Sottoscrizioni
  • Utenti
  • Richieste

Nota

  • Le analisi delle API forniscono dati sulle richieste, incluse le richieste non riuscite e non autorizzate.
  • I valori geografia sono approssimativi in base al mapping degli indirizzi IP.
  • Potrebbe verificarsi un ritardo di 15 minuti o più nella disponibilità dei dati analitici.

Dashboard basato su Monitoraggio di Azure

Per usare il dashboard basato su Monitoraggio di Azure, è necessaria un'area di lavoro Log Analytics come origine dati per i log del gateway di Gestione API.

Se è necessario configurarne una, di seguito sono riportati alcuni passaggi per inviare i log del gateway a un'area di lavoro Log Analitica. Per altre informazioni, vedere Esercitazione: Monitorare le API pubblicate. Si tratta di un'attività una tantum.

  1. Nel portale di Azure accedere all'istanza di Gestione API.
  2. Nel riquadro del menu centrale, in Monitoraggio selezionare Impostazioni di diagnostica>+ Aggiungi impostazione di diagnostica.
  3. Immettere un nome descrittivo per l'impostazione di diagnostica.
  4. In Log selezionare Log correlati ad ApiManagement Gateway.
  5. In Dettagli destinazione selezionare Invia a Log Analytics e selezionare un'area di lavoro Log Analytics nella stessa sottoscrizione o in una sottoscrizione diversa. Se è necessario creare un'area di lavoro, vedere Creare un'area di lavoro Log Analytics.
  6. Assicurarsi che l'opzione Specifica della risorsa sia selezionata come tabella di destinazione.
  7. Seleziona Salva.

Accedere al dashboard

Dopo aver configurato un'area di lavoro Log Analytics, accedere al dashboard basato su Monitoraggio di Azure per analizzare l'utilizzo e le prestazioni delle API.

  1. Nel portale di Azure accedere all'istanza di Gestione API.
  2. Nel menu a sinistra, in Monitoraggio selezionare Analisi. Verrà aperto il dashboard di analisi.
  3. Selezionare un intervallo di tempo per i dati.
  4. Selezionare una categoria di report per i dati di analisi, ad esempio Sequenza temporale, Geografia e così via.

Analitica predefinita legacy

In alcuni livelli di servizio Gestione API, è disponibile anche l'analisi predefinita (chiamata anche analisi legacy o analisi classica) nel portale di Azure e i dati di analisi sono accessibili usando l'API REST di Gestione API.

Analisi incorporata - portale

Per accedere alle analisi predefinite (versione classica) nel portale di Azure:

  1. Nel portale di Azure accedere all'istanza di Gestione API.
  2. Nel menu a sinistra, in Monitoraggio selezionare Analisi (versione classica).
  3. Selezionare un intervallo di tempo per i dati, o immettere un intervallo di tempo personalizzato.
  4. Selezionare una categoria di report per i dati di analisi, ad esempio Sequenza temporale, Geografia e così via.
  5. Facoltativamente, filtrare il report in base a una o più categorie aggiuntive.

Analisi - API REST

Usare le operazioni dei report dell'API REST di Gestione API per recuperare e filtrare i dati di analisi per l'istanza di Gestione API.

Le operazioni disponibili restituiscono record di report in base all'API, all'area geografica, alle operazioni API, al prodotto, alla richiesta, alla sottoscrizione, all'ora o all'utente.