Node.js 에이전트 설치

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

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

Node.js 에이전트 설치

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

1. 뉴렐릭 계정을 만드십시오.계정이 아직 없으신가요? 무료로 신청하세요! 신용카드는 필요하지 않습니다.

2. 시스템 요구 사항을 충족하는지 확인합니다. 특히 지원되는 Node.js 버전이 사용되는지 확인해야 합니다.

3. 모니터링하려는 각 애플리케이션에 대해 npm install newrelic --save 명령을 사용합니다.

4. node_modules/newrelic에서 newrelic.js를 앱의 루트 디렉토리로 복사합니다.

5. newrelic.js 파일 또는 환경 변수를 통해 에이전트를 구성합니다.

   • 계정 라이선스 키

     를 사용해 license_key 설정을 맞춤화합니다.

   • 하나 이상의 의미 있는 앱 이름으로 app_name을 설정합니다.

6. 앱의 기본 모듈의 첫 번째 줄로 require('newrelic');을 추가합니다.

node -r newrelic ./dist/server.js

// 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
);

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

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

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

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

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

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

문제 해결

에이전트를 업데이트한 후 약간의 트래픽을 생성하고 몇 분 정도 기다립니다. 뉴렐릭 UI에 데이터가 표시되지 않으면 문제 해결 절차를 참조하세요.