Azure Monitor Log Analytics API 개요
Log Analytics Query API는 Azure Monitor 로그에서 수집한 전체 데이터 집합을 쿼리할 수 있는 REST API입니다. 서비스 전체에서 사용되는 것과 동일한 쿼리 언어를 사용할 수 있습니다. 이 API를 사용하여 데이터를 검색하고 데이터의 새로운 시각화를 빌드하고 Log Analytics의 기능을 확장합니다.
Log Analytics API 인증
Log Analytics API에 액세스하려면 인증해야 합니다.
- 작업 영역을 쿼리하려면 Microsoft Entra 인증을 사용해야 합니다.
- Microsoft Entra 인증을 사용하지 않고 API를 빠르게 탐색하려면 API 키를 사용하여 비프로덕션 환경에서 샘플 데이터를 쿼리할 수 있습니다.
작업 영역 데이터에 대한 Microsoft Entra 인증
Log Analytics API는 세 가지 다른 Microsoft Entra ID OAuth2 흐름으로 Microsoft Entra 인증을 지원합니다.
- 인증 코드
- 암시적
- 클라이언트 자격 증명
인증 코드 흐름과 암시적 흐름 모두 애플리케이션에 대한 사용자 대화식 로그인이 한 번 이상 필요합니다. 비대화형 흐름이 필요한 경우 클라이언트 자격 증명 흐름을 사용합니다.
토큰을 받은 후 Log Analytics API를 호출하는 프로세스는 모든 흐름에서 동일합니다. 요청에는 OAuth2 흐름에서 받은 토큰으로 채워진 Authorization: Bearer 헤더가 필요합니다.
샘플 데이터에 대한 API 키 인증
Microsoft Entra 인증을 사용하지 않고 API를 빠르게 탐색할 수 있도록 샘플 데이터가 포함된 데모 작업 영역을 제공합니다. API 키를 사용하여 인증할 수 있습니다.
참고 항목
Microsoft Entra 인증을 사용하는 경우 Application Insights REST API가 새로운 역할 기반 액세스 제어 권한을 인식하는 데 최대 60분이 걸릴 수 있습니다. 권한이 전파되는 동안 REST API 호출이 실패하여 오류 코드 403이 나타날 수 있습니다.
Log Analytics API 쿼리 제한
쿼리 제한에 대한 자세한 내용은 이 웹 페이지의 API 쿼리를 참조하세요.
Log Analytics API 시도
코드를 작성하지 않고 API를 시도하려면 다음을 사용할 수 있습니다.
- Bruno나 Insomnia와 같은 선호하는 클라이언트를 사용하여 사용자 인터페이스를 통해 수동으로 쿼리를 생성합니다.
- 명령줄에서 cURL을 실행합니다. 그런 다음 출력을 jsonlint로 파이프하여 읽을 수 있는 JSON을 가져옵니다.
REST API를 직접 호출하는 대신 관용적인 Azure Monitor 쿼리 클라이언트 라이브러리를 사용할 수도 있습니다.
각 클라이언트 라이브러리는 작업 영역에서 로그 데이터를 검색할 수 있는 REST API의 래퍼입니다.