Endpoints 로그

사용자가 API를 요청하면 Extensible Service Proxy(ESP)가 Cloud Logging을 사용하여 요청과 응답에 대한 정보를 로깅합니다. 이 페이지에서는 로깅되는 정보에 대해 설명합니다.

로그 탐색기 페이지에서 Cloud Endpoints 로그를 찾으려면 다음 안내를 따르세요.

1. Google Cloud Console에서 Stackdriver > 로깅 페이지로 이동합니다.

   로그 탐색기 페이지로 이동

2. 생성된 API, SERVICE_NAME을 선택합니다. 여기에서 SERVICE_NAME은 Endpoints 서비스의 이름입니다.

3. 살펴볼 로그를 클릭합니다. 로그에는 다음과 같은 구조화된 JSON 메시지가 포함됩니다.

   {
     insertId: "…"
     jsonPayload: {…}
     resource: {
       type: "api"
       labels: {…}
     }
     timestamp: "2017-05-08T15:00:02.804424422Z"
     severity: "INFO"
     logName: "…"
   }
   

jsonPayload 객체는 ESP가 보고하는 모든 정보를 포함합니다. 다음 표에서는 이 객체의 필드를 보여줍니다.

필드	설명
url	요청의 URL 경로
producer_project_id	API를 소유하는 Google Cloud 프로젝트 ID
api_name	호출된 API의 이름
api_version	호출되고 이름이 지정된 API의 버전
api_method	호출되고 이름이 지정된 API의 메서드
api_key	호출하는 소비자가 사용한 API 키(있는 경우)
http_method	요청의 HTTP 메서드(예: GET, POST)
request_size_in_bytes	요청 본문의 크기(바이트 단위)
http_response_code	응답의 HTTP 상태 코드(예: 200, 404, 500)
response_size_in_bytes	응답 본문의 크기(바이트 단위)
request_latency_in_ms	ESP 및 백엔드에서 소비한 시간을 포함하여 요청에 응답하는 데 소요된 시간(밀리초 단위). 스트리밍 메서드에는 제공되지 않습니다.
timestamp	요청이 들어온 시점의 타임스탬프
location	요청을 처리한 Google Cloud 영역
log_message	거부된 경우 호출된 메서드 및 상태에 대한 짧은 메시지. 호출이 거부된 경우 API 정보 필드가 로깅되지 않습니다.
error_cause	응답이 오류인 경우 오류 메시지
labels	labels 섹션에는 Google Cloud 프로젝트 ID, Endpoints 서비스 이름, API 버전 번호, 메서드 이름 등 로그 소스를 식별할 수 있는 정보가 포함됩니다.

다음 단계

• API 모니터링