Overzicht van Azure Monitor-logboekanalyse-API
De Log Analytics-query-API is een REST API die u kunt gebruiken om een query uit te voeren op de volledige set gegevens die worden verzameld door Azure Monitor-logboeken. U kunt dezelfde querytaal gebruiken die in de hele service wordt gebruikt. Gebruik deze API om gegevens op te halen, nieuwe visualisaties van uw gegevens te bouwen en de mogelijkheden van Log Analytics uit te breiden.
Log Analytics API-verificatie
U moet zich verifiëren voor toegang tot de Log Analytics-API:
- Als u een query wilt uitvoeren op uw werkruimten, moet u Microsoft Entra-verificatie gebruiken.
- Als u de API snel wilt verkennen zonder Microsoft Entra-verificatie te gebruiken, kunt u een API-sleutel gebruiken om een query uit te voeren op voorbeeldgegevens in een niet-productieomgeving.
Microsoft Entra-verificatie voor werkruimtegegevens
De Log Analytics-API ondersteunt Microsoft Entra-verificatie met drie verschillende OAuth2-stromen voor Microsoft Entra-id:
- Autorisatiecode
- Impliciet
- Clientreferenties
Voor de autorisatiecodestroom en impliciete stroom moeten beide ten minste één gebruiker interactief aanmelden bij uw toepassing. Als u een niet-interactieve stroom nodig hebt, gebruikt u de clientreferentiestroom.
Nadat u een token hebt ontvangen, is het proces voor het aanroepen van de Log Analytics-API hetzelfde voor alle stromen. Aanvragen vereisen de Authorization: Bearer header, gevuld met het token dat is ontvangen van de OAuth2-stroom.
VERIFICATIE van API-sleutel voor voorbeeldgegevens
Om snel de API te verkennen zonder Microsoft Entra-verificatie te gebruiken, bieden we een demonstratiewerkruimte met voorbeeldgegevens. U kunt verifiëren met behulp van een API-sleutel.
Notitie
Wanneer u Microsoft Entra-verificatie gebruikt, kan het tot 60 minuten duren voordat de Application Insights REST API nieuwe machtigingen voor op rollen gebaseerd toegangsbeheer herkent. Terwijl machtigingen worden doorgegeven, kunnen REST API-aanroepen mislukken met foutcode 403.
Querylimieten voor Log Analytics-API
Zie de sectie Query-API van deze webpagina voor informatie over querylimieten.
De Log Analytics-API uitproberen
Als u de API wilt proberen zonder code te schrijven, kunt u het volgende gebruiken:
- Uw favoriete client, zoals Fiddler of Postman , om handmatig query's te genereren met een gebruikersinterface.
- cURL vanaf de opdrachtregel. Sluis vervolgens de uitvoer door naar jsonlint om leesbare JSON op te halen.
In plaats van de REST API rechtstreeks aan te roepen, kunt u de idiomatische Azure Monitor Query-clientbibliotheken gebruiken:
Elke clientbibliotheek is een wrapper rond de REST API waarmee u logboekgegevens uit de werkruimte kunt ophalen.