Error Reporting을 사용하여 오류 데이터 수집

이 문서는 Error Reporting에서 지원하는 환경을 나열하고, 애플리케이션 개발자를 위한 언어별 가이드에 연결합니다. 언어별 클라이언트 라이브러리를 사용하거나 자동으로 수집되는 로그를 사용하는 것이 좋습니다. 하지만 Cloud Logging API 또는 Error Reporting API를 사용하여 오류 데이터를 작성할 수 있습니다. 예를 들어 Cloud Run을 사용하면 stderr에 작성된 예외가 자동으로 Cloud Logging으로 전송됩니다.

Error Reporting은 Google Cloud 프로젝트의 로그를 자동으로 분석하여 오류를 식별하는 전역 서비스입니다. 하지만 Error Reporting은 소스 및 대상 Google Cloud 프로젝트가 동일하고 CMEK(고객 관리 암호화 키)가 실행 중지된 global 리전의 Cloud Logging 버킷에 저장된 로그 항목만 분석할 수 있습니다. 다른 Google Cloud 프로젝트, 리전화된 버킷으로 로그를 라우팅하거나 CMEK를 사용 설정하면 Error Reporting이 이러한 로그를 캡처하고 분석하지 않습니다. 로그 버킷의 구성을 확인하는 방법은 문제 해결을 참조하세요.

Virtual Private Cloud 지원

Error Reporting은 Virtual Private Cloud(VPC) 지원 서비스입니다.

데이터 무단 반출 위험을 줄이려면 VPC 서비스 제어를 사용하여 Google 관리형 서비스 주위에 서비스 경계를 만듭니다. VPC 서비스 제어 및 서비스 매개변수 만들기 방법에 대한 자세한 내용은 VPC 서비스 제어 문서를 참조하세요.

오류 데이터를 자동으로 보고하도록 환경 구성

환경별 구성 요구사항에 대한 자세한 내용은 다음 가이드를 참조하세요.

클라이언트 라이브러리를 사용하여 앱 계측

오류 보고서를 보내도록 애플리케이션을 구성하는 방법은 언어별 구성 가이드를 참조하세요.

API를 사용하여 오류 데이터 쓰기

Error Reporting API 메서드 report 또는 Cloud Logging API 메서드 write를 실행하여 Google Cloud 프로젝트에 오류 이벤트를 보고할 수 있습니다.

  • API 키 기반 인증이 필요한 경우 Error Reporting API를 사용해야 합니다. Error Reporting API를 사용하여 오류 이벤트를 보고하려면 report 메서드를 실행하고 메서드의 요청 본문 형식을 ReportedErrorEvent 객체로 지정합니다.

    Error Reporting API를 사용하면 올바른 형식의 오류 메시지가 포함된 로그 항목이 자동으로 생성되고 Cloud Logging에 기록됩니다. 이러한 로그 항목은 logName과 같이 형식이 지정된 로그에 기록됩니다.

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

    로그 항목은 report 호출을 통해 생성되므로 Cloud Logging 수집 비용이 발생할 수 있습니다. 수집되는 로그를 제어하려면 제외 필터를 참조하세요.

    Error Reporting API를 사용하여 오류 이벤트를 보고하는 경우 이 문서의 나머지 부분은 적용되지 않습니다.

  • Cloud Logging API를 사용하려면 스택 트레이스 또는 ReportedErrorEvent 객체를 포함하도록 LogEntry 객체를 포맷해야 합니다. 형식 지정 요구사항에 대한 자세한 내용은 로그의 형식 지정 오류를 참조하세요.