개요

이번 실습에서는 애플리케이션을 Google Cloud로 배포하고 Google Cloud에서 제공하는 도구를 사용하여 애플리케이션을 모니터링합니다. 또한 Cloud Logging, Trace, Profiler 및 대시보드를 사용하고 업타임 체크와 알림 정책을 만들어 보겠습니다.

목표

이 실습에서는 다음 작업을 실행하는 방법을 알아봅니다.

• GitHub에서 샘플 앱 다운로드
• App Engine에 애플리케이션 배포
• Cloud 로그 확인
• Profiler 정보 보기
• Cloud 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에서 샘플 앱 다운로드

GitHub에서 샘플 애플리케이션을 다운로드하고 Cloud Shell에서 미리보기를 합니다.

1. Cloud 콘솔에서 Cloud Shell 활성화()를 클릭합니다.

2. 메시지가 표시되면 계속을 클릭합니다. Cloud Shell에 연결되면 인증이 완료되었고 프로젝트가 해당 프로젝트 ID로 이미 설정된 것을 볼 수 있습니다.

3. Cloud Shell에서 다음 명령어를 실행하여 인증되었는지 확인합니다. 메시지가 표시되면 승인을 클릭합니다.

gcloud auth list

명령어 출력:

Credentialed Accounts ACTIVE ACCOUNT * [my_account]@[my_domain.com] To set the active account, run: $ gcloud config set account `ACCOUNT` 참고: gcloud 명령줄 도구는 Google Cloud의 강력한 통합 명령줄 도구입니다. 이 도구는 Cloud Shell에 사전 설치되어 있습니다. 여러 기능 중에서도 gcloud는 셸에서의 명령줄 자동 완성 기능을 지원합니다. 자세한 내용은 gcloud 명령줄 도구 개요를 참조하세요.

4. 다음 명령어를 실행하여 실습을 위한 올바른 프로젝트를 사용 중인지 확인하세요.

gcloud config list project

명령어 출력

[core] project = [PROJECT_ID]

5. 올바른 프로젝트가 표시되지 않으면 다음 명령어로 설정할 수 있습니다.

gcloud config set project [PROJECT_ID]

명령어 출력:

Updated property [core/project].

6. 다음 명령어를 실행하여 gcp-logging이라는 폴더를 생성합니다.

mkdir gcp-logging

7. 방금 만든 폴더로 변경합니다.

cd gcp-logging

8. Cloud Storage에서 간단한 Python Flask 앱을 다운로드합니다.

gcloud storage cp gs://cloud-training/CBL175/design-process.zip .

9. design-process.zip 폴더의 압축을 풉니다.

unzip design-process.zip

10. deploying-apps-to-gcp 폴더로 변경합니다.

cd design-process/deploying-apps-to-gcp

11. Cloud Shell에서 편집기 열기()를 클릭합니다.

12. 탐색창에서 gcp-logging/design-process/deploying-apps-to-gcp 폴더를 펼치고 main.py를 클릭하여 파일을 엽니다.

13. 파일의 상단(2번 행)에 다음 import 문을 추가합니다.

import googlecloudprofiler 참고: Profiler를 사용하면 애플리케이션이 사용하는 리소스를 모니터링할 수 있습니다. 자세한 내용은 Google Cloud Profiler 문서를 참조하세요.

14. main() 함수 뒤에 다음 코드 스니펫을 추가하여 Profiler를 시작합니다(11번 행 다음).

try: googlecloudprofiler.start(verbose=3) except (ValueError, NotImplementedError) as exc: print(exc)

Profiler에서 계속 애플리케이션 측정항목을 보고합니다. 코드는 다음과 같이 표시됩니다.

참고: 이 코드는 단순히 Profiler를 사용 설정합니다. 설정한 후에는 Profiler에서 Google Cloud에 애플리케이션 측정항목 보고를 시작합니다.

15. requirements.txt 파일에 Profiler 라이브러리도 추가해야 합니다. 코드 편집기에서 파일을 열고 다음을 추가합니다.

google-cloud-profiler==4.1.0 protobuf==3.20.1

파일은 다음과 같이 표시됩니다.

16. Profiler를 프로젝트에서 사용 설정해야 합니다. Cloud Shell에서 다음 명령어를 입력합니다.

gcloud services enable cloudprofiler.googleapis.com

17. 프로그램을 테스트하려면 다음 명령어를 입력하여 이미지의 Docker 컨테이너를 빌드합니다.

docker build -t test-python .

18. Docker 이미지를 실행하려면 다음 명령어를 입력합니다.

docker run --rm -p 8080:8080 test-python

19. 프로그램이 실행 중인지 확인하려면 Google Cloud Shell 툴바에서 웹 미리보기()를 클릭합니다. 그런 다음 포트 8080에서 미리보기를 선택합니다.

새 브라우저 탭에 프로그램이 표시됩니다.

20. Cloud Shell에서 Ctrl+C를 입력하여 프로그램을 중지합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. Profiler 사용 설정

작업 2. App Engine에 애플리케이션을 배포하고 Cloud 로그 확인

이제 프로그램을 App Engine에 배포하고 Google Cloud 도구를 사용하여 모니터링합니다.

1. Cloud Shell 코드 편집기의 탐색기 창에서 gcp-logging/design-process/deploying-apps-to-gcp 폴더를 선택합니다.
2. 새 파일을 클릭한 후 파일 이름을 app.yaml로 지정합니다.
3. 다음 내용을 방금 만든 파일에 붙여넣습니다.

runtime: python311

4. 변경사항을 저장합니다.

5. 프로젝트에 App Engine 애플리케이션을 만들어야 합니다. gcloud app create 명령어를 사용해 앱을 만들고자 하는 리전을 지정하기만 하면 됩니다. Cloud Shell에서 다음 명령어를 입력합니다.

   gcloud app create --region={{{project_0.startup_script.app_region | REGION }}}

6. 이제 다음 명령어를 사용하여 앱을 배포합니다.

gcloud app deploy --version=one --quiet 참고: 이 명령어는 완료하는 데 몇 분 정도 걸립니다. 완료될 때까지 기다렸다가 계속하세요.

7. Google Cloud 콘솔 제목 표시줄의 검색창에 App Engine을 입력한 다음, 검색 결과에서 App Engine을 클릭합니다.

8. App Engine > 대시보드를 클릭합니다. 대시보드의 오른쪽 상단에 다음과 비슷한 애플리케이션 링크가 표시됩니다.

참고: 기본적으로 App Engine 인스턴스의 URL은 https://project-id/appspot.com 형식입니다.

9. 링크를 클릭하여 프로그램을 테스트합니다.

10. 브라우저를 몇 번 새로고침하여 요청을 여러 개 만듭니다.

11. 콘솔로 돌아가서 App Engine > 버전을 클릭합니다.

12. 표의 진단 열에서 로그를 클릭합니다.

13. 로그에서 Profiler가 시작되어 프로필이 생성되고 있음을 나타냅니다. 너무 빨리 로그 확인 단계에 도달한 경우 1분 정도 기다린 후 새로고침을 클릭합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. App Engine에 애플리케이션을 배포하고 Cloud 로그 확인

작업 3. Profiler 정보 보기

1. Google Cloud 콘솔 제목 표시줄의 검색창에 Profiler를 입력한 다음, 검색 결과에서 Profiler를 클릭합니다. 화면에 다음과 같이 출력됩니다.

참고: 프로그램에서 사용한 전체 CPU 시간이 상단의 회색 막대에 표시됩니다. 아래에 있는 막대에는 전체 CPU 시간 대비 프로그램 함수에서 사용한 CPU 시간이 표시됩니다. 현재로서는 트래픽이 없으므로 차트가 별로 흥미롭지 않습니다. 애플리케이션에 부하를 발생시켜 보세요.

2. 탐색 메뉴에서 Compute Engine을 클릭합니다.
3. 인스턴스 만들기를 클릭하여 가상 머신을 만듭니다.
4. 리전을 (으)로 선택합니다.

App Engine 앱의 리전과 다르기 때문에 이렇게 선택합니다.

나머지 기본값을 모두 허용하고 만들기를 클릭합니다.

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

5. VM을 사용할 준비가 되면 SSH를 클릭하여 로그인합니다.

6. 메시지가 표시되면 '브라우저에서 SSH를 통해 연결'이 VM에 연결하도록 허용하고 승인을 클릭합니다.

7. Apache Bench라는 웹 테스트 도구를 사용하여 App Engine 앱에 트래픽을 생성합니다. 다음 명령어를 입력하여 Apache Bench를 설치합니다.

sudo apt update sudo apt install apache2-utils -y

8. 연결 세부정보 패널에서 <your-project-id>를 자신의 PROJECT_ID로 바꾸고 다음 명령어를 입력하여 App Engine 애플리케이션에 트래픽을 생성합니다.

ab -k -n 1000 -c 10 https://<your-project-id>.appspot.com/

이 명령어는 한 번에 10개씩, 총 1,000개의 요청을 애플리케이션에 보냅니다.

참고: 애플리케이션을 가리키도록 URL을 변경해야 합니다. URL은 App Engine 대시보드에서 찾을 수 있습니다. 앱을 테스트하는 데 사용한 브라우저 탭을 아직 닫지 않았다면 브라우저 탭에서도 찾을 수 있습니다. URL 끝에는 슬래시(/)를 꼭 넣어주세요.

9. 요청이 완료되면 Google Cloud 콘솔 제목 표시줄의 검색창에 Profiler를 입력한 다음, 검색 결과에서 Profiler를 클릭합니다.

이제 더 흥미로운 차트가 표시됩니다. 각각의 막대는 함수를 나타냅니다. 막대의 너비는 각 함수에서 소비한 CPU 시간을 나타냅니다.

Profiler를 사용하면 개발자가 프로그램에서 리소스를 너무 많이 사용하는 부분을 추적할 수 있습니다.

작업 4. Cloud Trace 살펴보기

1. 애플리케이션에 전송된 모든 요청은 Trace 목록에 추가됩니다. Google Cloud 콘솔 제목 표시줄의 검색창에 Trace 탐색기를 입력한 다음, 검색 결과에서 Trace 탐색기를 클릭합니다.

이 목록은 요청과 지연 시간 기록을 표시합니다. 다시 말씀드리지만 애플리케이션이 오래 실행되지 않았으므로 그다지 흥미로운 내용은 없습니다. 왼쪽 상단 차트는 요청과 요청에 걸린 시간을 표시합니다. 오른쪽 표는 요청 목록을 보여줍니다. 요청을 선택하면 화면 하단에 더 자세한 정보가 표시됩니다.

2. 이전에 Apache Bench 명령어를 입력했던 SSH 창으로 돌아갑니다.

3. 연결 세부정보 패널에서 <your-project-id>를 자신의 PROJECT_ID로 바꾸고 다음 ab 명령어를 입력합니다.

ab -k -n 1000 -c 10 https://<your-project-id>.appspot.com/

-n과 -c 매개변수에 다른 값을 사용하여 실험할 수도 있습니다.

4. 이 과정을 몇 번 반복한 다음 Trace 탐색기 페이지로 돌아갑니다.

작업 5. 대시보드를 사용하여 리소스 모니터링

1. 탐색 메뉴에서 모니터링을 클릭합니다.

2. 왼쪽 창에서 대시보드를 클릭합니다. Cloud Monitoring은 프로젝트에서 사용되는 리소스를 분석하고 몇 가지 기본 대시보드를 생성합니다. 이 실습에서 App Engine과 Compute Engine 가상 머신을 사용했으므로 아래와 비슷한 표가 표시됩니다.

3. App Engine 대시보드를 클릭한 다음 드롭다운에서 프로젝트 이름을 선택합니다. App Engine 애플리케이션과 관련된 정보가 대시보드에 표시됩니다.

4. 왼쪽 창에서 대시보드를 클릭합니다.

5. VM 인스턴스 대시보드를 클릭한 다음 인스턴스를 선택합니다. VM의 대시보드가 표시됩니다.

참고: VM 인스턴스가 곧바로 표시되지 않으면 1분 정도 기다렸다가 브라우저를 새로고침하세요.

6. 또는 대시보드 페이지로 돌아가 커스텀 대시보드 만들기를 클릭할 수도 있습니다. 커스텀 대시보드를 만들어 보세요.
7. 새 대시보드 이름에 선택한 커스텀 대시보드 이름을 입력합니다. 차트를 추가하여 커스텀 대시보드로 계속 진행할 수 있습니다.

작업 6. 업타임 체크 및 알림 만들기

1. 왼쪽 창에서 업타임 체크를 클릭한 다음 상단에서 + 업타임 체크 만들기 링크를 클릭합니다. 다음과 같이 양식을 작성합니다.

속성	값
프로토콜	HTTPS
리소스 유형	URL
호스트 이름	<your-project-id>.appspot.com
경로	/
업타임 체크 빈도	1분

2. 계속을 클릭합니다.
3. 경고 및 알림에서 알림 채널 옆에 있는 드롭다운 화살표를 클릭한 다음 알림 채널 관리를 클릭합니다. 알림 채널 페이지가 새로운 탭에서 열립니다.
4. 페이지 아래로 스크롤하고 이메일에 대해 새로 추가를 클릭합니다.
5. 이메일 채널 만들기 대화상자에서 이메일 주소 필드에 개인 이메일 주소를 입력하고 표시 이름을 추가합니다.
6. 저장을 클릭합니다.
7. 이전 탭으로 돌아갑니다. 알림 채널을 다시 클릭한 다음 새로고침 아이콘을 클릭하여 이전 단계에서 언급한 표시 이름을 가져옵니다.
8. 이제 표시 이름을 선택하고 확인을 클릭합니다.
9. 알림 정책의 이름을 업타임 체크 알림으로 지정합니다.
10. 계속을 클릭합니다.
11. 검토 섹션의 제목에 App Engine Uptime Check를 입력합니다.
12. 테스트를 클릭하여 업타임 체크에서 리소스에 연결할 수 있는지 확인합니다. 녹색 체크표시가 보이면 모두 연결할 수 있습니다. 만들기를 클릭합니다.

내 진행 상황 확인하기를 클릭하여 목표를 확인합니다. 업타임 체크 및 알림 만들기

13. 애플리케이션을 사용 중지하여 업타임 체크 및 알림 정책이 작동하는지 확인하기 위해 열려 있는 App Engine 탭으로 돌아갑니다.

14. 설정을 클릭합니다.

15. 애플리케이션 사용 중지를 클릭합니다. 안내에 따라 애플리케이션을 사용 중지합니다.

16. App Engine 대시보드로 돌아가서 URL을 테스트합니다. 애플리케이션이 더 이상 작동하지 않습니다.

17. 모니터링이 포함된 탭으로 돌아간 다음 업타임 체크를 클릭합니다. 업타임 체크에 실패합니다. 업타임 체크에 너무 빨리 진입한 경우 1분 정도 기다렸다가 새로고침을 클릭하세요.

18. 알림을 클릭합니다. 사고가 실행된 상태여야 합니다.

19. 이메일을 확인합니다. Cloud Monitoring에서 보낸 메시지가 표시됩니다.

20. App Engine 설정으로 돌아가서 애플리케이션을 다시 사용 설정한 다음 업타임 체크 페이지로 돌아갑니다. 업타임 체크가 다시 작동합니다. 작동하지 않는다면 1분 정도 기다렸다가 새로고침을 클릭합니다.

21. 알림 페이지로 돌아갑니다. 사고가 해결된 상태여야 합니다. 전과 마찬가지로 1분 정도 기다렸다가 새로고침을 클릭해야 할 수도 있습니다.

22. 이메일을 다시 확인합니다. 알림이 복구되었다는 두 번째 이메일이 있어야 합니다.

23. 프로젝트를 삭제한 후 이메일이 오지 않도록 하려면 알림 정책을 삭제한 다음 알림 채널도 삭제합니다. 알림 페이지 상단에서 알림 채널 편집을 클릭합니다.

24. 이메일 주소를 찾은 다음 휴지통 아이콘을 클릭하여 삭제합니다.

25. 이제 업타임 체크를 클릭하고 App Engine 업타임 체크를 삭제합니다.

수고하셨습니다

이번 실습에서는 애플리케이션을 Google Cloud에 배포한 다음 Google Cloud에서 제공하는 도구를 사용하여 애플리케이션을 모니터링했습니다. Cloud Logging, Trace, Profiler, 대시보드를 사용하고 업타임 체크와 알림 정책을 만들었습니다.

실습 종료하기

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

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

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

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

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

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

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