trace 찾기 및 보기

Trace 목록 페이지(기본 버전)

Trace 목록 페이지에서는 개별 trace를 찾고 자세히 살펴볼 수 있습니다. 이 페이지에서 trace의 모든 스팬을 보고 조사하고, 요청의 요약 정보를 보고, 각 스팬에 대한 자세한 정보를 볼 수 있습니다. 조사되는 trace를 제한하려면 필터를 추가합니다. 예를 들어 지연 시간이 1초를 초과하는 trace만 표시하도록 필터를 추가할 수 있습니다.

Trace 목록 페이지는 최대 1,000개의 trace를 저장하고 표시합니다.

최근 trace를 보려면 Google Cloud Console에서 Trace를 선택한 다음 Trace 목록을 선택하거나 다음 버튼을 사용합니다.

Trace 목록으로 이동

Trace를 처음 사용하는 경우 trace가 표시되는 데 몇 분 정도 걸릴 수 있습니다. 다음 스크린샷은 Compute Engine 구성의 trace 목록 예를 보여줍니다.

Compute Engine용 Cloud Trace 목록

시간 간격

Trace 목록 페이지에는 기본적으로 이전 시간의 데이터가 표시됩니다. 페이지 위에 있는 버튼을 사용하여 이 간격을 미리 설정된 값으로 변경할 수 있습니다. 사전 설정된 옵션은 다음과 같습니다.

  • 1시간
  • 4시간
  • 12시간
  • 1일
  • 3일
  • 1주
  • 1개월

기본적으로 시간 간격은 1시간으로 설정됩니다.

커스텀 기간을 선택하려면 마우스 포인터를 사용하여 지연 시간 그래프의 섹션을 강조표시합니다. 이 선택은 표시된 trace의 시간 간격 지연 시간 값 범위를 설정합니다. 예를 들어 다음 이미지는 약 90 ms~390 ms 범위의 지연 시간이 있는 19:00~6:10 AM의 시간 간격을 선택합니다.

trace 그래프에서 커스텀 기간 선택

사전 설정된 시간 간격으로 그래프를 복원하려면 확대/축소 취소를 클릭합니다.

필터

필터를 사용하여 개별 trace를 숨기거나 찾을 수 있습니다. 이전 섹션에서는 지연 시간 그래프의 한 섹션을 강조표시하여 trace의 하위 집합을 더 자세히 표시하면서 다른 모든 trace를 숨기는 방법을 설명했습니다. 이 섹션에서는 요청 필터와 필터 메뉴에 대해 설명합니다.

기본적으로 필터는 모든 trace를 포함하도록 설정됩니다.

필터 설명
요청 필터 trace를 표시하기 위해 충족해야 하는 하나 이상의 조건을 지정할 수 있습니다. 필터 구문을 사용하면 일치 항목이 언제 정확한지 또는 언제 프리픽스 테스트인지를 정의할 수 있습니다. 모든 일치 항목은 대소문자를 구분합니다. trace 필터 구문에 대한 자세한 내용은 trace 필터를 참조하세요.

예를 들어 루트 스팬 이름이 Recv인 프로젝트의 모든 trace를 나열하려면 루트 스팬 이름 Recv 또는 Re와 같은 루트 스팬 이름의 프리픽스를 입력합니다.

지연 시간이 1초 이상이고 이름이 /modules.GetNumInstances인 스팬이 trace에 포함되는 200~299 범위에서 /http/status_code 라벨로 주석이 추가된 스팬이 있는 모든 trace를 나열하려면 다음 필터를 사용합니다.

    +span:/modules.GetNumInstances latency:1s /http/status_code:2
이전 예시에서 trace 필터 용어 +span은 스팬 이름의 일치검색을 적용합니다. /modules.GetNumInstances가 스팬 이름의 프리픽스인 모든 trace를 포함하려면 더하기 기호를 생략합니다.

필터 표현식에 공백이 포함되어 있지 않으면 필터에 문자열 구분 기호를 포함할 필요가 없습니다. 예를 들어 Recv"Recv"는 동일합니다.
HTTP 메소드 이 필터에 선택한 값은 /http/method 라벨로 주석이 추가된 trace 루트 스팬에만 적용됩니다. 모든 요청을 포함하거나 HTTP 메서드 유형(GET, DELETE, POST 또는 PUT)으로 필터링할 수 있습니다.
HTTP 상태 이 필터에 선택한 값은 /http/status_code 라벨로 주석이 추가된 trace 루트 스팬에만 적용됩니다. 301과 같은 개별 상태 값 또는 3xx과(와) 같은 상태 값 범위를 선택할 수 있습니다.
서비스 (App Engine만 해당) 서비스별로 trace를 선택할 수 있습니다. 서비스에 대해 선택한 값은 trace의 모든 스팬에 대해 테스트됩니다. 스팬이 서비스와 일치하면 trace가 표시됩니다.
버전 (App Engine만 해당) 애플리케이션 버전별로 trace를 선택할 수 있습니다. 버전에 대해 선택한 값은 trace의 모든 스팬에 대해 테스트됩니다. 스팬이 값과 일치하면 trace가 표시됩니다.

지연 시간 그래프

지연 시간 그래프의 각 점은 특정 요청에 해당합니다. 요청의 (x,y) 좌표는 요청의 시간과 지연 시간에 해당합니다.

점 위에 마우스 포인터를 가져가면 날짜, 시간, 지연 시간이 포함된 대화상자가 나타납니다.

    5/15/2019, 9:25:02 AM - 69 ms

점을 클릭하면 다음과 같은 변경사항이 발생합니다.

  • 선택한 요청이 강조표시되도록 표가 업데이트됩니다.
  • 해당 요청에 대한 서비스 간 지연 시간 정보의 타임라인을 표시하는 창이 열립니다.
  • 요청에 대한 정보가 있는 요약 표와 루트 스팬에 대한 정보가 있는 세부정보 표가 포함된 창이 표시됩니다.

타임라인에서 스팬을 클릭하면 세부정보 창에 해당 스팬에 대한 추가 정보가 표시됩니다. 이 창에서 로그 항목을 열고 볼 수 있습니다(가능한 경우). 자세한 내용은 trace 세부정보 보기를 참조하세요.

최근 요청 표

기본적으로 최근 요청 표에는 최근 5개의 요청이 표시되며, 1,000개의 trace가 저장됩니다.

속성 설명
지연 시간 애플리케이션이 요청을 처리하는 엔드 투 엔드 시간입니다.
HTTP 메소드 해당하는 경우 HTTP 메서드의 유형입니다. HTTP가 아닌 요청의 경우 이 필드는 비어 있습니다.
URI 요청의 상대 URI입니다.
분석 보고서
연관된 분석 보고서가 있는 경우 해당 보고서의 링크입니다.
시간 요청이 시작된 시간입니다.

다음 방법 중 하나를 사용하여 표에 표시된 요청을 변경할 수 있습니다.

  • 기간 선택
  • 이전 다음 버튼을 사용하여 앞뒤로 탐색
  • 열 헤더를 클릭하여 행 순서 변경
  • 지연 시간 그래프에서 점 클릭

다음 단계

Trace 목록 페이지에서는 개별 trace를 찾고 자세히 살펴볼 수 있습니다. 이 페이지에서 trace의 모든 스팬을 보고 조사하고, 요청의 요약 정보를 보고, 각 스팬에 대한 자세한 정보를 볼 수 있습니다. 조사되는 trace를 제한하려면 필터를 추가합니다. 예를 들어 지연 시간이 1초를 초과하는 trace만 표시하도록 필터를 추가할 수 있습니다.

Trace 목록 페이지는 최대 1,000개의 trace를 저장하고 표시합니다.

최근 trace를 보려면 Google Cloud Console에서 Trace를 선택한 다음 Trace 목록을 선택하거나 다음 버튼을 사용합니다.

Trace 목록으로 이동

Trace를 처음 사용하는 경우 trace가 표시되는 데 몇 분 정도 걸릴 수 있습니다. 다음 스크린샷은 Compute Engine 구성의 trace 목록 예를 보여줍니다.

Compute Engine용 Cloud Trace 목록

시간 간격

Trace 목록 페이지에는 기본적으로 이전 시간의 데이터가 표시됩니다. 페이지 위에 있는 버튼을 사용하여 이 간격을 미리 설정된 값으로 변경할 수 있습니다. 사전 설정된 옵션은 다음과 같습니다.

  • 1시간
  • 6시간
  • 12시간
  • 1일
  • 2일
  • 4일
  • 7일
  • 14일
  • 30일

커스텀 시간 간격을 보려면 다음 단계를 따르세요.

  1. 원하는 커스텀 시간 간격보다 긴 사전 설정 옵션을 선택합니다.
  2. 시간 간격의 한쪽 끝에 있는 trace 선택 그래프에 마우스 포인터를 놓고 간격의 다른 쪽 끝으로 마우스 포인터를 가로로 드래그합니다.
  3. (선택사항) 지연 시간 값의 커스텀 범위를 보려면 원하는 범위의 한쪽 끝에 마우스 포인터를 놓고 다른 쪽 끝으로 마우스 포인터를 수직으로 드래그합니다.

원하는 시간 간격 및 지연 시간 범위를 선택할 때까지 이 작업을 반복할 수 있습니다.

사전 설정된 시간 간격으로 그래프를 복원하려면 재설정을 클릭합니다.

필터

필터를 사용하여 개별 trace를 숨기거나 찾을 수 있습니다. 각 필터는 VALUE와 쌍을 이루는 사전 정의된 OPTION으로 지정됩니다. 일반적으로 사용되는 구문은 다음과 같습니다.

[OPTION] : [VALUE]

예를 들어 다음 스크린샷은 단일 필터를 보여줍니다. 필터 옵션은 RootSpan이고 필터 값은 Recv.입니다. 이 필터를 사용하면 Recv.라는 프리픽스가 붙은 루트 스팬의 trace만 표시됩니다.

필터 표시하기

Recv.와 일치검색되는 trace를 표시하려면 필터 값으로 +Recv.를 사용합니다. 더하기 기호 +를 사용하는 것은 정확한 일치를 원한다는 뜻입니다. 필터링 옵션에 대한 자세한 내용은 Trace 필터를 참조하세요.

여러 필터를 추가하면 모든 필터를 충족하는 trace만 표시됩니다.

필터를 추가하려면 다음 단계를 따르세요.

  1. trace 필터 추가 를 클릭하여 필터 옵션 메뉴가 표시되면 OPTION를 선택합니다. 다음과 같은 옵션이 항상 있습니다.

    • RootSpan(루트 스팬): 루트 스팬 이름과 일치합니다.
    • SpanName(스팬 이름): 스팬 이름과 일치합니다.
    • Method(메서드): 루트 스팬에 /http/method 라벨로 주석이 추가된 trace를 표시합니다. 여기서 라벨 값은 VALUE와 일치합니다.
    • Status(상태): 루트 스팬에 /http/status_code 라벨로 주석이 추가된 trace를 표시합니다. 여기서 라벨 값은 VALUE와 일치합니다. 이 경우 VALUE에는 301과 같은 특정 상태 코드 또는 3xx과(와) 같은 상태 값 범위가 포함될 수 있습니다.
    • MinLatency(최소 지연 시간): 지연 시간이 최소 VALUE 밀리초 이상인 trace를 표시합니다.
    • HasLabel(라벨 있음): VALUE로 지정된 라벨이 하나 이상의 스팬에 표시되는 trace를 표시합니다.
    • Service(서비스): (App Engine만 해당) 서비스 이름이 VALUE와 일치하는 스팬을 하나 이상 포함하는 trace를 표시합니다.
    • Version(버전): (App Engine만 해당) 애플리케이션 버전이 VALUE와 일치하는 스팬을 하나 이상 포함하는 trace를 표시합니다.

    URLLABEL: Client(라벨: 클라이언트)와 같은 다른 옵션이 표시될 수 있습니다.

  2. (선택사항) 일치검색을 원하면 더하기 기호 +를 입력합니다. 기본적으로 일치는 VALUE로 프리픽스 테스트를 수행하여 결정됩니다. 필터링 옵션에 대한 자세한 내용은 Trace 필터를 참조하세요.

  3. 다음 중 하나를 수행하여 필터 VALUE를 지정합니다.

    • VALUE 메뉴에서 선택합니다. 값 메뉴 옵션이 완료되지 않을 수 있습니다.
    • 값을 직접 입력한 다음 키보드의 return 키를 누릅니다.

예를 들어 HTTP POST 명령어를 포함하고 지연 시간이 2초 이상인 모든 trace를 표시하려면 값이 2000MinLatency 옵션이 있는 필터를 추가합니다.

지연 시간 그래프

trace 선택으로 라벨이 지정된 그래프에는 선택한 시간 간격의 각 요청에 대한 점이 표시됩니다. 요청의 (x,y) 좌표는 요청의 시간과 지연 시간에 해당합니다.

점 위에 마우스 포인터를 올려 놓으면 날짜, 시간, URI, 지연 시간이 포함된 도움말이 표시됩니다.

지연 시간 정보를 표시하는 trace 도움말 표시

점을 클릭하면 다음과 같은 변경사항이 발생합니다.

  • 그래프가 새로고침되고 선택한 점 주위에 원이 그려져 강조표시됩니다.
  • 선택한 URI가 요청 표에 강조표시됩니다.
  • Trace 목록 페이지에서 새 창 2개가 열릴 수 있습니다. 폭포식 그래프는 URI에 각 스팬을 표시합니다. 세부정보 창에는 URI에 대한 세부정보가 표시되며 가능한 경우 로그 및 분석 보고서의 링크가 포함됩니다. 이 창이 이미 열려있는 경우 점을 클릭하면 이 창에 표시된 데이터가 새로고침됩니다.

최근 요청 표

기본적으로 최근 요청 표에는 최근 5개의 요청이 표시되며, 1,000개의 trace가 저장됩니다.

속성 설명
지연 시간 애플리케이션이 요청을 처리하는 엔드 투 엔드 시간입니다.
HTTP 메소드 해당하는 경우 HTTP 메서드의 유형입니다. HTTP가 아닌 요청의 경우 이 필드는 비어 있습니다.
URI 요청의 상대 URI입니다.
분석 보고서 연관된 분석 보고서가 있는 경우 해당 보고서의 링크입니다.
시간 요청이 시작된 시간입니다.

다음 방법 중 하나를 사용하여 표에 표시된 요청을 변경할 수 있습니다.

  • 기간 선택
  • 이전 다음 버튼을 사용하여 앞뒤로 탐색
  • 열 헤더를 클릭하여 행 순서 변경
  • 지연 시간 그래프에서 점 클릭

다음 단계