Az Azure Monitor Log Analytics API áttekintése

A Log Analytics Query API egy REST API, amellyel lekérdezheti az Azure Monitor-naplók által gyűjtött adatok teljes készletét. Ugyanazt a lekérdezési nyelvet használhatja, amelyet a szolgáltatás egészében használ. Ezzel az API-val lekérheti az adatokat, új vizualizációkat hozhat létre az adatokból, és kibővítheti a Log Analytics képességeit.

Log Analytics API-hitelesítés

Hitelesítenie kell magát a Log Analytics API eléréséhez:

  • A munkaterületek lekérdezéséhez Microsoft Entra-hitelesítést kell használnia.
  • Ha gyorsan szeretné megismerni az API-t a Microsoft Entra-hitelesítés használata nélkül, egy API-kulccsal lekérdezheti a mintaadatokat egy nem éles környezetben.

Microsoft Entra-hitelesítés munkaterület-adatokhoz

A Log Analytics API három különböző Microsoft Entra ID OAuth2-folyamattal támogatja a Microsoft Entra-hitelesítést:

  • Engedélyezési kód
  • Magától értetődő
  • Ügyfél-hitelesítő adatok

Az engedélyezési kód folyamata és az implicit folyamat egyaránt legalább egy interaktív felhasználói bejelentkezést igényel az alkalmazásba. Ha nem interaktív folyamatra van szüksége, használja az ügyfél hitelesítő adatait.

Miután megkapta a tokent, a Log Analytics API meghívásának folyamata minden művelet esetében ugyanaz. A kérelmekhez szükség van az Authorization: Bearer OAuth2-folyamattól kapott jogkivonattal kitöltött fejlécre.

API-kulcs hitelesítése mintaadatokhoz

Ahhoz, hogy gyorsan felfedezhesse az API-t a Microsoft Entra-hitelesítés használata nélkül, egy bemutató munkaterületet biztosítunk mintaadatokkal. A hitelesítést API-kulccsal végezheti el.

Megjegyzés

Ha Microsoft Entra-hitelesítést használ, az Application Insights REST API akár 60 percet is igénybe vehet az új szerepköralapú hozzáférés-vezérlési engedélyek felismeréséhez. Az engedélyek propagálása közben a REST API-hívások a 403-es hibakóddal meghiúsulhatnak.

A Log Analytics API lekérdezési korlátai

A lekérdezési korlátokról további információt a weblap Lekérdezési API szakaszában talál.

A Log Analytics API kipróbálása

Ha kód írása nélkül szeretné kipróbálni az API-t, a következőket használhatja:

  • Kedvenc kliensével, például a Bruno-val vagy az Insomnia-val, manuálisan hozhat létre lekérdezéseket a felhasználói felületen.
  • cURL a parancssorból. Ezután a kimenetet jsonlintbe csövezve olvasható JSON-t kap.

A REST API közvetlen meghívása helyett használhatja az idiomatikus Azure Monitor Query-ügyfélkódtárakat:

Minden kliens könyvtár a REST API segítségével csomagolóként működik, lehetővé téve a naplóadatok elérését a munkaterületről.

Következő lépések

  • Last updated on