Ottenere analisi API in Gestione API di Azure

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

Azure Gestione API fornisce analisi 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 quasi in tempo reale e i log delle risorse per la diagnostica e il controllo, vedere Esercitazione: Monitorare le API pubblicate.

Screenshot dell'analisi api nel portale.

Informazioni sull'analisi delle API

  • Gestione API fornisce analisi tramite 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 classici, l'istanza di Gestione API include anche analisi predefinite legacy nel portale di Azure ed è possibile accedere ai dati di analisi usando l'API REST Gestione API. I dati equivalenti 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 di analisi.
  • L'analisi predefinita legacy non è disponibile nei livelli v2.

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

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

Nota

  • Analisi API fornisce 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 di analisi.

Dashboard basato su Monitoraggio di Azure

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

Se è necessario configurare una, di seguito sono riportati alcuni passaggi per inviare i log del gateway a un'area di lavoro Log Analytics. 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 menu a sinistra, 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 a 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. Accettare le impostazioni predefinite per altre impostazioni o personalizzare in base alle esigenze. 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 Informazioni dettagliate. 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.

Analisi predefinita legacy

In alcuni livelli di servizio di Gestione API, l'analisi predefinita è disponibile anche nel portale di Azure e i dati di analisi possono essere accessibili usando l'API REST Gestione API.

Analisi predefinita - Portale

Per accedere all'analisi predefinita nel portale di Azure:

  1. Nel portale di Azure accedere all'istanza di Gestione API.
  2. Nel menu a sinistra, in Monitoraggio selezionare Analisi.
  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.