Přehled rozhraní Log Analytics API služby Azure Monitor

  • Článek

Rozhraní API pro dotazy Log Analytics je rozhraní REST API, které můžete použít k dotazování úplné sady dat shromážděných protokoly služby Azure Monitor. Můžete použít stejný dotazovací jazyk, který se používá v celé službě. Pomocí tohoto rozhraní API můžete načítat data, vytvářet nové vizualizace dat a rozšiřovat možnosti Log Analytics.

Ověřování rozhraní API log Analytics

Abyste mohli získat přístup k rozhraní API log Analytics, musíte se ověřit:

  • K dotazování pracovních prostorů musíte použít ověřování Microsoft Entra.
  • Pokud chcete rychle prozkoumat rozhraní API bez použití ověřování Microsoft Entra, můžete použít klíč rozhraní API k dotazování ukázkových dat v neprodukčním prostředí.

Ověřování Microsoft Entra pro data pracovního prostoru

Rozhraní Log Analytics API podporuje ověřování Microsoft Entra se třemi různými toky Microsoft Entra ID OAuth2 :

  • Autorizační kód
  • Implicitní
  • Přihlašovací údaje klienta

Tok autorizačního kódu i implicitní tok vyžadují aspoň jedno interaktivní přihlášení uživatele k vaší aplikaci. Pokud potřebujete neinteraktivní tok, použijte tok přihlašovacích údajů klienta.

Po přijetí tokenu je proces volání rozhraní LOG Analytics API stejný pro všechny toky. Požadavky vyžadují hlavičku Authorization: Bearer vyplněnou tokenem přijatým z toku OAuth2.

Ověřování klíče rozhraní API pro ukázková data

Abychom mohli rychle prozkoumat rozhraní API bez použití ověřování Microsoft Entra, poskytujeme ukázkový pracovní prostor s ukázkovými daty. Ověření můžete provést pomocí klíče rozhraní API.

Poznámka:

Pokud používáte ověřování Microsoft Entra, může trvat až 60 minut, než aplikace Přehledy ROZHRANÍ REST API rozpozná nové oprávnění řízení přístupu na základě role. Zatímco se oprávnění šíří, volání rozhraní REST API můžou selhat s kódem chyby 403.

Omezení dotazů rozhraní API služby Log Analytics

Informace o omezeních dotazů najdete v části Rozhraní API pro dotazy na této webové stránce.

Vyzkoušejte rozhraní LOG Analytics API

Pokud chcete rozhraní API vyzkoušet bez psaní kódu, můžete použít:

  • Váš oblíbený klient, jako je Fiddler nebo Postman , aby ručně vygeneroval dotazy s uživatelským rozhraním.
  • cURL z příkazového řádku. Pak výstup předejte do jsonlintu , abyste získali čitelný JSON.

Místo přímého volání rozhraní REST API můžete použít idiomaticé klientské knihovny Azure Monitoru:

Každá klientská knihovna je obálka kolem rozhraní REST API, která umožňuje načíst data protokolu z pracovního prostoru.