오류 관리

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

오류를 보려면 Cloud Console의 Error Reporting 페이지를 엽니다. 최근 발생한 오류 그룹 목록이 빈도 순으로 다음과 같이 표시됩니다.

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

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

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

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

오류 샘플

함께 그룹화된 오류는 대개 매우 비슷하기 때문에 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을 입력할 수 있습니다.

오류 그룹이 Issue Tracker 시스템의 URL과 이미 연결되어 있는 경우 버그 신고 아이콘 을 클릭하면 해당 링크가 새 브라우저 탭에 열립니다.

알림

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

오류 삭제

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

gcloud

모든 오류 이벤트를 삭제하려면 다음과 같이 합니다.

gcloud beta error-reporting events delete

REST API

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