추적 세부정보 보기

trace를 선택하면 Cloud Trace에서 Trace 목록 페이지에 trace 세부정보가 표시됩니다. 세부정보 보기에는 요청에 대한 세부정보 요약, 요청의 루트 스팬과 모든 RPC 호출의 하위 스팬을 표시하는 그래픽 타임라인, 스팬에 대해 수집된 지연 시간 데이터의 상세 보기가 표시됩니다.

추적 세부정보 보기

  1. Google Cloud Console에서 Trace 목록 페이지로 이동합니다.

    Trace 목록으로 이동

  2. trace의 자세한 정보를 표시하는 방법에는 여러 가지가 있습니다.

    • 표에 나열된 URI를 클릭
    • 그래프에서 점을 클릭
    • 선택된 trace 세부정보 보기에서 trace ID를 16진수 형식으로 입력합니다. trace ID를 입력하면 Selected trace may not match current filters 또는 Selected trace is outside the current time range 메시지가 표시될 수 있습니다. 이 정보 메시지는 표시된 trace가 필터 또는 시간 범위 설정과 일치하지 않음을 나타냅니다.

선택한 trace 세부정보 창

검사할 trace를 선택하면 선택한 trace에 대한 세부정보가 표시됩니다.

  • 선택한 trace 세부정보 텍스트 상자에는 해당 trace의 식별자가 표시됩니다.

  • 창은 폭포식 그래프를 사용하여 요청의 지연 시간 데이터를 그래픽으로 표시합니다. 기본적으로 선택된 trace의 루트 스팬이 강조표시됩니다.

  • 창은 일련의 표에 폭포식 그래프의 강조표시된 스팬에 대한 자세한 정보를 표시합니다.

이러한 필드는 검사할 trace를 선택할 때마다 새 데이터로 새로고침됩니다. 다음 스크린샷은 이러한 창을 보여줍니다.

Cloud Trace 세부정보 창

폭포식 그래프

폭포식 그래프의 각 행은 trace의 스팬에 해당합니다.

  • Cloud Trace가 시작 시간이 스팬 상위의 시작 시간보다 앞선 스팬을 감지하면 기호가 표시됩니다. Cloud Trace는 스팬을 표시할 때 이러한 불일치를 자동으로 보상합니다. 하지만 스팬 데이터는 수정되지 않습니다.

    서비스가 여러 시계 소스 또는 다른 언어 라이브러리에 의존하는 경우 타임스탬프 불일치가 발생할 수 있습니다.

  • 스팬에 HTTP 오류가 포함됨을 나타내기 위해 기호가 표시됩니다.

  • service_name.call_name 형식의 RPC 호출 이름입니다. datastore_v3.RunQuery).

    App Engine 표준 환경의 경우 여기에 보고된 내부 이름이 언어별 서비스 API의 이름과 일치하지 않을 수 있습니다.

  • 왕복 RPC 호출을 완료하는 데 걸린 시간으로,

이벤트 표시 체크박스

이벤트 표시를 선택하면 폭포식 그래프가 다시 그려지고 이벤트 주석이 그래프의 행으로 포함됩니다. 주석에 대한 자세한 내용은 스팬 주석 추가를 참조하세요.

클릭하여 복사

복사 를 클릭하여 특정 trace의 세부정보 보기 URL을 클립보드에 복사할 수 있습니다.

스팬 세부정보가 포함된 표

이러한 표에는 현재 폭포식 구조 그래프에 강조표시된 행에 대한 자세한 정보가 포함되어 있습니다. 폭포식 그래프의 각 행은 trace 스팬에 해당합니다.

행을 강조표시하면 해당 스팬의 세부정보에 URI 이름, 상대 시작 시간, RPC 호출 이름이 포함됩니다.

표에 표시된 데이터는 강조표시된 요소에 따라 다릅니다. 그러나 다음 표에 나열된 데이터는 항상 표시됩니다.

속성 설명
상대적 시작 시간 첫 번째 항목은 스팬의 상대적 시작 시간입니다.

루트 스팬의 경우 이 값은 항상 @0 ms입니다.

하위 스팬의 경우 요청 시작을 기준으로 하위 스팬이 시작된 시간입니다. 즉, 이 값은 RPC 호출이 시작되기까지 전체 요청이 시작되는 데 걸리는 시간을 표시합니다.
이름 다음 항목은 RPC 호출의 이름입니다. 이름은 service_name.call_name 형식입니다. 예를 들면 datastore_v3.RunQuery입니다.

App Engine 표준 환경의 경우 여기에 보고된 내부 이름이 언어별 서비스 API의 이름과 일치하지 않을 수 있습니다.

루트 스팬이 강조표시되고 요청이 HTTP 요청이면 요약이라는 제목의 표가 표시됩니다. 표에는 루트 스팬의 행과 각 RPC의 행이 하나씩 있습니다.

요약 표
설명
이름 service_name.call_name 형식의 RPC 호출 이름입니다. 스팬 라벨에 표시됩니다.
RPC 절차가 호출된 횟수입니다.
전체 기간 RPC를 수행하는 데 소요된 총 시간입니다.

세부정보라는 제목의 표에는 스팬에 대한 메타데이터가 나열됩니다. 다음 속성이 항상 표시됩니다.

세부정보 표
속성
설명
타임스탬프 애플리케이션이 들어오는 요청을 받은 시간입니다.
로그 로그 데이터를 사용할 수 있는 경우 로그 항목에 대한 링크입니다. 로그 데이터를 사용할 수 없는 경우 이 행은 생략됩니다.
보고서 이 trace를 포함하는 최근 분석 보고서의 링크입니다. 이 trace가 포함된 보고서가 없으면 이 행은 생략됩니다.
trace ID 이 필드를 보려면 세부정보 메뉴 를 클릭합니다.

trace에 대해 전역적으로 고유한 식별자입니다. 이 식별자는 32바이트 16진수 문자열로 표시된 128비트 숫자 형식입니다. 자세한 내용은 Resource: Trace를 참조하세요.

스팬 ID 이 필드를 보려면 세부정보 메뉴 를 클릭합니다.

스팬의 식별자입니다. 이 식별자는 0이 아닌 64비트 숫자 정수입니다. 자세한 내용은 TraceSpan을 참조하세요.

GKE 컨테이너

이 표가 표시되면 스팬에 GKE 컨테이너의 표준 라벨이 포함됩니다. 표의 각 행은 특정 라벨에 대한 값이며 리소스에 대한 정보를 자세히 볼 때 사용할 수 있는 링크입니다. 모든 라벨에 대한 자세한 내용은 Trace 라벨을 참조하세요.

다음 표에는 라벨과 그 의미가 나와 있습니다.

라벨
Project ID GKE 클러스터를 호스팅하는 Google Cloud 프로젝트입니다. 프로젝트 이름을 클릭하여 Google Cloud Console의 GKE 대시보드로 이동합니다.
Cluster Name GKE 클러스터를 식별합니다. 클러스터 구성 페이지로 이동하려면 이 값을 클릭합니다.
Namespace 네임스페이스를 식별합니다. GKE 워크로드 페이지로 이동하려면 이 값을 클릭합니다.
Pod Name GKE pod를 식별합니다. Pod 세부정보 대시보드로 이동하려면 이 값을 클릭합니다.
Container Name GKE 컨테이너를 식별합니다. 컨테이너의 세부정보 페이지로 이동하려면 이 값을 클릭합니다.
라벨 요청의 라벨 및 값 표입니다. 라벨은 애플리케이션에 따라 다릅니다. 모든 라벨에 대한 자세한 내용은 Trace 라벨을 참조하세요.

다음 표에는 몇 가지 일반적인 라벨과 그 의미가 나와 있습니다.

라벨
http/host 애플리케이션이 실행 중인 호스트 이름으로,
http/response/size HTTP 응답 본문의 바이트 수로,
http/url 요청의 상대 URL입니다.
gae/request_log_id 내부 App Engine 요청 ID입니다.

요청 유형이 HTTP이거나 애플리케이션이 App Engine에서 실행되는 경우 추가 속성이 나열될 수 있습니다. 다음 표는 일반적으로 관측된 속성의 일부 목록을 표시합니다.

속성 설명
trace된 시간 (HTTP 전용) 모든 RPC 호출이 완료되는 데 걸린 집계 시간입니다.
trace하지 않은 시간 (HTTP 전용) RPC 호출이 수행되지 않은 시간입니다. 즉, 애플리케이션에서 로컬로 소비된 시간을 측정합니다. 부하 처리를 위해 생성된 새 인스턴스로 인해 종종 요청 시작 부분이 trace되지 않은 일반적인 시간보다 더 길 수 있습니다.
HTTP 메소드 (HTTP 전용) 요청의 HTTP 메서드입니다.
서비스 (App Engine 전용) 요청을 처리한 App Engine 서비스입니다. 자세한 내용은 App Engine을 참조하세요.
버전 (App Engine 전용) 요청을 처리한 애플리케이션의 버전입니다.

이벤트를 강조표시하면 세부정보 창에 이벤트의 세부정보가 표시됩니다. 기본적으로 이벤트는 폭포식 그래프에 표시되지 않습니다. 이벤트를 폭포식 그래프에 포함하려면 이벤트 표시를 클릭합니다.

통계

통계를 사용할 수 있으면 요청 성능의 통계가 타임라인 아래에 표시됩니다.

자세한 내용은 통계를 참조하세요.

스팬 주석 추가

Cloud Trace API v1 또는 Cloud Trace API v2를 사용하여 trace에 주석을 추가할 수 있습니다. 이 섹션에서는 사용 가능한 다양한 옵션을 설명합니다.

trace를 Cloud Logging LogEntry 객체와 연결하려면 주석을 사용합니다. Cloud Trace와 Cloud Logging의 통합에 대한 자세한 내용은 Cloud Logging과 통합을 참조하세요.

라벨로 주석 추가

Cloud Trace API v1 patchTraces를 사용하는 경우 labels 객체를 만들고 TraceSpan 객체에 연결하여 스팬에 주석을 추가할 수 있습니다.

이러한 주석은 trace의 세부정보를 볼 때 라벨로 표시됩니다. 라벨에 대한 자세한 내용은 trace 라벨을 참조하세요.

속성으로 주석 추가

Cloud Trace API v2 batchWrite를 사용하는 경우 attributes 객체를 만들고 Span 객체에 연결하여 스팬에 주석을 추가할 수 있습니다.

이러한 주석은 trace의 세부정보를 볼 때 라벨로 표시됩니다. 자세한 내용은 이 페이지의 trace 세부정보 보기를 참조하세요.

시간 이벤트로 주석 추가

Cloud Trace API v2 batchWrite를 사용하는 경우 TimeEvents 객체를 만들고 Span 객체에 연결하여 스팬에 주석과 메시지 이벤트를 추가할 수 있습니다.

TimeEvents 객체는 TimeEvent 객체의 배열이며 각 객체에는 메시지 이벤트와 주석이 포함됩니다.

trace의 TimeEvents를 보려면 trace의 폭포식 그래프로 이동하여 이벤트 표시를 클릭합니다. TimeEvent를 선택하면 세부정보가 세부정보 창에 표시됩니다.

다음 단계