로그 항목 상관관계

이 문서에서는 로그 탐색기를 사용하여 로그 항목을 '상위-하위' 형식으로 그룹화하고 보는 방법을 설명합니다. 일반적으로 Cloud Logging에 로그 항목을 작성하면 각 로그 항목이 별도로 관련 없이 표시됩니다. 하지만 LogEntry 객체의 trace 필드를 사용하여 로그 항목을 그룹화하거나 상관관계를 지정할 수 있습니다.

로그 항목의 상관관계를 지정하면 로그 탐색기에서 상위 로그 항목을 여러 하위 로그 항목과 함께 볼 수 있습니다.

상관관계가 지정된 로그 항목 설정

상관관계가 지정된 로그 항목을 설정하려면 trace 필드를 수동으로 입력하거나 Google 클라이언트 라이브러리를 사용하여 Cloud Trace에 trace를 제출하도록 애플리케이션을 계측하면 됩니다. 다음 구성에서 trace 데이터를 자동으로 캡처합니다.

  • App Engine 표준 환경

  • Cloud Run Functions 및 Cloud Run

trace 데이터를 수집하도록 애플리케이션을 계측하는 방법은 Cloud Trace 계측 개요를 참조하세요.

로그 탐색기가 로그 항목 컬렉션의 상관관계를 지정하려면 로그 항목이 다음 요구사항을 충족해야 합니다.

  • LogEntry 객체의 trace 필드는 다음 형식의 문자열로 설정됩니다.

       projects/PROJECT_ID/traces/TRACE_ID

    여기서 PROJECT_ID는 Google Cloud 프로젝트의 프로젝트 ID이고 TRACE_ID는 trace 식별자입니다.

  • 로그 항목의 trace 필드는 동일합니다.

  • 각 로그 항목은 고유한 로그에 속합니다. 즉, logName 필드 값이 달라야 합니다.

로그 탐색기에서 상관관계가 지정된 로그 항목 보기

로그 탐색기에서 보고 있는 상위 로그 항목과 상관관계가 지정된 하위 로그 항목을 보려면 로그 항목을 펼칩니다.

예를 들어 App Engine 요청 로그 항목과 애플리케이션 로그 항목을 표시하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.

    로그 탐색기로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Logging인 결과를 선택합니다.

  2. 리소스 드롭다운 메뉴에서 GAE 애플리케이션을 선택합니다.

  3. 로그 이름 드롭다운 메뉴에서 request_log를 선택합니다.

  4. 쿼리 결과 창에서 로그 항목을 펼치려면 펼치기를 클릭합니다.

    요청 로그 항목과 상관관계가 지정된 애플리케이션 로그 항목은 요청 로그 항목에 중첩됩니다.

    요청 로그 항목에 중첩된 애플리케이션 로그 항목

    앞선 스크린샷의 상위 로그 항목에 하위 로그 항목 10개가 있습니다. 이러한 하위 로그 항목을 펼쳐 세부정보를 볼 수 있습니다.

상관관계가 지정된 로그 항목 검색

상관관계가 지정된 검색을 사용하면 쿼리를 통해 상위 로그 항목과 하위 로그 항목을 모두 검색할 수 있습니다. 검색 결과는 상위 로그 항목이나 하위 로그 항목의 쿼리와 일치하는 상위 로그 항목 목록입니다. 예를 들어 하위 로그 항목과 상위 로그 항목 모두에서 'app log message' 문자열을 검색하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.

    로그 탐색기로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Logging인 결과를 선택합니다.

  2. 검색 필드에 "app log message'를 입력하고 쿼리 실행을 클릭합니다. 'app log message'가 포함된 하위 로그 항목이 쿼리 결과 창에 나열됩니다.

  3. 쿼리 결과 창에서 상관관계 기준을 클릭하고 상위 로그를 선택합니다. App Engine 요청 로그를 보려면 request_log를 선택하고 적용을 클릭합니다.

  4. 쿼리 결과 창에 문자열 "app log message"가 포함되거나 이 문자열이 포함된 하위 항목이 있는 모든 상위 로그 항목이 나열됩니다.

    중첩된 하위 로그 항목을 보려면 펼치기를 클릭하여 상위 로그 항목을 펼칩니다.

    요청 로그 항목에 중첩된 애플리케이션 로그 항목

    앞선 스크린샷의 상위 로그 항목에는 'app log message' 문자열이 포함된 하위 로그 항목 10개가 있습니다. 이러한 하위 로그 항목을 펼쳐 세부정보를 볼 수 있습니다.

    상위 로그를 선택했지만 쿼리 결과 창에 로그 항목이 표시되지 않으면 쿼리와 일치하는 상위 항목과 하위 항목이 없는 것입니다.

다음 단계