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 버전 번호, 메서드 이름 등 로그 소스를 식별할 수 있는 정보가 포함됩니다.

다음 단계