Azure API Management API 분석 사용
적용 대상: 개발자 | 기본 | 기본 v2 | 표준 | 표준 v2 | 프리미엄 | 프리미엄 v2
Azure API Management는 API에 대한 분석을 제공하므로 API의 사용량과 성능을 분석할 수 있습니다. 분석을 사용하여 API에 대한 개괄적인 모니터링과 문제 해결을 수행할 수 있습니다. 진단과 감사에 대한 근 실시간 메트릭 및 리소스 로그를 비롯한 다른 모니터링 기능은 자습서: 게시된 API 모니터링을 참조하세요.
참고 항목
현재 이 기능은 작업 영역에서 사용할 수 없습니다.
API 분석 정보
API Management는 Azure Monitor 기반 대시보드를 사용하여 분석을 제공합니다. 대시보드는 Azure Log Analytics 작업 영역의 데이터를 집계합니다.
클래식 API Management 서비스 계층에서 API Management 인스턴스에는 Azure Portal의 레거시 클래식 제공 분석도 포함되어 있으며, API Management REST API를 사용하여 분석 데이터에 액세스할 수 있습니다. Azure Monitor 기반 대시보드와 기본 제공 분석에서도 매우 유사한 데이터가 표시됩니다.
Important
- Azure Monitor 기반 대시보드는 분석 데이터에 액세스하는 데 권장되는 방법입니다.
- v2 계층에서는 클래식 제공(클래식) 분석 기능을 사용할 수 없습니다.
API 분석을 사용하면 다음을 포함한 여러 차원에 걸쳐 API Management 인스턴스의 API 사용량과 성능을 분석할 수 있습니다.
- Time
- Geography
- API
- API 작업
- 제품
- Abunələr
- 사용자
- 요청
참고 항목
- API 분석은 실패한 요청과 권한이 없는 요청을 포함한 요청에 대한 데이터를 제공합니다.
- 지리 값은 IP 주소 매핑을 기반으로 하는 대략적인 값입니다.
- 분석 데이터의 가용성이 지연될 수 있습니다.
Azure Monitor 기반 대시보드
Azure Monitor 기반 대시보드를 사용하려면 API Management 게이트웨이 로그의 데이터 원본으로 Log Analytics 작업 영역이 필요합니다.
구성해야 하는 경우 게이트웨이 로그를 Log Analytics 작업 영역으로 보내는 간단한 단계는 다음과 같습니다. 자세한 내용은 자습서: 게시된 API 모니터링을 참조하세요. 이 설정은 한 번만 수행하면 됩니다.
- Azure Portal에서 API Management 인스턴스로 이동합니다.
- 왼쪽 메뉴의 모니터링에서 진단 설정>+ 진단 설정 추가를 선택합니다.
- 진단 설정을 설명하는 이름을 입력합니다.
- 로그에서 ApiManagement 게이트웨이 관련 로그를 선택합니다.
- 대상 세부 정보에서 Log Analytics로 보내기를 선택하고 동일하거나 다른 구독에서 Log Analytics 작업 영역을 선택합니다. 작업 영역을 만들어야 하는 경우 Log Analytics 작업 영역 만들기를 참조하세요.
- 대상 테이블로 특정 리소스가 선택되어 있는지 확인합니다.
- 저장을 선택합니다.
Important
새 Log Analytics 작업 영역은 데이터 수신을 시작하는 데 최대 2시간이 걸릴 수 있습니다. 기존 작업 영역은 약 15분 내에 데이터 수신을 시작해야 합니다.
대시보드에 액세스
Log Analytics 작업 영역이 구성된 후 Azure Monitor 기반 대시보드에 액세스하여 API의 사용량과 성능을 분석합니다.
- Azure Portal에서 API Management 인스턴스로 이동합니다.
- 왼쪽 메뉴의 모니터링에서 분석을 선택합니다. 분석 대시보드가 열립니다.
- 데이터의 시간 범위를 선택합니다.
- 분석 데이터의 보고서 범주(예: 타임라인, 지역)를 선택합니다.
레거시 기본 제공 분석
특정 API Management 서비스 계층에서는 클래식 제공 분석(레거시 분석 또는 클래식 분석이라고도 함)도 Azure Portal에서 사용할 수 있으며, API Management REST API를 사용하여 분석 데이터에 액세스할 수 있습니다.
기본 제공된 분석 - 포털
Azure Portal에서 클래식 제공(클래식) 분석에 액세스하려면:
- Azure Portal에서 API Management 인스턴스로 이동합니다.
- 왼쪽 메뉴의 모니터링에서 분석(클래식)을 선택합니다.
- 데이터의 시간 범위를 선택하거나 사용자 지정 시간 범위를 입력합니다.
- 분석 데이터의 보고서 범주(예: 타임라인, 지역)를 선택합니다.
- 원하는 경우, 하나 이상의 다른 범주로 보고서를 필터링합니다.
분석 - REST API
API Management REST API의 보고서 작업을 사용하여 API Management 인스턴스에 대한 분석 데이터를 검색하고 필터링합니다.
지원되는 작업은 API, 지역, API 작업, 제품, 요청, 구독, 시간 또는 사용자별로 보고서 레코드를 반환합니다.
관련 콘텐츠
- API Management Azure Monitor 기능에 대한 소개는 자습서: 게시된 API 모니터링을 참조하세요.
- 자세한 HTTP 로깅 및 모니터링은 Azure API Management, Event Hubs, Moesif를 통한 API 모니터링을 참조하세요.
- Azure API Management와 Azure Application Insights의 통합에 대해 알아보세요.
- 기본 제공 API 분석 대시보드 사용 중지(2027년 3월)에 대해 알아봅니다.