• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

Node.js VM 측정

New Relic의 Node.js 에이전트는 Node.js 가상 머신(V8)에서 주요 메트릭 타임슬라이스 데이터 를 수집합니다. 이러한 메트릭은 Node.js VM 동작에 대한 통찰력을 제공하고 애플리케이션 성능을 개선하는 데 도움이 됩니다. 에이전트는 또한 종종 가비지 수집(GC) 메트릭과 함께 분석되는 CPU 메트릭을 수집합니다.

필요한 것

New Relic은 가비지 수집, 메모리 및 CPU와 관련된 Node.js VM 메트릭 타임슬라이스 데이터를 수집하기 위해 추가 기본 모듈 이 필요합니다. Node.js v6.1.0부터 New Relic Node.js 에이전트가 process.cpuUsage() 을 사용하여 CPU 메트릭을 수집하므로 기본 모듈은 CPU 메트릭을 수집하는 데 필요하지 않습니다.

기본 모듈은 다음과 함께 사용할 수 있습니다.

  • New Relic Node.js 버전 1.35.1 이상
  • Node.js v4 이상
  • npm v2.0.0 이상

배포 플랫폼에서 기본 모듈을 컴파일하려면 node-gyp 패키지 절차를 따르세요. 기본 Node.js 모듈을 설치하기 위한 전제 조건은 다음과 같습니다.

플랫폼

전제 조건

유닉스/리눅스

Python(v2.7 권장, v3.xx는 지원하지 않음), make, C/C++ 컴파일러(예: GCC)

맥 OS

Python(v2.7 권장, v3.xx는 지원되지 않음), Xcode

윈도우

Python(v2.7 권장, v3.xx 미지원), Visual C++ 빌드 환경

Node.js 에이전트를 설치하는 데 문제가 있는 경우 설치 문제 해결 절차를 따르세요.

기본 모듈 설치

New Relic Node.js 에이전트 v2.0.0부터 기본 모듈은 자동 설치를 시도하는 선택적 종속성이 되었습니다.

설치하는 동안 기본 모듈은 먼저 대상 시스템의 소스에서 빌드를 시도합니다. 빌드가 실패하면 Node.js는 일반적으로 무시할 수 있는 스택 추적을 콘솔에 출력합니다. 지원되는 버전의 Node를 실행하는 Linux 환경의 경우 에이전트는 사전 빌드된 바이너리를 다운로드하고 설치하려고 시도합니다.

에이전트가 사전 빌드된 바이너리를 다운로드하고 설치하지 못하도록 할 수 있습니다. 대신 네이티브 모듈 빌드만 시도합니다. npm 또는 Yarn을 사용하여 설치하기 전에 NR_NATIVE_METRICS_NO_DOWNLOAD 환경 변수를 true 로 설정하면 됩니다.

bash
$
export NR_NATIVE_METRICS_NO_DOWNLOAD=true
bash
$
npm install @newrelic/native-metrics
bash
$
yarn add @newrelic/native-metrics

또는 npm에서 작동하는 --no-download 플래그를 사용하세요.

bash
$
npm install @newrelic/native-metrics --no-download

NR_NATIVE_METRICS_NO_DOWNLOAD=true 또는 --no-download 플래그가 설정된 상태로 빌드가 실패하면 선택적 기본 모듈이 설치되지 않습니다.

두 환경 변수가 모두 설정되면 NR_NATIVE_METRICS_NO_BUILDNR_NATIVE_METRICS_NO_DOWNLOAD 을 재정의합니다.

이전 버전을 사용하는 경우 최신 에이전트 버전으로 업그레이드 하거나 기본 모듈을 수동으로 설치합니다.

  1. 지원되는 버전의 Node.js가 설치되어 있는지 확인합니다. 권장 사항: 최신 LTS 버전을 사용하십시오. @newrelic/native-metrics 모듈(v4 이상)에 대해 지원되는 최소 버전보다 낮은 버전을 사용하지 마세요.

  2. 현재 사용 가능한 모든 측정항목을 가져오려면 에이전트 1.37.0 이상에 대해 newrelic 모듈을 실행하고 있는지 확인하세요.

  3. Windows 사용자: 다음 명령을 실행합니다.

    bash
    $
    npm install --global windows-build-tools

    이 단계가 작동하지 않으면 GitHub의 node-gyp 모듈 에서 옵션 2를 따라 수동 설치 지침을 따르십시오.

  4. 기본 메트릭 모듈을 설치하려면 다음 방법 중 하나를 사용하십시오.

    • npm install @newrelic/native-metrics --save 명령을 실행합니다.

      또는

    • 앱의 package.json 파일에 모듈을 추가합니다.

  5. 앱을 다시 시작합니다.

Node.js 에이전트는 기본 메트릭 모듈이 설치되어 있는지 자동으로 감지하고 이를 사용하기 시작합니다. 네이티브 모듈을 완전히 설치하지 않으려면 다음 npm 또는 Yarn 인수를 사용할 수 있습니다.

bash
$
npm install newrelic --no-optional
bash
$
yarn add newrelic --ignore-optional

사전 빌드된 바이너리

빌드 단계를 건너뛰고 사전 빌드된 바이너리만 다운로드하려고 시도하고 콘솔에서 빌드 오류가 표시되지 않도록 하려면 설치 전에 NR_NATIVE_METRICS_NO_BUILD 환경 변수를 true 로 설정합니다.

bash
$
export NR_NATIVE_METRICS_NO_BUILD=true

방화벽 뒤에서 작업하는 경우 설치 전에 NR_NATIVE_METRICS_DOWNLOAD_HOSTNR_NATIVE_METRICS_REMOTE_PATH 환경 변수를 설정하여 사전 빌드된 바이너리를 캐시할 수 있습니다.

bash
$
export NR_NATIVE_METRICS_DOWNLOAD_HOST=http://your-internal-cache/
bash
$
export NR_NATIVE_METRICS_REMOTE_PATH=path/to/download/folder/

환경 변수를 설정했으면 설치를 계속할 수 있습니다.

bash
$
npm install @newrelic/native-metrics
bash
$
yarn add @newrelic/native-metrics

Node.js VM 데이터 보기

Node.js VM 데이터로 선별된 차트를 보려면 one.newrelic.com > All capabilties > APM & services > (앱 선택) > Node VMs 으로 이동합니다. 자세한 내용은 Node.js VMs statistics page [Node.js VMs 통계 페이지를] 참조하세요.

데이터는 메트릭 및 이벤트 에서도 사용할 수 있습니다.

측정 세부 정보

모든 Node.js 버전에서 모든 데이터를 수집할 수 있는 것은 아닙니다. 일반적으로 최신 LTS 버전의 Node.js를 사용하는 경우 가장 완전한 데이터를 얻을 수 있습니다.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.