trace 찾기 및 보기

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

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

최근 trace 보기

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

Trace 목록으로 이동

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

Cloud Trace 최근 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입니다.
분석 보고서 연관된 분석 보고서가 있는 경우 해당 보고서의 링크입니다.
시간 요청이 시작된 시간입니다.

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

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

다음 단계