API 사용량 문제 해결

이 페이지에서는 애플리케이션 개발자에게 Google API 및 Google Cloud APIs 사용량 문제를 해결하는 방법에 대한 개요를 제공합니다.

배경

Google API는 Google 서비스에서 제공하는 네트워크 API입니다. 애플리케이션은 다양한 환경에서 JSON HTTP 및 gRPC를 통해 Google API에 액세스할 수 있습니다. 개발자는 애플리케이션에서 Google 제공 클라이언트 라이브러리를 사용하는 것이 좋습니다. 이러한 라이브러리는 페이지로 나누기와 같은 일반적인 상용구 로직을 구현하여 개발 오버헤드와 일반적인 실수를 크게 줄입니다.

자세한 내용은 클라이언트 라이브러리 설명을 참조하세요.

시작하기

Google API를 처음 사용하는 경우 시작하기 페이지를 따라 애플리케이션의 준비 단계를 완료하세요. 먼저 curl -v 명령어를 사용하여 사용하려는 Google API에 테스트 요청을 보내야 합니다. 코드를 작성하지 않고도 Google API를 실험할 수 있습니다. 실제 애플리케이션 개발을 시작하기 전에 문제를 해결할 수 있는 경우가 많습니다.

자세한 내용은 시작하기를 참조하세요.

측정항목을 사용한 문제 해결

Google API는 요청 수, 오류, 지연 시간, 요청, 응답 크기 등 API 사용량의 일반적인 측면을 포함하는 무료 API 측정항목을 제공합니다. 애플리케이션 및 위치 측면에서 세부적인 측정기준을 제공합니다. 개발자는 비정상적인 API 사용량을 찾고 잠재적인 근본 원인을 식별할 수 있습니다. 예를 들어 오류 코드가 400보다 높은 경우 최근에 업데이트된 애플리케이션에 논리적 버그가 있거나 요청 및 응답 크기가 더 클 경우 추가 시스템 로드가 발생할 수 있음을 의미합니다.

자세한 내용은 Monitoring API 사용량을 참조하세요.

로그를 사용하여 문제 해결

보안 및 개인 정보 보호를 위해 Google API는 일반적으로 애플리케이션 개발자에게 API 로그를 제공하지 않습니다. 애플리케이션 개발자는 클라이언트 측에서 API 오류를 로깅하는 것이 좋습니다. 로컬 스토리지 또는 Cloud Logging API에 오류를 로깅할 수 있습니다.

로그에는 일반적으로 오류 메시지 및 오류 세부정보와 같은 측정항목보다 오류에 대한 정보가 더 많이 포함됩니다. API 오류 문제를 해결하는 데 매우 유용하며 종종 필요합니다. 개발자는 API 사용량과 관련된 문제를 발견하면 로그를 쿼리하여 오류 메시지와 오류 세부정보를 찾고 이 정보를 사용하여 오류를 해결하거나 지원팀에 문의할 수 있습니다.

Cloud 감사 로그

보안에 민감한 활동을 위해 Google Cloud 제품은 활동에 대한 자세한 정보가 포함된 감사 로그를 생성할 수 있습니다. Google Cloud API 사용량 문제를 해결하는 데 유용한 정보를 제공합니다. 예를 들어 VPC 서비스 제어 테스트 실행 기능을 사용하여 관리자가 예정된 정책 변경사항을 평가할 수 있도록 감사 로그를 생성합니다.

자세한 내용은 Cloud 감사 로그를 참조하세요.

오류 해결

Google API 사용량에 문제가 있고 해당 측정항목과 로그를 발견한 경우 API 설계 가이드 오류 페이지에 따라 오류를 해결할 수 있습니다.

일반적으로 각 API 오류에는 오류 코드, 오류 메시지, 오류 세부정보라는 세 가지 정보가 있습니다.

  • 오류 코드를 사용하면 애플리케이션이 401403 같은 상위 수준에서 오류를 처리할 수 있습니다.
  • 이 오류 메시지를 통해 애플리케이션 개발자가 오류를 이해하고 애플리케이션 로직을 수동으로 수정할 수 있습니다. 경고: 오류 메시지에 대해 코딩하지 마세요. 사전 통지 없이 변경될 수 있습니다.
  • 오류 세부정보에는 애플리케이션이 프로그래매틱 방식으로 오류를 처리하는 데 사용할 수 있는 추가 정보가 포함되어 있습니다.

자세한 내용은 오류 페이지를 참조하세요.