이 가이드에서는 Google Cloud 콘솔에서 오류를 보고 필터링하는 방법을 보여줍니다. 오류에 대한 세부정보를 필터링하고, 정렬하고, 볼 수 있으며 오류를 특정 기간으로 제한할 수 있습니다.
Error Reporting 페이지에는 현재 필터와 일치하는 오류 그룹 목록이 표시됩니다. 각 행에는 오류 그룹의 해결 상태, 응답 코드, 오류 이름과 같은 정보가 표시됩니다.
발생 횟수 열에는 선택한 기간 내에 오류가 발생한 횟수를 나타내는 파란색 막대가 있는 막대 그래프가 표시됩니다. 텍스트를 기준으로 오류 그룹을 필터링하면 막대 그래프에 텍스트 필터와 일치하지 않는 오류 수를 나타내는 회색 막대가 표시됩니다.
Error Reporting에서 오류를 오류 그룹으로 구성하는 방법에 대한 자세한 내용은 오류 그룹화 방식을 참조하세요.
오류 그룹 세부정보 페이지에는 오류 기록, 특정 오류 인스턴스, 오류 샘플의 진단 정보 등 오류 그룹에 대한 정보가 표시됩니다. 프로젝트에서 Gemini가 사용 설정된 경우 Gemini를 사용하여 문제 해결 추천을 얻을 수 있습니다.
연결된 로그 항목 보기
샘플 오류와 관련된 로그 항목을 보려면 최근 샘플 패널의 항목에서 로그 보기를 클릭합니다. 로그 탐색기 페이지로 이동합니다.
로그 탐색기에서 쿼리 편집기 창은 error_groups ID 필드가 포함된 필터로 자동 입력됩니다. 해당 오류 그룹에 기여한 로그 항목 목록이 쿼리 결과 창에 표시됩니다.
로그 항목이 오류 그룹에 포함된 경우 로그 탐색기가 로그 항목 표시에 오류 그룹 버튼()을 추가합니다. 버튼을 클릭하면 그룹 세부정보에 액세스하거나 표시되는 로그 항목을 변경할 수 있습니다. 자세한 내용은 오류 그룹이 있는 로그 항목 찾기를 참조하세요.
Google Cloud Console을 사용하여 로그 보기에 대한 자세한 내용은 로그 탐색기 사용을 참조하세요.
오류 그룹 필터링
Error Reporting 툴바의 필터를 사용하여 상태, 영향을 받은 리소스, 로그 항목을 저장하는 로그 버킷의 리전을 기준으로 필터링할 수 있습니다.
리소스별 오류 그룹 필터링
리소스별로 오류 그룹을 필터링하려면 모든 리소스 메뉴를 선택한 후 리소스를 선택합니다. 일부 리소스를 사용하면 오류 그룹 라벨을 기준으로 추가로 필터링할 수 있습니다.
사용 가능한 오류 그룹 라벨의 유형과 수는 리소스에 따라 다릅니다. 예를 들어 Kubernetes Container Services 리소스에 대한 오류 그룹이 있으면 서비스별로 필터링한 다음 버전별로 필터링할 수 있습니다.
선택사항을 저장하려면 적용을 클릭합니다.
리소스 필터를 지우고 필터링된 오류 그룹 목록을 재설정하려면 재설정을 선택한 다음 적용을 선택합니다.
텍스트를 기준으로 오류 그룹 필터링
텍스트로 오류를 필터링하려면 오류 필터링 텍스트 필드에 값을 입력합니다.
텍스트 필터는 다음 필드에서 텍스트 일치를 수행할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-02-11(UTC)"],[[["\u003cp\u003eThis guide explains how to use the Google Cloud console's Error Reporting page to view and filter error groups, including sorting and viewing detailed error information.\u003c/p\u003e\n"],["\u003cp\u003eThe Error Reporting page displays error groups with details like resolution status, response code, error name, and a bar graph showing error occurrences within a selected time range.\u003c/p\u003e\n"],["\u003cp\u003eTo view detailed information about an error group, click on the error name to access the Error Group Details page, which includes error history, instances, and diagnostic data, with Gemini offering troubleshooting suggestions.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter error groups by status, resources, region, or text-based criteria, including error information, HTTP response code, exception stack, request URL, report location, and HTTP method.\u003c/p\u003e\n"],["\u003cp\u003eThe Log Explorer allows you to view the log entries related to a specific error, with a pre-populated filter containing the \u003ccode\u003eerror_groups\u003c/code\u003e ID, but this field is only usable in Logs Explorer and Log Analytics, not in sinks, alerts, or metrics.\u003c/p\u003e\n"]]],[],null,["This guide shows you how to view and filter errors with the\nGoogle Cloud console. You can filter, sort, and view additional\ndetails about errors, as well as restrict errors to a specific time range.\n\nThe **Error Reporting** page displays a list of\nerror groups that match the current filter. Each row shows\ninformation such as the resolution status, response code, and error name for an\nerror group.\nThe **Occurrences** column shows a bar graph with blue bars that represent the\nnumber of times an error occurred within the selected\ntime range. When you filter error groups by text, the bar graphs show grey bars\nto represent the number of errors that didn't match the text filter:\n\nFor information on how Error Reporting organizes\nerrors into error groups, see\n[How errors are grouped](/error-reporting/docs/grouping-errors).\n\n\u003cbr /\u003e\n\n| **Note** : If you see the message \"Set up Error Reporting\" on the **Error Reporting** page, then your Google Cloud project has no error groups to display.\n\n\u003cbr /\u003e\n\nBefore you begin\n\n- Ensure that you have least one error group. For more information, see [Collect error data by using Error Reporting](/error-reporting/docs/setup).\n\n\u003c!-- --\u003e\n\n-\n\n To get the permissions that\n you need to view and filter errors,\n\n ask your administrator to grant you the\n\n\n [Error Reporting Viewer](/iam/docs/roles-permissions/errorreporting#errorreporting.viewer) (`roles/errorreporting.viewer`)\n IAM role on your project.\n\n\n For more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\n You might also be able to get\n the required permissions through [custom\n roles](/iam/docs/creating-custom-roles) or other [predefined\n roles](/iam/docs/roles-overview#predefined).\n\nView error details\n\nThe details of an error group include the history of errors, the\nresolution status, the number of occurrences, and a timestamped list of errors.\nEach entry in the list contains a link to relevant logs and, when available,\na stacktrace.\n\nTo view the details of an error group, do the following:\n\n1. In the Google Cloud console, go to the **Error Reporting** page:\n\n [Go to **Error Reporting**](https://console.cloud.google.com/errors)\n\n \u003cbr /\u003e\n\n You can also find this page by using the search bar.\n2. Click the error name.\n\n The **Error Group Details** page displays information about the error group,\n including the history of an error, specific error instances, and diagnostic\n information from error samples. If Gemini is enabled in the\n project, then you can use Gemini to\n [get troubleshooting suggestions](/error-reporting/docs/troubleshoot-errors-gemini).\n\nView associated log entries\n\nTo view the log entry associated with a sample error, click **View Logs** from\nany entry in the **Recent samples** panel. This takes you to the\n**Logs Explorer** page.\n\nIn the **Logs Explorer** , the query-editor pane is pre-populated with a\nfilter that contains the `error_groups` ID field. The list of log entries\ncontributing to that error group is shown in the **Query results** pane.\n| **Note:** You can filter by the `error_groups` ID field only when querying logs, for example, when you are using the **Logs Explorer** and **Log Analytics** pages. You can't use this field in log sinks, log-based alerts, or log-based metrics.\n\nWhen a log entry is part of an error group, Logs Explorer adds the\nerror group button () to the display of the\nlog entry. Click the button to access grouping details or to change which log\nentries are shown. For more information, see\n[Find log entries with error groups](/logging/docs/analyze/find-logs-error-groups).\n\nFor more information on using the Google Cloud console to view these logs,\nsee [Using the Logs Explorer](/logging/docs/view/logs-explorer-interface).\n\nFilter error groups\n\nYou can use the filters on the Error Reporting toolbar to filter\nby the status, the affected resources, and the region of the log buckets\nthat store your log entries.\n\nFilter error groups by resource\n\nTo filter error groups by resource, select the **All Resources** menu and then\nselect a resource. Some resources let you further filter by error group labels.\nThe type and number of available error group labels vary depending on the\nresource. For example, if you have error groups for the\n**Kubernetes Container Services** resource, then you can filter first by\nservice and then by version:\n\nTo save your selections, click **Apply**.\n\nTo clear your resource filters and reset the list of\nfiltered error groups, select **Reset** and then select **Apply**.\n\nFilter error groups by text\n\nTo filter errors by text, enter a value in the **Filter errors** text field.\nThe text filter can perform a text match on any of the following fields:\n\n- Error information\n- HTTP Response Code\n- Exception stack\n- Request URL\n- Report location\n- HTTP method\n\nWhat's next\n\n- [Learn more about managing errors](/error-reporting/docs/managing-errors)\n- [Learn more about managing service errors](/error-reporting/docs/service-errors)"]]
)을 추가합니다. 버튼을 클릭하면 그룹 세부정보에 액세스하거나 표시되는 로그 항목을 변경할 수 있습니다. 자세한 내용은 오류 그룹이 있는 로그 항목 찾기를 참조하세요.