Node.js용 Stackdriver Debugger 설정

App Engine

  1. npm을 사용하여 패키지를 설치합니다.

    npm install --save @google-cloud/debug-agent
    
  2. 앱의 기본 스크립트 맨 위 또는 진입점에서(@google/cloud-trace를 사용 중인 경우 그 뒤에) 에이전트를 사용 설정합니다.

    require('@google-cloud/debug-agent').start();
    

이제 디버거를 앱에서 사용할 수 있습니다.

GCP Console의 디버그 페이지에 배포된 앱과 일치하는 소스 코드를 자동으로 표시하려면 소스 코드 자동으로 선택을 참조하세요.

GKE

  1. 클러스터가 다음 액세스 범위 중 하나로 만들어졌는지 확인합니다.

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud_debugger

    예:

    gcloud container clusters create EXAMPLE-CLUSTER-NAME \
        --scopes https://www.googleapis.com/auth/cloud-platform
    
  2. Compute Engine 안내를 따릅니다.

Compute Engine

  1. Compute Engine 인스턴스가 액세스 범위의 선택사항인 모든 Cloud APIs에 대한 전체 액세스 허용으로 만들어졌거나 다음 액세스 범위 중 하나인지 확인합니다.

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud_debugger
  2. npm을 사용하여 패키지를 설치합니다.

    npm install --save @google-cloud/debug-agent
    
  3. 앱의 기본 스크립트 맨 위 또는 진입점에서(@google/cloud-trace를 사용 중인 경우 그 뒤에) 에이전트를 사용 설정합니다.

    require('@google-cloud/debug-agent').start({
      serviceContext: {
        service: 'SERVICE',
        version: 'VERSION'
      }
    });
    

    각 항목의 의미는 다음과 같습니다.

    • SERVICEMyApp, Backend, Frontend 등 앱 이름입니다.
    • VERSIONv1.0, build_147, v20170714 등 버전입니다.

    각 배포에서 소스 코드를 변경할 필요가 없도록 환경 변수에서 설정하는 것이 좋습니다.

이제 디버거를 앱에서 사용할 수 있습니다.

GCP Console의 디버그 페이지에 배포된 앱과 일치하는 소스 코드를 자동으로 표시하려면 소스 코드 자동으로 선택을 참조하세요.

로컬 및 기타 위치

  1. npm을 사용하여 패키지를 설치합니다.

    npm install --save @google-cloud/debug-agent
    
  2. 서비스 계정 사용자 인증 정보를 다운로드합니다.

    Google Cloud Platform에서 호스팅되지 않은 머신에서 Node.js용 Stackdriver Debugger 에이전트를 사용하려면 에이전트에서 GCP 서비스 계정 사용자 인증 정보를 사용하여 Stackdriver Debugger Service에 인증해야 합니다.

    GCP Console 서비스 계정 페이지를 사용하여 기존 또는 새 서비스 계정의 사용자 인증 정보 파일을 만듭니다. 서비스 계정에는 Stackdriver Debugger Agent 이상의 역할이 있어야 합니다.

  3. 다운로드된 사용자 인증 정보를 사용하여 에이전트를 구성하고 사용 설정합니다.

    require('@google-cloud/debug-agent').start({
      projectId: 'your-project-id',
      keyFilename: '/path/to/key.json',
      serviceContext: {
        service: 'SERVICE',
        version: 'VERSION'
      }
    });
    

    각 항목의 의미는 다음과 같습니다.

    • SERVICEMyApp, Backend, Frontend 등 앱 이름입니다.
    • VERSIONv1.0, build_147, v20170714 등 버전입니다.

    각 배포에서 소스 코드를 변경할 필요가 없도록 환경 변수에서 설정하는 것이 좋습니다.

이제 디버거를 앱에서 사용할 수 있습니다.

GCP Console의 디버그 페이지는 로컬 개발용 로컬 소스 파일을 업로드하지 않고 표시할 수 있습니다. 소스 코드 수동으로 선택을 참조하세요.

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

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

Stackdriver Debugger 문서