오류 관리

이 페이지에서는 Error Reporting에서 오류를 관리하는 방법을 설명합니다.

시작하기

Google Cloud 프로젝트의 서비스 및 앱에 대한 오류를 보려면 Google Cloud Console에서 Error Reporting으로 이동합니다.

Error Reporting으로 이동

Error Reporting 대시보드에는 발견된 각 오류의 요약 정보와 발생 횟수가 표시된 목록이 표시됩니다.

오류 목록을 보여주는 사용자 인터페이스

: 이 목록을 이메일의 받은편지함처럼 처리하세요. 기본 오류를 수정하거나 예상되거나 반복되는 오류를 숨겨 깔끔하고 유용하게 유지하세요.

Error Reporting 목록의 보기 및 필터링에 대한 자세한 내용은 오류 보기를 참조하세요.

오류를 관리하는 데 필요한 권한에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

오류 샘플

함께 그룹화된 오류는 대개 매우 비슷하기 때문에 Error Reporting은 1,000개의 샘플만 유지하고 나머지 정보를 추정합니다. 발생한 오류를 모두 유지하려면 로그를 BigQuery로 라우팅하여 향후 오류가 저장될 수 있도록 하는 것이 좋습니다.

각 샘플에 대해 UI는 애플리케이션에서 Error Reporting으로 보내는 데이터를 표시합니다. 예를 들어 App Engine 표준은 오류를 유발한 사용자 에이전트 및 요청 URL과 같은 유용한 메타데이터를 제공합니다. 로그 항목으로 자신의 오류 보고서를 보내는 경우 제공할 수 있는 필드 목록을 확인합니다. Error Reporting API를 사용하는 경우 ReportedErrorEvent 객체를 참조하세요.

자세한 내용은 오류 그룹화 방법을 참조하세요.

해결 상태 변경

워크플로를 관리하려면 다음을 수행하여 오류 그룹의 해결 상태를 변경합니다.

  1. Cloud Console에서 Operations > Error Reporting 페이지로 이동합니다.

    Error Reporting 페이지로 이동

  2. 각 오류 그룹에 대해 해결 상태가 표시됩니다.

    오류 해결 상태를 표시하는 사용자 인터페이스

  3. 앞 패널에서 해결 상태 열을 펼쳐서 오류 그룹의 상태를 변경합니다. 가능한 상태 값은 다음과 같습니다.

    • 열림: 모든 오류 그룹의 기본 초기 상태입니다. 다른 상태는 수동으로 설정됩니다. 언제든지 오류 그룹의 상태를 다시 열림으로 되돌릴 수 있습니다.
    • 확인됨: 오류 그룹 분류용 상태입니다.
    • 해결됨: 오류 그룹이 해결되고 더 이상 발생할 것으로 예상되지 않는 상태입니다. 나중에 해결됨으로 표시된 오류 그룹이 다시 발생하면 Error Reporting은 해결 상태를 다시 열림으로 변경합니다.
    • 숨김: 목록에서 오류 그룹을 숨긴 상태입니다. 자세한 내용은 오류 숨기기를 참조하세요.

오류 숨기기

해결 상태를 숨김으로 변경하여 Error Reporting 목록에서 오류 그룹을 숨길 수 있습니다. 숨긴 오류는 다시 발생하더라도 목록에 다시 표시되지 않습니다.

숨긴 오류 그룹을 보려면(필요에 따라 숨김 해제) 다음을 수행합니다.

  1. 숨긴 오류 관리를 클릭합니다.

    숨긴 오류 메뉴를 표시하는 사용자 인터페이스

  2. 해결 상태 필터는 해결됨숨김 오류 그룹만 표시합니다.

    해결 상태 숨기기 옵션을 표시하는 사용자 인터페이스

오류 그룹 숨김을 해제하려면 같은 해결 상태 패널에서 해결 상태 유형을 선택 해제합니다.

숨긴 오류가 다시 발생하면 Error Reporting에서 알림을 보내지 않습니다.

문제에 오류 연결

오류 그룹을 문제에 연결할 수 있습니다. 문제 링크와 연결되지 않은 오류 그룹에는 추가 아이콘 이 표시됩니다. 문제 링크와 연결된 오류 그룹에는 링크 아이콘 이 표시됩니다.

오류 그룹과 관련된 문제를 보려면 목록의 각 행 옆에 있는 링크 아이콘 을 클릭하세요.

링크 아이콘을 표시하는 사용자 인터페이스

오류 그룹이 문제 URL과 연결되어 있지 않은 경우 추가 아이콘 을 클릭하면 문제 URL을 이 오류에 연결 패널이 열리며, 여기에서 URL을 입력할 수 있습니다.

링크 아이콘을 표시하는 사용자 인터페이스

알림 설정

Error Reporting은 새로운 오류가 발생하고 해결됨으로 표시된 오류가 다시 발생했을 때 알림을 보낼 수 있습니다. 자세한 내용과 알림 설정에 대한 안내는 알림 관리를 참조하세요.

오류 삭제

gcloud 도구 또는 REST API를 사용하여 특정 Cloud 프로젝트에 대해 저장된 모든 오류 이벤트를 삭제하고 오류 수를 0으로 재설정할 수 있습니다.

gcloud

모든 오류 이벤트를 삭제하려면 다음 명령어를 실행합니다.

gcloud beta error-reporting events delete

REST API

모든 오류 이벤트를 삭제하려면 REST API의 projects.deleteEvents 메소드를 사용합니다.

Cloud 프로젝트에 대한 오류 알림을 구독한 후 해결됨 상태의 오류를 삭제한 경우 이 오류가 다시 발생하면 해결 상태가 다시 열림으로 변경되고 Error Reporting에서 알림을 전송합니다.

열림 또는 확인됨 상태의 오류를 삭제한 경우에는 오류가 다시 발생해도 Error Reporting에서 알림을 전송하지 않습니다.