Error Reporting을 사용하여 비정상 종료된 앱 오류 확인

Error Reporting을 사용하여 비정상 종료된 앱 오류 확인

Error Reporting은 Google Cloud 프로젝트의 모든 앱과 서비스 및 Amazon Elastic Compute Cloud(EC2) 애플리케이션의 오류 조건을 한곳에서 모니터링할 수 있는 기능을 제공합니다.

이 가이드에서는 다음 작업을 수행하는 방법을 알아봅니다.

1. Google Cloud 프로젝트의 서비스에서 오류를 시뮬레이션합니다.

2. Error Reporting을 사용하여 오류를 확인하고 오류 상태를 변경하면 팀원이 문제가 해결되었음을 알 수 있습니다.

3. 새로운 유형의 오류가 발생하는 경우 알림을 받을 수 있도록 알림을 설정합니다.

---

Google Cloud 콘솔에서 이 태스크에 대한 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.

둘러보기

---

시작하기 전에

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Google Cloud 프로젝트에서 Cloud Shell을 엽니다. Cloud Shell이 시작되면 연결 중 메시지가 표시됩니다.

   Cloud Shell을 엽니다.

오류 시뮬레이션

1. 샘플 오류 11개를 생성하려면 Cloud Shell에서 다음 스크립트를 실행합니다.

     COUNTER=0
     while [  $COUNTER -lt 11 ]; do
         gcloud beta error-reporting events report --service tutorial --service-version v$((COUNTER/10+1)) \
             --message "java.lang.RuntimeException: Error rendering template $COUNTER
               at com.example.TestClass.test(TestClass.java:51)
               at com.example.AnotherClass(AnotherClass.java:25)
               at javax.servlet.http.HttpServlet.service (HttpServlet.java:617)
               at javax.servlet.http.HttpServlet.service (HttpServlet.java:717)"
         if [ $COUNTER -eq 10 ]; then
           echo "All sample errors reported."
         fi
         let COUNTER=COUNTER+1
     done
   

   스크립트가 모든 오류 생성을 완료하면 다음 줄이 출력됩니다.

   All sample errors reported.

Error Reporting에서 오류 보기

1. Google Cloud 콘솔에서 Error Reporting 페이지로 이동합니다.

   Error Reporting으로 이동

   검색창을 사용하여 이 페이지를 찾을 수도 있습니다.

   Error Reporting 대시보드에는 발견된 각 오류의 요약 목록과 발생 횟수가 표시됩니다. 자동 새로고침이 사용 설정되면 Error Reporting에서 10초마다 오류 목록을 자동으로 새로고침합니다.

   다음 스크린샷은 오류 보고 페이지 샘플을 보여줍니다.

   

2. 오류 이름을 클릭하면 오류에 관해 제공되는 모든 정보가 포함된 오류 세부정보 페이지가 표시됩니다. 프로젝트에서 Gemini가 사용 설정된 경우 Gemini를 사용하여 문제 해결 추천을 얻을 수 있습니다.

알림 구성

새로운 유형의 오류가 발생하면 알림을 표시하도록 Error Reporting을 구성할 수 있습니다. 기존 오류가 다시 발생할 경우에는 알림이 전송되지 않습니다.

1. Google Cloud 콘솔에서 Error Reporting 페이지로 이동합니다.

   Error Reporting으로 이동

   검색창을 사용하여 이 페이지를 찾을 수도 있습니다.

2. 이메일 알림을 사용 설정하려면 더보기 를 클릭하고 드롭다운 목록에서 프로젝트에 새로운 오류 발생 시 알림 사용 설정을 선택합니다.

3. 새로운 유형의 오류를 생성하려면 Cloud Shell 활성화를 클릭하고 다음 스크립트를 실행합니다.

     COUNTER=0
     while [ $COUNTER -lt 3 ]; do
           gcloud beta error-reporting events report --service tutorial --service-version v1 \
               --message "java.lang.ArrayIndexOutOfBoundsException: $COUNTER
                 at com.example.AppController.createUser(AppController.java:42)
                 at com.example.User(User.java:31)
                 at javax.servlet.http.HttpServlet.service (HttpServlet.java:617)
                 at javax.servlet.http.HttpServlet.service (HttpServlet.java:717)"
         if [ $COUNTER -eq 10 ]; then
           echo "All sample errors reported."
         fi
         let COUNTER=COUNTER+1
     done
   

   스크립트가 모든 오류 생성을 완료하면 다음 줄이 출력됩니다.

   All sample errors reported.

4. 이메일에서 'Stackdriver 알림'으로부터 온 메시지를 확인합니다.

App Engine 앱에서 오류 메시지 생성

스크립트에서 생성된 샘플 메시지는 Error Reporting의 오류 조건을 완전히 시뮬레이션하지만 Google Cloud 프로젝트에서 실행되는 실제 서비스에서 오류를 생성하려면 이 섹션의 단계를 수행합니다.

앱 배포

애플리케이션을 다운로드하고 App Engine에 배포하려면 다음 안내를 따르세요.

1. GitHub 프로젝트 python-docs-samples에서 애플리케이션을 다운로드하고 구성합니다.

   1. 프로젝트를 Cloud Shell에 클론합니다.

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

      Git이 다음과 유사한 메시지를 반환합니다.

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

   2. 격리된 Python 환경을 만들고 활성화합니다.

      cd python-docs-samples/appengine/standard_python3/hello_world
      virtualenv env -p python3
      source env/bin/activate
      

   3. 종속 항목을 설치합니다.

      pip install -r requirements.txt
      

2. 애플리케이션이 성공적으로 설치되고 구성되었는지 확인합니다.

   1. 애플리케이션을 실행합니다.

      python main.py
      

   2. 로컬 웹페이지에서 애플리케이션을 보려면 Cloud Shell에 표시된 링크를 클릭합니다. 웹페이지에 Hello World!가 표시됩니다.

   3. 실행 중인 애플리케이션을 중지하려면 Cloud Shell에서 Ctrl-C를 입력합니다.

3. 애플리케이션을 App Engine에 업로드합니다.

   gcloud app deploy
   

   배포 리전을 묻는 메시지가 표시되면 가까운 리전을 선택합니다. 계속할지 묻는 메시지가 표시되면 Y를 입력합니다. 잠시 후 업로드가 완료됩니다.

4. Cloud Shell에서 다음 명령어를 실행하여 브라우저에서 애플리케이션을 봅니다.

   gcloud app browse
   

   Google Cloud CLI에서 브라우저를 찾을 수 없는 경우 이전 명령어에서 오류 메시지와 링크를 표시합니다. 표시된 링크를 클릭합니다. 브라우저에 메시지 Hello, World!가 표시됩니다.

오류 생성

Error Reporting에서 포착하여 표시하는 오류를 만들려면 다음을 수행합니다.

1. main.py를 수정하고

   return 'Hello World!
   

   다음으로 바꿉니다.

   return 'Hello World!' + 1000
   

   이 변경 작업을 실행하면 Python TypeError 예외가 발생합니다. 문자열과 정수의 연결은 유효하지 않기 때문입니다.

2. 수정된 애플리케이션을 App Engine에 업로드합니다.

   gcloud app deploy
   

3. 실행 중인 애플리케이션이 있는 브라우저 탭으로 돌아가서 페이지를 새로고칩니다. 변경사항으로 인해 Hello, World!라는 페이지 대신 오류 메시지가 표시됩니다.

   Internal Server Error
   The server encountered an internal error and was unable to complete your
   request. Either the server is overloaded or there is an error in the
   application.
   

   이 메시지가 표시되지 않으면 잠시 기다렸다가 페이지를 다시 새로고치세요. 새 버전이 활성화되기까지 시간이 약간 걸릴 수 있습니다.

Error Reporting에서 오류 보기

오류를 보려면 이전 섹션 Error Reporting에서 오류 보기의 안내를 따르세요.

삭제

이 페이지에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 수행합니다.

주의: 프로젝트를 삭제하면 다음과 같은 효과가 발생합니다.
• 프로젝트의 모든 항목이 삭제됩니다. 이 문서의 태스크에 기존 프로젝트를 사용한 경우 프로젝트를 삭제하면 프로젝트에서 수행한 다른 작업도 삭제됩니다.
• 커스텀 프로젝트 ID가 손실됩니다. 이 프로젝트를 만들 때 앞으로 사용할 커스텀 프로젝트 ID를 만들었을 수 있습니다. appspot.com URL과 같이 프로젝트 ID를 사용하는 URL을 보존하려면 전체 프로젝트를 삭제하는 대신 프로젝트 내에서 선택한 리소스만 삭제합니다.
1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

다음 단계

• 오류를 보는 방법에 대해 자세히 알아보기

• 오류 관리 자세히 알아보기