Azure API Management API 분석 사용

적용 대상: 개발자 | 기본 | 기본 v2 | 표준 | 표준 v2 | 프리미엄

Azure API Management는 API에 대한 분석을 제공하므로 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 주소 매핑을 기반으로 하는 대략적인 값입니다.
  • 분석 데이터의 가용성이 15분 이상 지연될 수 있습니다.

Azure Monitor 기반 대시보드

Azure Monitor 기반 대시보드를 사용하려면 Log Analytics 작업 영역을 API Management 게이트웨이 로그의 데이터 원본으로 구성해야 합니다.

구성해야 하는 경우 게이트웨이 로그를 Log Analytics 작업 영역으로 보내는 간단한 단계는 다음과 같습니다. 자세한 내용은 자습서: 게시된 API 모니터링을 참조하세요. 이 설정은 한 번만 수행하면 됩니다.

  1. Azure Portal에서 API Management 인스턴스로 이동합니다.
  2. 왼쪽 메뉴의 모니터링에서 진단 설정>+ 진단 설정 추가를 선택합니다.
  3. 진단 설정을 설명하는 이름을 입력합니다.
  4. 로그에서 ApiManagement 게이트웨이 관련 로그를 선택합니다.
  5. 대상 세부 정보에서 Log Analytics로 보내기를 선택하고 동일하거나 다른 구독에서 Log Analytics 작업 영역을 선택합니다. 작업 영역을 만들어야 하는 경우 Log Analytics 작업 영역 만들기를 참조하세요.
  6. 다른 설정에 대해서는 기본값을 수락하거나 필요에 따라 사용자 지정합니다. 저장을 선택합니다.

대시보드에 액세스

Log Analytics 작업 영역이 구성된 후 Azure Monitor 기반 대시보드에 액세스하여 API의 사용량과 성능을 분석합니다.

  1. Azure Portal에서 API Management 인스턴스로 이동합니다.
  2. 왼쪽 메뉴의 모니터링에서 인사이트를 선택합니다. 분석 대시보드가 열립니다.
  3. 데이터의 시간 범위를 선택합니다.
  4. 분석 데이터의 보고서 범주(예: 타임라인, 지역)를 선택합니다.

레거시 기본 제공 분석

특정 API Management 서비스 계층에서는 Azure Portal에서도 기본 제공 분석을 사용할 수 있으며, API Management REST API를 사용하여 분석 데이터에 액세스할 수 있습니다.

기본 제공된 분석 - 포털

Azure Portal에서 기본 제공 분석에 액세스하려면 다음을 수행합니다.

  1. Azure Portal에서 API Management 인스턴스로 이동합니다.
  2. 왼쪽 메뉴의 모니터링에서 분석을 선택합니다.
  3. 데이터의 시간 범위를 선택하거나 사용자 지정 시간 범위를 입력합니다.
  4. 분석 데이터의 보고서 범주(예: 타임라인, 지역)를 선택합니다.
  5. 필요에 따라 하나 이상의 추가 범주로 보고서를 필터링합니다.

분석 - REST API

API Management REST API의 보고서 작업을 사용하여 API Management 인스턴스에 대한 분석 데이터를 검색하고 필터링합니다.

지원되는 작업은 API, 지역, API 작업, 제품, 요청, 구독, 시간 또는 사용자별로 보고서 레코드를 반환합니다.