Node.js 에이전트 설치

기본 Node.js 에이전트 설치를 완료하려면 자동 설치를 위한 가이드 설치(EU에 거주하는 경우 EU 선택)를 사용하거나 이 문서의 지침을 따르십시오. 어느 쪽이든, 아직 계정이 없다면 New Relic 계정이 필요합니다. ( 영원히 무료입니다! )

Node.js 에이전트는 npm(Node Package Manager) 저장소 와 GitHub 에서 공개적으로 사용할 수 있습니다.

중요

Docker 컨테이너에서 에이전트를 사용하는 경우 각 컨테이너에 에이전트를 설치합니다 .

Node.js 에이전트를 설치하려면:

새 유물 계정을 만드십시오. 하나가 없습니까? 무료 가입! 신용 카드가 필요하지 않습니다.
시스템 요구 사항 을 충족하는지 확인하십시오. 특히 지원되는 Node 버전을 사용하고 있는지 확인하십시오.
모니터링하려는 각 애플리케이션에 대해 npm install newrelic --save 명령을 사용합니다.
node_modules/newrelic 에서 newrelic.js 을 앱의 루트 디렉토리로 복사합니다.
newrelic.js 파일 또는 환경 변수 를 통해 에이전트를 구성합니다.
- 라이선스 키로 license_key 설정을 맞춤설정합니다.
- 하나 이상의 의미 있는 앱 이름 으로 app_name 설정을 맞춤설정합니다.
앱 기본 모듈의 첫 번째 줄로 require('newrelic'); 을 추가합니다.

중요

Babel 또는 유사한 변환기를 사용하는 경우 노드 명령줄 옵션 '-r' 을 사용하여 애플리케이션 시작 시 'newrelic' 모듈을 미리 로드하여 모듈 로드 순서와 관련된 모든 문제로부터 보호할 수 있습니다. 예를 들어 애플리케이션의 진입점이 ./dist/server.js 이면 다음과 같이 require 플래그를 사용합니다.

node -r newrelic ./dist/server.js

앱 기본 모듈의 첫 번째 줄로 require('newrelic'); 할 수 없고 위와 같이 require 플래그를 사용할 수 없는 경우(예: 애플리케이션 부트스트랩 중에 원격 위치에서 api 키를 비동기식으로 로드) 재고 계측을 다음에 추가할 수도 있습니다. newrelic.instrumentLoadedModule 을 사용하여 이미 로드된 지원 모듈 :

// module loaded before newrelic 
const expressModule = require('express');

// load the agent
const newrelic = require('newrelic');

// instrument express after the agent has been loaded
newrelic.instrumentLoadedModule(
  'express',    // the module's name, as a string
  expressModule // the module instance
);

선택 사항: 추가 Node.js 런타임 수준 통계 의 경우 @newrelic/native-metrics 패키지가 설치되어 있는지 확인합니다.
약간의 트래픽을 생성한 다음 데이터가 APM UI 에 나타날 때까지 몇 분 정도 기다립니다.

newrelic.js 또는 환경 변수를 통해 에이전트 동작을 추가로 맞춤설정할 수 있습니다. 에이전트 구성을 앱과 별도로 유지하려면 NEW_RELIC_HOME 환경 변수 를 편집합니다.

APM 및 인프라 데이터에 대한 로그 보기

또한 로그와 애플리케이션의 데이터를 함께 가져와 더 쉽고 빠르게 문제를 해결할 수 있습니다. 컨텍스트의 로그를 사용하면 앱의 UI에서 직접 오류 및 추적과 관련된 로그 메시지를 볼 수 있습니다. Kubernetes 클러스터와 같은 인프라 데이터 컨텍스트에서 로그를 볼 수도 있습니다. 다른 UI 페이지로 전환할 필요가 없습니다.

Node.js 에이전트를 최신 상태로 유지

최신 버전의 New Relic이 있는지 확인하려면 Node.js 릴리스 정보 를 참조하세요. 해당되는 경우 릴리스 정보에는 Node.js 에이전트를 업데이트하는 방법에 대한 지침이 포함된 다운로드 링크가 포함됩니다.

문제점 해결

에이전트를 업데이트한 후 약간의 트래픽을 생성하고 몇 분 동안 기다리십시오. New Relic UI에 데이터가 표시되지 않으면 문제 해결 절차 를 참조하십시오.

사용자의 편의를 위해 제공되는 기계 번역입니다.

Node.js 에이전트 설치