문제 해결

예상되는 오류 이벤트가 콘솔 또는 API에 표시되지 않는 경우 이러한 문제 해결 단계를 사용하여 Error Reporting 문제를 진단하고 해결할 수 있습니다.

Error Reporting은 Error Reporting API에 대한 직접 호출과 Cloud Logging에서 수집한 로그 항목의 자동 분석이라는 두 가지 경로를 통해 오류를 캡처합니다. 다음 섹션을 사용하여 API 호출의 형식이 올바르고 로그 싱크가 지원되는 버킷으로 라우팅되며 예외 페이로드가 지원되는 언어 구조를 따르는지 확인합니다.

Error Reporting API로 전송된 오류 이벤트가 표시되지 않음

Error Reporting API를 사용하여 오류 이벤트를 your Google Cloud project로 전송합니다. 하지만 이러한 이벤트는 Error Reporting 페이지에 표시되지 않습니다.

이 문제를 해결하려면 다음 단계를 따르세요.

  1. Error Reporting API가 사용 설정되어 있는지 확인합니다.

    Error Reporting API를 사용 설정합니다.

    API 사용 설정에 필요한 역할

    API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한을 이미 보유하고 있을 가능성이 높습니다. 그렇지 않은 경우 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법을 알아보세요.

    API 사용 설정하기

  2. Cloud Shell을 열고 Google Cloud CLI를 사용하여 프로젝트에 오류 이벤트를 전송할 수 있는지 확인합니다.

    1. 다음 명령어를 실행합니다.

      gcloud beta error-reporting events report --service Manual --service-version test1 \
  --message "java.lang.TestError: msg
    at com.example.TestClass.test(TestClass.java:51)
    at com.example.AnotherClass(AnotherClass.java:25)"

    2. Error Reporting 페이지로 이동하여 페이지에 TestError: msg라는 오류가 표시되는지 확인합니다.

      **Error Reporting** 으로 이동

    3. 로그 탐색기 페이지로 이동하여 로그 항목에서 TestError를 검색합니다. 로그 항목이 자동으로 생성됩니다.

      로그 탐색기 로 이동

  3. 애플리케이션이 오류 이벤트를 report 엔드포인트로 전송하고, 애플리케이션이 요청 본문의 형식을 ReportedErrorEvent 객체로 지정하며, 로그 항목이 생성되는지 확인합니다. Error Reporting API를 사용하는 경우 올바른 형식의 오류 메시지가 포함된 로그 항목이 자동으로 생성되고 Cloud Logging에 기록됩니다. 이러한 로그 항목은 logName과 같이 형식이 지정된 로그에 기록됩니다.

    projects/PROJECT_ID/clouderrorreporting.googleapis.com%2Freported_errors

오류 이벤트가 표시되지만 Error Reporting API가 사용 중지됨

Error Reporting API를 사용 중지했습니다. 하지만 콘솔의 Error Reporting 페이지 Google Cloud 에 오류 이벤트가 표시됩니다.

이는 정상적인 동작입니다. 오류 이벤트는 Error Reporting API 호출에 대한 응답으로 report 엔드포인트에 생성됩니다. 하지만 Error Reporting이 로그 데이터를 분석할 수 있는 경우 오류 이벤트도 추론됩니다.

로그 데이터에서 오류 이벤트가 추론되지 않음

Error Reporting이 로그 데이터를 검사하고 오류 이벤트를 추론할 것으로 예상합니다. 하지만 로그 항목에 오류 데이터가 기록되어 있어도 Error Reporting 페이지에 오류 이벤트가 표시되지 않습니다.

이 문제를 해결하려면 다음 단계를 따르세요.

  1. Error Reporting이 로그 항목을 분석할 수 있는지 확인합니다.

    Error Reporting은 Cloud Logging을 기반으로 빌드된 글로벌 서비스이며, 다음 모든 조건에 해당하는 경우 로그 항목을 분석할 수 있습니다.

    • Assured Workloads가 사용 중지되었습니다. 자세한 내용은 Assured Workloads 개요를 참조하세요.
    • 고객 관리 암호화 키 (CMEK) 로그 항목을 저장하는 모든 로그 버킷에서 사용 중지되었습니다. Error Reporting은 CMEK가 사용 설정된 로그 버킷에 로그 항목을 저장할 수 없습니다. 로그 버킷의 CMEK 구성을 확인하는 방법은 키 사용 설정 확인을 참조하세요.
    • 로그 버킷이 다음 중 하나를 충족합니다.