.NET용 Error Reporting 설정

라이브러리 사용 설정

.NET용 Stackdriver Error Reporting 라이브러리를 사용하여 .NET 애플리케이션에서 Stackdriver Error Reporting에 오류 보고서를 보낼 수 있습니다.

Error Reporting은 App Engine, Compute Engine, Google Kubernetes Engine과 같은 일부 Google Cloud Platform 제품에 통합되어 있습니다. Error Reporting은 해당 제품에서 실행되는 애플리케이션에서 Stackdriver Logging에 로깅한 오류를 표시합니다. 자세한 내용은 Google Cloud Platform에서 실행을 참조하세요.

또한 Stackdriver Logging을 사용하여 Error Reporting에 오류 데이터를 보낼 수도 있습니다. 데이터 형식 지정 요구사항에 대한 자세한 내용은 Stackdriver Logging의 형식 지정 오류 메시지를 참조하세요.

시작하기 전에

  1. Google 계정에 로그인합니다.

    아직 계정이 없으면 새 계정을 등록하세요.

  2. Google Cloud Platform 프로젝트를 선택하거나 만듭니다.

    리소스 관리 페이지로 이동

  3. Google Cloud Platform 프로젝트에 결제가 사용 설정되어 있는지 확인하세요.

    결제 사용 설정 방법 알아보기

  4. Error Reporting API 를 사용 설정합니다.

    API 사용 설정

클라이언트 라이브러리 설치

.NET용 Stackdriver Error Reporting 라이브러리를 사용하면 거의 모든 곳에서 실행되는 .NET 애플리케이션에서 보고된 오류를 모니터링하고 볼 수 있습니다.

설치에 관한 자세한 내용은 .NET용 Stackdriver Error Reporting 라이브러리 문서를 참조하세요. 문제 추적기를 사용하여 문제를 보고할 수도 있습니다.

클라이언트 라이브러리 구성

.NET용 Stackdriver Error Reporting 라이브러리의 동작을 맞춤설정하려면 .NET API 참조 문서를 확인하세요.

오류 보고

다음 명령어로 클라우드 라이브러리를 설치합니다.

패키지 관리자

PM> Install-Package Google.Cloud.Diagnostics.AspNetCore -Version 2.0.1

.NET CLI

> dotnet add package Google.Cloud.Diagnostics.AspNetCore --version 2.0.1

App Engine 가변형 환경을 사용하는 경우 App Engine 가변형 환경 섹션을 참조하세요.

Google Cloud Platform에서 실행

.NET용 Stackdriver Error Reporting 라이브러리를 사용하려면 Cloud IAM Error Reporting 작성자 역할이 필요합니다. 대부분의 Google Cloud Platform 컴퓨팅 플랫폼은 기본적으로 이 역할을 제공합니다.

App Engine 가변형 환경

App Engine은 기본적으로 Error Reporting 작성자 역할을 부여합니다.

.NET용 Stackdriver Error Reporting 라이브러리는 명시적으로 사용자 인증 정보를 제공하지 않아도 사용 가능합니다.

Stackdriver Error Reporting은 App Engine 가변형 환경 애플리케이션에서 자동으로 사용 설정되며 추가 설정은 필요하지 않습니다. App Engine에서 stderr로 작성된 메시지가 분석되고 스택 추적이 포함되어 있으면 Error Reporting에 표시됩니다.

GCP Console에서 애플리케이션의 오류 및 예외 데이터를 보는 방법에 대한 안내는 오류 보기를 참조하세요.

GKE

GKE에서는 다음 예시 명령어에 표시된 것처럼 클러스터를 만들 때 cloud-platform 액세스 범위를 추가해야 합니다.

gcloud container clusters create example-cluster-name --scopes https://www.googleapis.com/auth/cloud-platform

Compute Engine

Compute Engine VM 인스턴스를 사용할 때 각 인스턴스에 cloud-platform 액세스 범위를 추가하세요. Google Cloud Platform Console을 통해 새 인스턴스를 만들 때 인스턴스 만들기 패널의 ID 및 API 액세스 섹션에서 이 작업을 수행할 수 있습니다. 선택한 Compute Engine 기본 서비스 계정 또는 다른 서비스 계정을 사용하고 ID 및 API 액세스 섹션에서 모든 Cloud API에 대한 전체 액세스 허용을 선택하세요. 어떤 서비스 계정을 선택하든 GCP Console의 IAM 및 관리자 섹션에서 Error Reporting 작성자 역할이 부여되었는지 확인하세요.

로컬 및 기타 위치에서 실행

Google Cloud Platform 외부에서 .NET용 Stackdriver Error Reporting 라이브러리를 사용하려면 GCP 프로젝트 ID와 적절한 서비스 계정 자격 사용자 인증 정보를 .NET용 Stackdriver Error Reporting 라이브러리에 직접 제공해야 합니다. 이는 사용자 워크스테이션, 데이터 센터의 컴퓨터 또는 다른 클라우드 제공업체의 VM 인스턴스에서 라이브러리를 실행하는 경우에 적용됩니다. 자세한 내용은 수동으로 서비스 계정 사용자 인증 정보 획득 및 제공을 참조하세요.

오류 보고서 보기

배포 후 GCP Console의 Error Reporting 대시보드에서 오류 보고서를 볼 수 있습니다.

Error Reporting 대시보드로 이동

자세한 내용은 오류 보기를 참조하세요.

.NET Core 애플리케이션용 Stackdriver Error Reporting 설정

Google.Cloud.Diagnostics.AspNetCore 클라이언트 라이브러리를 사용하려면 다음 안내를 따르세요.

  1. Visual Studio에서 솔루션을 마우스 오른쪽 버튼으로 클릭하고 Manage Nuget packages for solution(솔루션용 Nuget 패키지 관리)을 선택합니다.

  2. Include prerelease(사전 출시 포함) 체크박스를 선택합니다.

  3. 이름이 Google.Cloud.Diagnostics.AspNetCore인 패키지를 검색하여 설치합니다.

  4. Google.Cloud.Diagnostics.AspNetCore 클라이언트가 설치되었으면 애플리케이션의 소스 코드 파일에 다음 using 지시문을 추가합니다(Error Reporting으로 전송되는 오류 정보를 맞춤설정하려는 경우).

     using Google.Cloud.Diagnostics.AspNetCore;
    

그런 다음 애플리케이션에서 커스텀 오류 보고서를 로깅하려면 다음 단계를 완료합니다.

  1. 애플리케이션의 Startup.cs 파일에서 ConfigureServices 메소드를 만들거나 수정하고 services.AddGoogleExceptionLogging()을 호출합니다.

    services.AddGoogleExceptionLogging(options =>
    {
        options.ProjectId = "YOUR-GOOGLE-PROJECT-ID";
        options.ServiceName = "ShoppingCartService";
        options.Version = "0.01";
    });
    
  2. 애플리케이션의 Startup.cs 파일에서 Configure 메소드를 수정하고 app.UseGoogleExceptionLogging()을 호출한 app.UseStaticFiles()app.UseMvc()를 호출합니다.

    // Use before handling any requests to ensure all unhandled exceptions are reported.
    app.UseGoogleExceptionLogging();
    

다음 샘플에서는 Stackdriver Error Reporting에서 내부 데이터화를 위해 커스텀 오류 이벤트를 보고하는 로깅 오류를 보여줍니다.

throw new Exception("Generic exception for testing Stackdriver Error Reporting");
이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

Stackdriver Error Reporting
도움이 필요하시나요? 지원 페이지를 방문하세요.