다음 두 가지 방법 중 하나로 Google Kubernetes Engine 애플리케이션에서 Error Reporting으로 오류를 보낼 수 있습니다.
Cloud Logging에 로깅. Cloud Logging을 이미 사용 중인 경우 유일한 추가 요구사항은 Error Reporting에서 로그 항목을 인식할 수 있어야 한다는 것입니다. 오류 형식 지정 요구사항에 대한 자세한 내용은 Cloud Logging의 형식 지정 오류를 참조하세요.
Error Reporting API 사용. 애플리케이션은 REST API를 사용하여 HTTP 요청을 보내거나 여러 언어로 실험용 라이브러리를 활용할 수 있습니다.
Logging을 사용해 오류 보고하기
GKE의 기본 로깅 에이전트는 클러스터의 로그를 Cloud Logging으로 보내는 에이전트를 배포하고 관리하는 관리형 솔루션을 제공합니다. 에이전트 구조는 클러스터 버전에 따라 달라집니다. 이 에이전트에 대한 자세한 내용은 GKE 로그 관리를 참조하세요.
Error Reporting을 사용하려면 예외 사항 또는 스택 트레이스가 단일 로그 항목에 포함되어야 합니다. 대부분의 로깅 에이전트는 새 행에 출력된 각 스택 프레임과 같은 여러 로그 행이 스택 트레이스를 나타내는 것을 인식할 수 있고 이를 Cloud Logging에 단일 로그 항목으로 전송합니다.
에이전트가 여러 행을 단일 오류로 재구성할 수 없으면 오류 콘텐츠를 제어할 수 있는 projects.events.report
API 엔드포인트를 사용합니다.
Error Reporting API를 사용하여 오류 쓰기
Error Reporting API는 서비스에 오류 정보를 작성하기 위한 report
엔드포인트를 제공합니다.
Enable the Error Reporting API.
REST API 또는 클라이언트 라이브러리를 사용하여 오류를 API로 보고합니다.
샘플
ASP.NET
ASP.NET NuGet 패키지는 ASP.NET 웹 애플리케이션에서 포착되지 않은 예외를 Error Reporting으로 보고합니다.
NuGet 패키지 설치
Visual Studio에서 Stackdriver ASP.NET NuGet 패키지를 설치하려면 다음 단계를 따르세요.
- 솔루션을 마우스 오른쪽 버튼으로 클릭하고 Manage NuGet packages for solution(솔루션용 NuGet 패키지 관리)를 선택합니다.
- Include prerelease(사전 출시 포함) 체크박스를 선택합니다.
- 이름이
Google.Cloud.Diagnostics.AspNet
인 패키지를 검색하여 설치합니다.
사용량
Stackdriver ASP.NET NuGet 패키지를 설치했으면 애플리케이션 코드에 다음 문을 추가하여 Stackdriver로 오류 보내기를 시작합니다.
using Google.Cloud.Diagnostics.AspNet;
다음 HttpConfiguration
코드를 .NET 웹 앱(your-project-id
를 실제 프로젝트 ID로 바꿈)의 Register
메서드에 추가하여 예외 보고를 사용 설정합니다.
이 메소드를 ASP.NET 애플리케이션에 추가하면 Google Cloud console의 Error Reporting 섹션에서 Google Cloud에 보고될 때 발생하는 포착되지 않은 예외를 볼 수 있습니다.
C#
다음 예는 GoogleCloudPlatform/dotnet-docs-samples 저장소에서 찾을 수 있습니다. 사용하려면 프로젝트를 빌드한 후 프로젝트 ID를 지정합니다.
C:\...\bin\Debug> set GOOGLE_PROJECT_ID=[YOUR_PROJECT_ID]
[YOUR_PROJECT_ID]
를 Google Cloud Console의 올바른 값으로 바꿉니다.
그런 다음 다음과 유사한 코드로 예외 데이터를 보냅니다.
Go
Go용 Error Reporting 설정을 참조하세요.
자바
자바용 Error Reporting 설정을 참조하세요.
Node.js
Node.js용 Error Reporting 설정을 참조하세요.
Ruby
Ruby용 Error Reporting 설정을 참조하세요.
Python
Python용 Error Reporting 설정을 참조하세요.
PHP
PHP용 Error Reporting 설정을 참조하세요.
오류 그룹 보기
Google Cloud 콘솔에서 Error Reporting 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾을 수도 있습니다.