Panoramica dell'API Log Analytics di Monitoraggio di Azure

  • Articolo

L'API di query di Log Analytics è un'API REST che è possibile usare per eseguire query sul set completo di dati raccolti dai log di Monitoraggio di Azure. È possibile usare lo stesso linguaggio di query usato in tutto il servizio. Usare questa API per recuperare i dati, creare nuove visualizzazioni dei dati ed estendere le funzionalità di Log Analytics.

Autenticazione dell'API di Log Analytics

È necessario eseguire l'autenticazione per accedere all'API Log Analytics:

  • Per eseguire query sulle aree di lavoro, è necessario usare l'autenticazione Microsoft Entra.
  • Per esplorare rapidamente l'API senza usare l'autenticazione di Microsoft Entra, è possibile usare una chiave API per eseguire query sui dati di esempio in un ambiente non di produzione.

Autenticazione di Microsoft Entra per i dati dell'area di lavoro

L'API Log Analytics supporta l'autenticazione di Microsoft Entra con tre diversi flussi di Microsoft Entra ID OAuth2:

  • Codice di autorizzazione
  • Implicito
  • Credenziali del client

Il flusso del codice di autorizzazione e il flusso implicito richiedono almeno un accesso interattivo utente all'applicazione. Se è necessario un flusso non interattivo, usare il flusso delle credenziali client.

Dopo aver ricevuto un token, il processo per chiamare l'API di Log Analytics è lo stesso per tutti i flussi. Per le richieste è necessaria l'intestazione Authorization: Bearer, compilata con il token ricevuto dal flusso OAuth2.

Autenticazione della chiave API per dati di esempio

Per esplorare rapidamente l'API senza usare l'autenticazione di Microsoft Entra, viene fornita un'area di lavoro dimostrativa con dati di esempio. È possibile eseguire l'autenticazione usando una chiave API.

Nota

Quando si usa l'autenticazione di Microsoft Entra, potrebbero essere necessari fino a 60 minuti prima che l'API REST di Application Insights riconosca le nuove autorizzazioni di controllo degli accessi in base al ruolo. Durante la propagazione delle autorizzazioni, le chiamate API REST potrebbero non riuscire con codice di errore 403.

Limiti delle query dell'API di Log Analytics

Per informazioni sui limiti delle query, vedere la Sezione API query di questa pagina Web.

Provare l'API di Log Analytics

Per provare l'API senza scrivere codice, è possibile usare:

  • Il client preferito, ad esempio Bruno o Insomnia, per generare manualmente query con un'interfaccia utente.
  • cURL dalla riga di comando. Quindi inviare in pipe l'output in jsonlint per ottenere il codice JSON leggibile.

Anziché chiamare direttamente l'API REST, è possibile usare le librerie client di query di Monitoraggio di Azure idiomatiche:

Ogni libreria client è un wrapper dell'API REST che consente di recuperare i dati di log dall'area di lavoro.