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
- Implicit
- Ü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 jogkivonatot, a Log Analytics API meghívásának folyamata minden folyamat 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.
Feljegyzé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 ügyfele, például Bruno vagy Insomnia , hogy manuálisan hozzon létre lekérdezéseket egy 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 ügyfélkódtár egy burkoló a REST API körül, amely lehetővé teszi a naplóadatok lekérését a munkaterületről.