Node.js 코드 프로파일링

이 페이지에서는 Node.js 코드를 프로파일링하도록 Stackdriver Profiler를 설정하는 방법을 설명합니다. Profiler는 Node.js에 실제 경과 시간 및 힙 프로파일링을 제공합니다. 자세한 내용은 프로파일링 개념을 참조하세요.

다음 버전의 Node.js가 지원됩니다.

  • 8.x 버전 분기에서 8.9.4 이상
  • 10.x 버전 분기에서 10.4.1 이상

다음과 같은 환경에서 Linux 기반의 프로파일링 에이전트를 사용할 수 있습니다.

  • Compute Engine
  • Google Kubernetes Engine
  • App Engine

또한 Google Cloud Platform 이외 시스템에서 Node.js 코드를 프로파일링할 수도 있습니다. 자세한 내용은 Google Cloud Platform 외부에서 코드 프로파일링을 참조하세요.

Profiler API 사용 설정

프로파일링 에이전트를 사용하기 전에 기본 Profiler API가 사용 설정되어 있는지 확인하세요. API의 상태를 확인하고 필요할 경우 Cloud SDK gcloud 명령줄 도구 또는 Cloud Console을 사용하여 사용 설정할 수 있습니다.

Cloud SDK

  1. 워크스테이션에 Cloud SDK를 아직 설치하지 않은 경우 Google Cloud SDK를 참조합니다.

  2. 다음 명령어를 실행합니다.

    gcloud services enable cloudprofiler.googleapis.com
    

자세한 내용은 gcloud services를 참조하세요.

Cloud Console

  1. API 및 서비스 대시보드로 이동합니다.

    API 및 서비스로 이동

  2. API에 액세스하는 데 사용할 프로젝트를 선택합니다.

  3. API 및 서비스 추가 버튼을 클릭합니다.

    API 및 서비스 추가

  4. Profiler API를 검색합니다.

  5. 검색결과에서 Stackdriver Profiler API를 선택합니다.

  6. API 사용 설정됨이 표시된다면 API가 이미 사용 설정되어 있는 것입니다. 그렇지 않다면 사용 설정 버튼을 클릭하세요.

Stackdriver Profiler 사용

지원되는 모든 환경에서 패키지를 설치하고, 애플리케이션의 패키지를 요청한 다음 평상시처럼 애플리케이션을 배포하여 Profiler를 사용합니다.

Stackdriver Profiler의 최신 버전을 설치하려면 다음을 수행합니다.

    npm install --save @google-cloud/profiler

Trace 에이전트도 사용 중인 경우 코드를 수정할 때 Trace 에이전트(@google-cloud/trace-agent) 다음에 Profiler를 가져옵니다. 자세한 내용은 Node.js용 Stackdriver Trace 설정을 참조하세요.

Compute Engine

Compute Engine에서 다음을 수행합니다.

  1. Stackdriver Profiler의 최신 버전을 설치합니다.

    npm install --save @google-cloud/profiler
    
  2. service에 프로파일링할 서비스의 이름을 할당하는 serviceContext 객체를 만들도록 애플리케이션 require 코드를 수정합니다. 원하는 경우 version에 프로파일링할 서비스의 버전을 할당할 수 있습니다. 이러한 구성 옵션에 대한 자세한 내용은 서비스 이름 및 버전 인수를 참조하세요.

    require('@google-cloud/profiler').start({
      serviceContext: {
          service: 'your-service',
          version: '1.0.0'
      }
    });

Google Kubernetes Engine

Google Kubernetes Engine(GKE)에서 다음을 수행합니다.

  1. Profiler 패키지를 설치하도록 Dockerfile을 수정합니다.

    FROM node:10
    ...
    RUN npm install @google-cloud/profiler
    
  2. service에 프로파일링할 서비스의 이름을 할당하는 serviceContext 객체를 만들도록 애플리케이션 require 코드를 수정합니다. 원하는 경우 version에 프로파일링할 서비스의 버전을 할당할 수 있습니다. 이러한 구성 옵션에 대한 자세한 내용은 서비스 이름 및 버전 인수를 참조하세요.

    require('@google-cloud/profiler').start({
      serviceContext: {
          service: 'your-service',
          version: '1.0.0'
      }
    });

App Engine

App Engine의 require 코드는 다음과 유사합니다.

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

App Engine에서는 serviceversion 매개변수가 환경에서 파생되므로 별도로 지정할 필요가 없습니다. 따라서 serviceContext 객체를 만들 필요가 없습니다.

데이터 분석

Profiler가 데이터를 수집하면 개발자가 Profiler 인터페이스를 사용하여 이 데이터를 보고 분석할 수 있습니다. 이 인터페이스를 사용하기 시작하려면 Profiler 인터페이스 열기를 참조하세요.

서비스 이름 및 버전 인수

Profiler 에이전트를 로드할 때는 서비스 이름 인수와 선택적 서비스 버전 인수를 지정하여 구성합니다.

서비스 이름은 Profiler가 해당 서비스의 모든 복제본에 대한 프로파일링 데이터를 수집할 수 있게 해줍니다. 프로파일러 서비스는 각 서비스 버전 및 영역(zone)의 조합에서 각 서비스 이름에 평균적으로 프로필이 1분에 하나씩 수집되도록 보장합니다.

예를 들어 두 버전이 3개 영역(zone)의 복제본에서 실행 중인 서비스가 있다면 프로파일러가 해당 서비스에 대한 프로필을 평균적으로 1분에 6개씩 만듭니다.

복제본에 서로 다른 서비스 이름을 사용하면 서비스가 불필요하게 자주 프로파일링되므로 오버헤드도 높아집니다.

서비스 이름을 선택할 때 다음에 유의하세요.

  • 애플리케이션 아키텍처에서 서비스를 분명히 나타내는 이름을 선택합니다. 단일 서비스 또는 애플리케이션만 실행하는 경우에는 서비스 이름 선택이 크게 중요하지 않습니다. 하지만 애플리케이션이 마이크로 서비스 집합으로 실행되는 경우와 같은 사례에서는 서비스 이름 선택이 중요합니다.

  • 서비스 이름 문자열에 프로세스 ID와 같은 프로세스 관련 값을 사용하지 않도록 합니다.

  • 서비스 이름 문자열은 다음과 같은 정규 표현식과 일치해야 합니다.

    ^[a-z]([-a-z0-9_.]{0,253}[a-z0-9])?$

imageproc-service와 같은 정적 문자열을 서비스 이름으로 사용하는 것이 좋습니다.

서비스 버전은 선택사항입니다. 서비스 버전을 지정하면 Profiler가 여러 인스턴스의 프로파일링 정보를 집계하여 올바르게 표시할 수 있습니다. 배포된 서비스의 여러 버전을 표시할 때 서비스 버전을 사용할 수 있습니다. Profiler UI를 사용하면 서비스 버전별로 데이터를 필터링할 수 있습니다. 그러면 이전 버전과 새로운 버전의 코드 성능을 비교할 수 있습니다.

서비스 버전 인수의 값은 자유 형식의 문자열이지만 이 인수의 값은 일반적으로 버전 번호와 유사합니다(예: 1.0.0 또는 2.1.2).

에이전트 로깅

프로파일링 에이전트는 로깅 정보를 보고할 수 있습니다. 로깅을 사용 설정하려면 에이전트를 시작할 때 logLevel 옵션을 설정하세요. 지원되는 logLevel 값은 다음과 같습니다.

  • 0: 모든 에이전트 로깅을 중지합니다.
  • 1: 오류 로깅을 사용 설정합니다.
  • 2: 경고 로깅을 사용 설정합니다(기본값)
  • 3: 정보 로깅을 사용 설정합니다.
  • 4: 디버그 로깅을 사용 설정합니다.

서비스 컨텍스트를 제공하는 객체에 logLevel 값을 설정합니다.

require('@google-cloud/profiler').start({
    serviceContext: { ... }
    logLevel:       3
});

알려진 문제

Node.js용 Stackdriver Profiler의 베타 출시 버전에서 알려진 문제는 다음과 같습니다.

  • Node.js용 프로파일링 에이전트는 프로그램의 정상 종료를 방해합니다. 따라서 프로그램의 모든 태스크가 완료된 후 프로그램이 종료되기까지 최대 1시간이 소요될 수 있습니다. Ctrl-C 등을 사용해서 프로그램을 강제로 종료하면 프로그램이 즉시 종료됩니다.

다음 단계

Profiler 그래프 및 컨트롤에 대해 알아보려면 Stackdriver Profiler 인터페이스 사용으로 이동하세요. 고급 정보는 다음을 참조하세요.

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

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

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