애플리케이션 로그 작성

App Engine에서 실행되는 애플리케이션에 요청이 전송되면 요청과 응답 세부정보가 자동으로 로깅되며, Google Cloud Platform Console의 Stackdriver 로그 뷰어에서 이를 확인할 수 있습니다.

앱의 요청 및 애플리케이션 로그는 Stackdriver Logging 에이전트에서 수집됩니다. 로그 보관 정책과 로그 항목 최대 크기에 대해서는 할당량 정책을 참조하세요. 로그를 더 장기간 동안 저장하려면 Cloud Storage로 로그를 내보냅니다. 또한 추가 처리를 위해 로그를 BigQuery와 게시/구독으로 내보낼 수 있습니다.

사용 가능한 로그 목록에 대해서는 App Engine 가변형 로그를 참조하세요.

애플리케이션 로그 작성

애플리케이션은 요청을 처리할 때 자체 로깅 메시지를 stdoutstderr에 기록할 수 있습니다. 출력에는 stdout을, 오류에는 stderr을 사용하여 애플리케이션 로그를 씁니다. 이러한 파일은 자동으로 수집되며 로그 뷰어에서 확인할 수 있습니다. 로그 뷰어에서 필터링에 사용할 수 있는 로그 수준은 제공되지 않습니다. 그러나 로그 뷰어는 텍스트, 타임스탬프 등의 다른 필터링을 제공합니다. 크기를 제한하기 위해 로그 뷰어에서 가장 최근 항목만 유지됩니다.

Node.js 앱에서 로그 항목을 내보내려는 경우 다음과 같은 로그 수준을 가지는 console.log() 또는 console.error() 함수를 사용할 수 있습니다.

  • console.log()로 내보낸 항목의 로그 수준은 INFO입니다.
  • console.error()로 내보낸 항목의 로그 수준은 ERROR입니다.
  • 내부 시스템 메시지의 로그 수준은 DEBUG입니다.

Node.js 앱의 경우 Bunyan 또는 Winston 플러그인을 사용할 수도 있고, Node.js용 Stackdriver Logging 클라우드 클라이언트 라이브러리를 직접 사용할 수 있습니다. 자세한 내용은 Node.js용 Stackdriver Logging 설정을 참조하세요.

애플리케이션 로그 보기

로그 뷰어를 사용하여 애플리케이션 로그를 볼 수 있습니다.

  1. GCP Console에서 Stackdriver > Logging 페이지로 이동합니다.

    로그 뷰어 페이지로 이동

  2. 페이지 상단에서 기존 GCP 프로젝트를 선택합니다.

  3. 드롭다운 메뉴에서 리소스 유형으로 GAE 애플리케이션을 선택하여 App Engine 로그를 확인합니다.

로그 뷰어의 드롭다운 메뉴 및 기타 구성요소를 사용하여 로그에서 관련 항목을 필터링하거나 검색할 수 있습니다. 자세한 내용은 로그 뷰어 필터 인터페이스를 참조하세요.

애플리케이션 로그 필터링

로그 뷰어에서 라벨 또는 텍스트 검색으로 로그 항목을 필터링하는 방법은 기본 로그 필터를 참조하세요.

고급 로그 필터를 작성하여 로그 항목 집합을 더 지정하려면 고급 로그 필터를 참조하세요.

특정 인스턴스, 서비스 또는 버전에 대한 로그를 보려면 로그 뷰어에서 해당 자원의 ID로 필터링하세요. 서비스 및 버전 ID를 찾으려면 App Engine 대시보드를 보세요.

로그 뷰어에서 trace가 동일하여 상관관계가 있는 여러 로그 항목을 '상위-하위' 형식으로 조회할 수 있습니다.

로그 항목에 상관관계를 지정하는 방법은 GitHub 문서를 참조하세요.

로그 항목에 상관관계를 지정한 후 상관관계가 있는 로그 항목을 조회하는 방법은 다음과 같습니다.

  1. 로그 뷰어에서 App Engine 로그를 엽니다. 자세한 내용은 애플리케이션 로그 보기를 참조하세요.

  2. 로그 항목 왼쪽의 작은 검정색 삼각형을 클릭하여 request 로그를 확장합니다. request 및 앱 로그가 중첩된 형식으로 표시됩니다.

추가 사항:

  • '하위' 로그 항목에서 가장 높은 severity가 최상위 항목에 자동으로 적용되지는 않습니다. 이러한 동작이 필요하다면 최상위 항목에 가장 높은 severity를 수동으로 설정하세요.
  • 최상위 로그의 httpRequest.requestUrl 필드를 설정합니다.

API를 통해 로그 읽기

가변형 환경에서 생성된 App Engine 로그를 읽기 위한 API는 없습니다.

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

Node.js 문서용 App Engine 가변형 환경