보고서 작성 및 조회

Cloud Trace의 분석 보고서에는 애플리케이션에 대한 모든 요청 또는 요청 하위 집합의 지연 시간이 전반적으로 표시됩니다.

일일 보고서

Trace는 상위 3개 엔드포인트에 대한 전날의 성능을 1주일 전의 같은 날과 비교하는 일일 보고서를 자동으로 생성합니다.

일일 분석 보고서 보기에 대한 자세한 내용은 보고서 보기를 참조하세요.

커스텀 분석 보고서

일일 분석 보고서는 자동으로 생성되며 보고서의 콘텐츠는 선택할 수 없습니다. 그러나 커스텀 분석 보고서를 만들고 보고서에 포함할 trace를 선택할 수 있습니다.

커스텀 보고서에는 다음이 포함됩니다.

  • 지연 시간 데이터의 히스토그램
  • 샘플 trace의 링크와 함께 백분위수별 지연 시간을 나열하는 표
  • (선택사항) 비교에 사용하는 다른 기간의 지연 시간 데이터
  • 지연 시간에 중요한 영향을 미치는 RPC 호출을 나열하는 병목 현상 창

보고서 매개변수를 직접 입력하여 새 보고서를 만들거나 기존 보고서를 복제하고 매개변수를 수정할 수 있습니다. 두 가지 방법 모두 다음 섹션에 설명되어 있습니다.

새 보고서 작성

새 분석 보고서를 만들려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔 검색창에 분석 보고서를 입력합니다. 검색 결과에서 제품 및 페이지 섹션으로 이동한 후 Trace에 대해 분석 보고서 페이지를 선택합니다.

    분석 보고서로 이동

  2. 새 보고서를 클릭합니다.

  3. 표시되는 양식에 다음 매개변수를 입력하거나 선택합니다.

    • Request filter: 전체 URI, URI 프리픽스 또는 trace 필터 조건입니다.

      예를 들어 프로젝트 루트 스팬이 Recv인 경우 모든 요청을 포함하려면 루트 스팬 이름, Recv 또는 루트 스팬 이름의 프리픽스를 입력합니다. Recv/cart라는 프리픽스가 붙은 URI가 있는 trace로 보고서를 제한하려면 필터에 해당 프리픽스를 입력합니다.

      스팬 속성을 사용하여 trace를 필터링할 수도 있습니다. 예를 들어 /http/status_code:5를 추가할 경우 보고서에 속성 키가 /http/status_code이고 속성 값에 5라는 프리픽스가 붙은 스팬이 있는 trace만 포함됩니다.
    • HTTP method: 요청의 HTTP 메서드입니다. 기본값은 전체입니다.
    • HTTP Status: 요청에서 반환된 HTTP 상태입니다. 기본값은 전체입니다.
    • Report Name: 사람이 읽을 수 있는 보고서 이름입니다. 이 선택적 필드에 이름이 지정되지 않으면 Trace는 지정된 요청 필터와 보고서가 생성된 시간을 기반으로 이름을 만듭니다.
    • Module: 요청을 처리한 App Engine 모듈(자바, Python, Go, PHP)입니다. 기본값은 전체입니다.
    • Version: 요청을 처리한 App Engine 애플리케이션 버전이며 기본값은 전체입니다.
    • Time Range: 요청이 발생한 기간입니다. 지난 1시간, 지난 24시간, 지난주 또는 커스텀 범위를 선택할 수 있습니다. 커스텀을 선택하면 범위의 시작 및 종료 시간을 지정해야 하며, 기본값은 커스텀입니다.
  4. (선택사항) 두 지연 시간 데이터 세트를 비교하려면 기준과 비교를 선택하고 비교 데이터의 기간을 입력합니다.

  5. 제출을 클릭합니다.

보고서 복제

Trace에서 기존 보고서의 필터 매개변수를 복제할 수 있습니다.

  1. Google Cloud 콘솔 검색창에 분석 보고서를 입력합니다. 검색 결과에서 제품 및 페이지 섹션으로 이동한 후 Trace에 대해 분석 보고서 페이지를 선택합니다.

    분석 보고서로 이동

  2. 구조를 복제하려는 보고서의 이름을 클릭합니다.

  3. 유사한 보고서 만들기를 클릭합니다.

  4. 새 보고서 요청 페이지에서 보고서 이름을 포함하여 하나 이상의 보고서 매개변수를 수정합니다.

  5. 제출을 클릭합니다.

보고서 보기

분석 보고서를 보려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔 검색창에 분석 보고서를 입력합니다. 검색 결과에서 제품 및 페이지 섹션으로 이동한 후 Trace에 대해 분석 보고서 페이지를 선택합니다.

    분석 보고서로 이동

  2. 보고서를 보려면 보고서 이름을 클릭합니다.

밀도 분포별 보기

기본적으로 밀도 분포 버튼이 사용 설정됩니다. 이 설정에서 x축은 대수 척도에서의 trace 지연 시간이고 y축은 해당 지연 시간이 있는 전체 요청의 비율입니다.

지연 시간이 히스토그램으로 표시된 Cloud Trace 보고서

비교 보고서를 만들 때 Trace는 두 데이터 세트의 데이터를 오버레이하여 비교하고 변경사항을 분석할 수 있도록 합니다.

지연 시간이 히스토그램으로 표시된 Cloud Trace 비교 보고서

비교 보고서에서 보고서의 범례는 주황색 및 파란색 그래프의 기간을 식별합니다. 이는 스크린샷에서 생략되었습니다.

누적 분포별 보기

지연 시간이 x축의 지연 시간 값보다 작거나 같은 전체 요청 수를 보려면 누적 분포를 클릭합니다.

지연 시간이 누적 분포로 표시된 Cloud Trace 보고서

지연 시간 창 이해

지연 시간 창에는 지연 시간 백분위수가 표시되며 대표 샘플 요청의 trace 링크가 포함됩니다. 특정 trace에 대한 세부정보를 보려면 4개의 샘플 trace 중 하나를 선택합니다. 샘플 trace 중 하나를 선택하면 trace 탐색기 페이지가 열리고 해당 trace의 루트 스팬에 대한 세부정보가 표시됩니다. 자세한 내용은 trace 찾기 및 탐색을 참조하세요.

다음 이미지는 분석 보고서의 지연 시간 창을 보여줍니다. 이 경우 A 문자로 표시되는 데이터 세트는 하나뿐입니다.

Cloud Trace 지연 시간 창

비교 보고서를 만들 때 지연 시간 데이터 창에는 두 데이터 세트에 대한 정보가 포함됩니다. 창의 범례는 각 데이터 세트에 속하는 항목을 식별합니다.

병목 현상 창 이해

병목 현상은 특정 trace의 스팬 지연 시간 값이 예상 지연 시간 값 범위를 벗어나는 것을 나타냅니다. Cloud Trace는 trace 하위 집합의 경험적 지연 시간 분포를 컴퓨팅하고 비교하는 통계 기법을 사용하여 지연 시간 값의 예상 범위를 결정합니다.

병목 현상 창에는 요청의 지연 시간에 중요한 영향을 미치는 RPC 호출이 나열됩니다. 이 창에는 RPC 호출이 대표 샘플 요청과 함께 백분위수로 표시됩니다. 샘플 trace 아래의 번호를 클릭하여 특정 trace의 세부정보를 볼 수 있습니다.

다음 이미지는 분석 보고서의 병목 현상 창을 보여줍니다. 이 경우 A 문자로 표시되는 데이터 세트는 하나뿐입니다.

Cloud Trace 요청 병목 현상 창

비교 보고서에서 병목 현상은 두 세트 간에 지연 시간 분포 변화를 유발한 RPC 호출을 강조표시합니다. 이 창의 범례는 각 데이터 세트에 속하는 항목을 식별합니다.

다음 단계