개요

이 실습에서는 샘플 애플리케이션에 HTTP 요청을 보내 Cloud Trace를 사용하는 방법을 알아봅니다.

목표

다음을 수행하여 Trace를 사용하는 방법을 알아봅니다.

• 샘플 애플리케이션을 Google Kubernetes Engine(GKE) 클러스터에 배포합니다.
• 샘플 애플리케이션에 HTTP 요청을 보내 trace를 만듭니다.
• Trace 인터페이스를 사용하여, 만든 trace의 지연 시간 정보를 확인합니다.

설정 및 요건

각 실습에서는 정해진 기간 동안 새 Google Cloud 프로젝트와 리소스 집합이 무료로 제공됩니다.

1. 실습 시작 버튼을 클릭합니다. 실습 비용을 결제해야 하는 경우 결제 수단을 선택할 수 있는 팝업이 열립니다. 왼쪽에는 다음과 같은 항목이 포함된 실습 세부정보 패널이 있습니다.

   • Google Cloud 콘솔 열기 버튼
   • 남은 시간
   • 이 실습에 사용해야 하는 임시 사용자 인증 정보
   • 필요한 경우 실습 진행을 위한 기타 정보

2. Google Cloud 콘솔 열기를 클릭합니다(Chrome 브라우저를 실행 중인 경우 마우스 오른쪽 버튼으로 클릭하고 시크릿 창에서 링크 열기를 선택합니다).

   실습에서 리소스가 가동되면 다른 탭이 열리고 로그인 페이지가 표시됩니다.

   팁: 두 개의 탭을 각각 별도의 창으로 나란히 정렬하세요.

   참고: 계정 선택 대화상자가 표시되면 다른 계정 사용을 클릭합니다.

3. 필요한 경우 아래의 사용자 이름을 복사하여 로그인 대화상자에 붙여넣습니다.

   {{{user_0.username | "Username"}}}

   실습 세부정보 패널에서도 사용자 이름을 확인할 수 있습니다.

4. 다음을 클릭합니다.

5. 아래의 비밀번호를 복사하여 시작하기 대화상자에 붙여넣습니다.

   {{{user_0.password | "Password"}}}

   실습 세부정보 패널에서도 비밀번호를 확인할 수 있습니다.

6. 다음을 클릭합니다.

   중요: 실습에서 제공하는 사용자 인증 정보를 사용해야 합니다. Google Cloud 계정 사용자 인증 정보를 사용하지 마세요. 참고: 이 실습에 자신의 Google Cloud 계정을 사용하면 추가 요금이 발생할 수 있습니다.

7. 이후에 표시되는 페이지를 클릭하여 넘깁니다.

   • 이용약관에 동의합니다.
   • 임시 계정이므로 복구 옵션이나 2단계 인증을 추가하지 않습니다.
   • 무료 체험판을 신청하지 않습니다.

잠시 후 Google Cloud 콘솔이 이 탭에서 열립니다.

참고: Google Cloud 제품 및 서비스 목록이 있는 메뉴를 보려면 왼쪽 상단의 탐색 메뉴를 클릭하거나 검색창에 제품 또는 서비스 이름을 입력합니다.

작업 1. 애플리케이션 다운로드 및 배포

이 작업에서는 GitHub에서 샘플 애플리케이션을 다운로드하고, Google Kubernetes Engine API를 사용 설정하고, GKE 클러스터를 만들고, 클러스터 사용자 인증 정보를 업데이트하고, 액세스 권한을 확인하고, 애플리케이션의 세 가지 서비스를 배포합니다.

샘플 애플리케이션을 다운로드하고 배포하려면 다음 단계를 따르세요.

1. Cloud Shell을 열려면 Google Cloud 콘솔 툴바에서 'Cloud Shell 활성화'를 클릭합니다. 메시지가 표시되면 계속을 클릭합니다.

잠시 후 Google Cloud 콘솔에서 Cloud Shell 세션이 열립니다.

2. GitHub에서 소스 코드를 다운로드하려면 다음 명령어를 실행합니다.

git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git

3. 다음 명령어를 사용하여 Google Kubernetes Engine API를 사용 설정합니다. 메시지가 표시되면 승인을 클릭합니다.

gcloud services enable container.googleapis.com

4. 영역에서 cloud-trace-demo라는 GKE 클러스터를 만들려면 Cloud Shell에서 다음 명령어를 실행합니다.

ZONE={{{project_0.default_zone|place_holder_text}}} gcloud container clusters create cloud-trace-demo \ --zone $ZONE

이 명령어는 완료되는 데 몇 분 정도 걸립니다. 성공적으로 완료되면 Google Cloud 프로젝트에 cloud-trace-demo라는 GKE 클러스터가 포함됩니다. Google Cloud 프로젝트에 외부 액세스 권한이 있는 클러스터를 만들 권한이 있어야 합니다.

5. 다음 명령어를 실행하여 GKE 클러스터 사용자 인증 정보를 업데이트합니다.

gcloud container clusters get-credentials cloud-trace-demo --zone $ZONE

6. 다음 명령어를 실행하여 클러스터에 대한 액세스 권한을 확인합니다.

kubectl get nodes

이 명령어의 샘플 출력은 다음과 같습니다.

NAME STATUS ROLES AGE VERSION gke-cloud-trace-demo-default-pool-063c0416-113s Ready 78s v1.22.12-gke.2300 gke-cloud-trace-demo-default-pool-063c0416-1n27 Ready 79s v1.22.12-gke.2300 gke-cloud-trace-demo-default-pool-063c0416-frkd Ready 78s v1.22.12-gke.2300

7. 다음 명령어를 실행하여 샘플 애플리케이션을 배포합니다.

cd python-docs-samples/trace/cloud-trace-demo-app-opentelemetry && ./setup.sh

스크립트 setup.sh는 사전 빌드된 이미지를 사용하여 애플리케이션의 세 가지 서비스를 구성합니다. 워크로드의 이름은 cloud-trace-demo-a, cloud-trace-demo-b, cloud-trace-demo-c입니다. 설정 스크립트는 모든 리소스가 프로비저닝될 때까지 기다리므로 구성이 완료되는 데 몇 분 정도 걸릴 수 있습니다.

이 명령어의 샘플 출력은 다음과 같습니다.

deployment.apps/cloud-trace-demo-a is created service/cloud-trace-demo-a is created deployment.apps/cloud-trace-demo-b is created service/cloud-trace-demo-b is created deployment.apps/cloud-trace-demo-c is created service/cloud-trace-demo-c is created

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 클러스터 만들기 및 샘플 애플리케이션 배포

작업 2. trace 만들기

이 작업에서는 curl 요청을 cloud-trace-demo-a로 전송하여 trace를 생성한 다음 Trace에서 trace 데이터를 확인합니다.

1. curl 요청을 cloud-trace-demo-a로 보내 trace를 만들려면 다음 명령어를 사용합니다.

curl $(kubectl get svc -o=jsonpath='{.items[?(@.metadata.name=="cloud-trace-demo-a")].status.loadBalancer.ingress[0].ip}')

출력은 다음과 같이 표시됩니다.

Hello, I am service A And I am service B Hello, I am service C

Google Cloud 콘솔에서 탐색 메뉴() 모든 제품 보기 → 모니터링 가능성 → Trace → Trace 탐색기로 이동하면 스팬 ID가 표시됩니다. (표시되지 않으면 curl 명령어를 다시 실행하고 새로고침한 다음 스팬 ID가 표시될 때까지 기다립니다.)

curl 명령어를 여러 번 실행하여 여러 trace를 생성할 수 있으며 스팬 ID가 표시되는 데 몇 분 정도 걸릴 수 있습니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. Cloud Trace 만들기

trace 데이터 보기

1. Google Cloud 콘솔의 탐색 메뉴()에서 모든 제품 보기 > 모니터링 가능성 > Trace를 클릭합니다.

Trace는 분석을 위해 분산 trace를 보여줍니다. 시간 경과에 따른 스팬 기간의 히트맵과 함께 서비스 이름, 스팬 이름, 상태, 기간, 종류별로 필터링할 수 있는 개별 스팬의 테이블을 표시합니다. 이 인터페이스를 통해 사용자는 성능 문제를 조사하고 분산 시스템 내에서 요청 흐름을 파악할 수 있습니다.

차트 뷰는 히트맵을 사용하여 시간 경과에 따른 스팬의 기간을 표시합니다. 각 색상 블록은 스팬을 나타내며 색상 강도는 기간을 나타냅니다. 이를 통해 지연 시간의 느린 스팬이나 추세를 빠르게 파악할 수 있습니다.

2. 차트 뷰에서 더 어두운 스팬 블록 중 하나를 클릭합니다.

3. 스팬 테이블에서 스팬 ID를 클릭합니다. 특정 trace의 세부 분석이 표시됩니다. 각 가로 막대는 trace 내 각 스팬의 기간을 나타냅니다. 막대의 길이는 스팬의 지속 시간에 해당합니다.

trace의 이 섹션에서는 시스템을 통과하는 단일 요청의 여정을 개별 작업(스팬)으로 나누어 자세히 보여주고 타이밍과 관계를 표시합니다. 이는 성능 병목 현상을 정확히 파악하고 이벤트 시퀀스를 이해하는 데 도움이 됩니다.

4. 스팬에 대한 세부정보를 보려면 스팬 막대 중 하나를 클릭합니다.

각 스팬의 추가 세부정보가 세부정보 창에 표시됩니다.

수고하셨습니다.

이 실습에서는 다음 작업을 수행했습니다.

• 샘플 애플리케이션을 Google Kubernetes Engine(GKE) 클러스터에 배포했습니다.
• 샘플 애플리케이션에 HTTP 요청을 보내 trace를 만들었습니다.
• Trace 인터페이스를 사용하여, 만든 trace의 지연 시간 정보를 확인했습니다.

잘하셨습니다.

실습 종료하기

실습을 완료하면 실습 종료를 클릭합니다. Google Skills에서 사용된 리소스를 자동으로 삭제하고 계정을 지웁니다.

실습 경험을 평가할 수 있습니다. 해당하는 별표 수를 선택하고 의견을 입력한 후 제출을 클릭합니다.

별점의 의미는 다음과 같습니다.

• 별표 1개 = 매우 불만족
• 별표 2개 = 불만족
• 별표 3개 = 중간
• 별표 4개 = 만족
• 별표 5개 = 매우 만족

의견을 제공하고 싶지 않다면 대화상자를 닫으면 됩니다.

의견이나 제안 또는 수정할 사항이 있다면 지원 탭을 사용하세요.

Copyright 2026 Google LLC All rights reserved. Google 및 Google 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표일 수 있습니다.