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 로 설정하면 됩니다.
$export NR_NATIVE_METRICS_NO_DOWNLOAD=true$npm install @newrelic/native-metrics$yarn add @newrelic/native-metrics또는 npm에서 작동하는 --no-download 플래그를 사용하세요.
$npm install @newrelic/native-metrics --no-downloadNR_NATIVE_METRICS_NO_DOWNLOAD=true 또는 --no-download 플래그가 설정된 상태로 빌드가 실패하면 선택적 기본 모듈이 설치되지 않습니다.
두 환경 변수가 모두 설정되면 NR_NATIVE_METRICS_NO_BUILD 가 NR_NATIVE_METRICS_NO_DOWNLOAD 을 재정의합니다.
이전 버전을 사용하는 경우 최신 에이전트 버전으로 업그레이드 하거나 기본 모듈을 수동으로 설치합니다.
지원되는 Node.js 버전이 설치되어 있는지 확인하세요. 권장사항: 최신 LTS 버전을 사용하세요.
@newrelic/native-metrics모듈에 대해 지원되는 최소 버전(v4 이상)보다 낮은 버전을 사용하지 마십시오.현재 사용 가능한 모든 측정항목을 가져오려면 에이전트 1.37.0 이상에 대해
newrelic모듈을 실행하고 있는지 확인하세요.Windows users: 다음 명령을 실행합니다.
bash$npm install --global windows-build-tools이 단계가 작동하지 않으면 GitHub의 node-gyp 모듈 에서 옵션 2를 따라 수동 설치 지침을 따르십시오.
기본 메트릭 모듈을 설치하려면 다음 방법 중 하나를 사용하십시오.
npm install @newrelic/native-metrics --save명령을 실행합니다.또는
앱의
package.json파일에 모듈을 추가합니다.
앱을 다시 시작합니다.
Node.js 에이전트는 기본 메트릭 모듈이 설치되어 있는지 자동으로 감지하고 이를 사용하기 시작합니다. 네이티브 모듈을 완전히 설치하지 않으려면 다음 npm 또는 Yarn 인수를 사용할 수 있습니다.
$npm install newrelic --no-optional$yarn add newrelic --ignore-optional사전 빌드된 바이너리
빌드 단계를 건너뛰고 사전 빌드된 바이너리만 다운로드하려고 시도하고 콘솔에서 빌드 오류가 표시되지 않도록 하려면 설치 전에 NR_NATIVE_METRICS_NO_BUILD 환경 변수를 true 로 설정합니다.
$export NR_NATIVE_METRICS_NO_BUILD=true방화벽 뒤에서 작업하는 경우 설치 전에 NR_NATIVE_METRICS_DOWNLOAD_HOST 및 NR_NATIVE_METRICS_REMOTE_PATH 환경 변수를 설정하여 사전 빌드된 바이너리를 캐시할 수 있습니다.
$export NR_NATIVE_METRICS_DOWNLOAD_HOST=http://your-internal-cache/$export NR_NATIVE_METRICS_REMOTE_PATH=path/to/download/folder/환경 변수를 설정했으면 설치를 계속할 수 있습니다.
$npm install @newrelic/native-metrics$yarn add @newrelic/native-metricsNode.js VM 데이터 보기
Node.js VM 데이터로 선별된 차트를 보려면 one.newrelic.com > All capabilities > APM & services > (select an app) > Node VMs 으로 이동하세요. 자세한 내용은 Node.js VM 통계 페이지를 참조하세요.
데이터는 메트릭 및 이벤트 에서도 사용할 수 있습니다.
측정 세부 정보
팁
모든 Node.js 버전에서 모든 데이터를 수집할 수 있는 것은 아닙니다. 일반적으로 최신 LTS 버전의 Node.js를 사용하는 경우 가장 완전한 데이터를 얻을 수 있습니다.