API 사용량 모니터링

이 페이지에서는 API 측정항목을 사용하여 Google API 및 Google Cloud API의 사용량을 추적하고 이해하는 방법을 설명합니다.

Google API에서 생성하는 자세한 사용량 측정항목으로 다음을 수행할 수 있습니다.

  • Google API 사용량 추적 및 이해
  • 애플리케이션 및 Google API의 성능 모니터링
  • 애플리케이션과 Google API 사이의 문제 발견

문제를 해결하거나 Google의 기술 지원이 필요할 때 해결 시간을 크게 단축할 수 있습니다.

Google API가 생성하는 측정항목은 Google의 사이트 안정성 엔지니어링이 서비스 상태를 평가하는 데 사용하는 표준 신호입니다. 이러한 측정항목에는 요청 수, 오류율, 총 지연 시간, 백엔드 지연 시간, 요청 크기, 응답 크기가 포함됩니다. API 측정항목 정의는 Cloud Monitoring 문서를 참조하세요.

API 측정항목은 API 대시보드와 Cloud Monitoring 두 곳에서 확인할 수 있습니다. 표시되는 측정항목은 프로젝트에 따라 달라지며 전체 서비스 상태를 반영하지 않습니다.

API 대시보드 사용

API 측정항목을 보는 가장 간단한 방법은 Google Cloud Console의 API 대시보드를 사용하는 것입니다. 모든 API 사용량 개요를 보거나 특정 API의 사용량을 상세히 살펴볼 수 있습니다.

API 사용량 개요를 보려면 다음 안내를 따르세요.

  1. Cloud 콘솔의 API 및 서비스 섹션으로 이동합니다. 기본 API 대시보드가 기본적으로 표시됩니다. 이 페이지에서는 현재 프로젝트에 사용 설정되어 있는 모든 API를 비롯해 다음 측정항목에 대한 개요 차트를 표시할 수 있습니다.

    • 트래픽: 사용 설정된 API에 대해 프로젝트에서 수행되거나 관련된 초당 요청 수
    • 오류: 사용 설정된 API에 대한 요청 중에서 오류가 발생한 요청의 비율(%)
    • 지연 시간 중앙값: 사용 설정된 API에 대한 요청의 지연 시간 중앙값(사용 가능한 경우).

특정 API에 대한 사용량 세부정보를 보는 방법:

  1. API의 주요 API 대시보드 목록에서 보려고 하는 API를 선택합니다. 해당 API의 개요 페이지가 나타나면서 응답 코드를 기준으로 분류된 트래픽 차트가 더욱 자세하게 표시됩니다.

  2. 이것보다 더욱 자세한 사용량 정보를 원한다면 측정항목 보기를 선택합니다. 사용할 수 있는 차트가 더욱 많지만 기본적으로 다음과 같이 사전 작성된 차트가 표시됩니다.

    • 응답 코드별 트래픽
    • API 메서드별 오류
    • 50번째, 95번째, 99번째 백분위수의 전체 지연 시간
    • API 메서드별 지연 시간(중앙값)

  3. 차트를 더 추가하려면 그래프 선택 드롭다운 메뉴에서 사전 작성된 차트를 추가로 선택할 수 있습니다.

Cloud Monitoring 사용

Cloud Monitoring을 사용하면 측정항목 탐색기를 통해 사용 가능한 측정항목 데이터를 자세히 살펴보고 API 사용량을 더욱 자세히 파악할 수 있습니다. Cloud Monitoring은 다양한 측정항목을 지원하므로 필터 및 집계를 조합하여 애플리케이션 성능에 대한 새롭고 유용한 정보를 얻을 수 있습니다. 예를 들어 요청 수 측정항목을 HTTP 응답 코드 클래스에 대한 필터와 결합하면 시간 경과에 따른 오류율을 대시보드에 표시하거나, 혹은 Cloud Pub/Sub API 요청에 대한 95번째 백분위수 지연 시간을 볼 수 있습니다.