오류 보기 및 필터링

이 가이드에서는 Google Cloud 콘솔에서 오류를 보고 필터링하는 방법을 보여줍니다. 오류에 대한 세부정보를 필터링하고, 정렬하고, 볼 수 있으며 오류를 특정 기간으로 제한할 수 있습니다.

Error Reporting 페이지에 현재 필터와 일치하는 오류 그룹 목록이 표시됩니다. 각 행에는 오류 그룹의 해결 상태, 응답 코드, 오류 이름과 같은 정보가 표시됩니다. 발생 횟수 열에는 선택한 기간 내에 오류가 발생한 횟수를 나타내는 파란색 막대가 있는 막대 그래프가 표시됩니다. 텍스트를 기준으로 오류 그룹을 필터링하면 막대 그래프에 텍스트 필터와 일치하지 않는 오류 수를 나타내는 회색 막대가 표시됩니다.

필터링된 오류 목록을 표시하는 사용자 인터페이스

Error Reporting에서 오류를 오류 그룹으로 구성하는 방법에 대한 자세한 내용은 오류 그룹화 방식을 참조하세요.

시작하기 전에

  • 오류를 보고 필터링하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트의 Error Reporting 뷰어(roles/errorreporting.viewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

    커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

오류 세부정보 보기

오류 그룹의 세부정보에는 오류 기록, 해결 상태, 발생 횟수, 타임스탬프가 적용된 오류 목록이 포함됩니다. 목록의 각 항목에는 관련 로그 링크와 스택 추적(있는 경우)이 포함됩니다.

오류 그룹의 세부정보를 보려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 Error Reporting을 선택하거나 다음 버튼을 클릭한 후 프로젝트를 선택합니다.

    Error Reporting으로 이동

  2. 오류 이름을 클릭합니다.

    오류 그룹 세부정보 페이지에는 오류 기록, 특정 오류 인스턴스, 오류 샘플의 진단 정보 등 오류 그룹에 대한 정보가 표시됩니다. 프로젝트에서 Duet AI가 사용 설정된 경우 Duet AI를 사용하여 문제 해결 제안을 얻을 수 있습니다.

    다음 스크린샷은 오류 그룹 세부정보 페이지를 보여줍니다.

    오류 세부정보 보기를 표시하는 사용자 인터페이스

연결된 로그 항목 보기

샘플 오류와 관련된 로그 항목을 보려면 최근 샘플 패널의 항목에서 로그 보기를 클릭합니다. 로그 탐색기로 이동합니다.

현재 오류 그룹에 대한 필터와 그 아래의 해당 오류 그룹에 기여하는 로그 항목 목록이 검색 쿼리 상자에 미리 입력되어 있습니다.

오류 그룹 필터를 표시하는 사용자 인터페이스

error_group 필터는 로그 탐색기에서만 작동합니다. 예를 들어 로그 내보내기 싱크 또는 측정항목을 만들 때 적용되지 않습니다.

로그 항목이 오류 그룹에 포함된 경우 로그 탐색기가 로그 항목 표시에 오류 그룹 버튼()을 추가합니다. 버튼을 클릭하면 그룹 세부정보에 액세스하거나 표시되는 로그 항목을 변경할 수 있습니다. 자세한 내용은 오류 그룹이 있는 로그 항목 찾기를 참조하세요.

Google Cloud Console을 사용하여 로그 보기에 대한 자세한 내용은 로그 탐색기 사용을 참조하세요.

오류 그룹 필터링

Error Reporting 페이지의 오류 그룹 목록에 표시되는 오류 그룹 유형을 필터링하고 제한하려면 필터 메뉴를 사용합니다. 오류 그룹 리소스, 상태, 텍스트 문자열로 필터링할 수 있습니다.

리소스별로 오류 그룹 필터링

리소스별로 오류 그룹을 필터링하려면 모든 리소스 메뉴를 선택한 후 리소스를 선택합니다. 일부 리소스를 사용하면 오류 그룹 라벨을 기준으로 추가로 필터링할 수 있습니다. 사용 가능한 오류 그룹 라벨의 유형과 수는 리소스에 따라 다릅니다. 예를 들어 Kubernetes Container Services 리소스에 대한 오류 그룹이 있으면 서비스별로 필터링한 다음 버전별로 필터링할 수 있습니다.

Kubernetes Container Services 리소스에 사용할 수 있는 오류 그룹 라벨 필터를 보여주는 Error Reporting 리소스 필터 메뉴입니다.

선택 항목을 저장하려면 적용을 클릭합니다.

리소스 필터를 지우고 필터링된 오류 그룹 목록을 재설정하려면 재설정을 선택한 다음 적용을 선택합니다.

상태별로 오류 그룹 필터링

오류 상태별로 오류를 필터링하려면 미해결, 확인됨 메뉴를 선택하고 오류 상태를 선택합니다. 선택한 상태에 따라 필터 이름이 변경됩니다.

텍스트를 기준으로 오류 그룹 필터링

텍스트를 기준으로 오류를 필터링하려면 오류 필터링 텍스트 필드에 값을 입력합니다. 텍스트 필터는 다음 필드에서 텍스트 일치를 수행할 수 있습니다.

  • 오류 정보
  • HTTP 응답 코드
  • 예외 스택
  • 요청 URL
  • 보고서 위치
  • HTTP 메서드

정렬 오류

필터링 외에도 다음 제목을 기준으로 오류 그룹을 정렬할 수 있습니다.

  • 발생 횟수: 이 열을 정렬하면 가장 자주 발생하는 오류를 확인할 수 있습니다.
  • 최초 발생 시간: 이 열을 정렬하면 새로 발생한 오류를 찾을 수 있습니다.
  • 최근 발생 시간: 이 열을 정렬하면 아직도 발생하고 있는 오류를 알 수 있습니다. 또한 이 열을 역순으로 정렬하여 어떤 오류가 발생이 중지되었는지 확인할 수도 있습니다.

작업

다음은 오류를 보고 필터링하는 데 도움이 되는 다른 작업입니다.

  • 문제에 연결: 이 버튼을 클릭하면 이 오류 그룹에 Issue Tracker 링크를 추가할 수 있습니다.

버그 아이콘 보기 옵션을 표시하는 사용자 인터페이스

  • 문제 보기: 이 버튼을 클릭하면 이 오류 그룹에 연결된 Issue Tracker 페이지로 이동합니다. Issue Tracker 링크를 삭제해야 하는 경우 오류 세부정보 페이지에서 수행하면 됩니다.

버그 아이콘 보기 옵션을 표시하는 사용자 인터페이스

  • 자동 새로고침: 10초마다 목록을 새로고침합니다.

다음 단계