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 명령을 사용합니다. 앱이 이러한 Apollo Server 모듈 중 하나를 사용하는 경우 npm install @newrelic/apollo-server-plugin 사용해 Apollo 플러그인을 설치합니다. @newrelic/apollo-server-plugin 사용에 대한 자세한 내용은 여기에서 확인할 수 있습니다.

   중요

   Next.js를 사용하는 경우 newrelic 에이전트 대신 독립형 @newrelic/next 에이전트를사용합니다. 다음은 Next.js 앱의 예입니다.

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

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

   • 계정 라이선스 키

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

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

6. 앱의 시작 스크립트에 -r newrelic을 추가합니다. 예를 들어 애플리케이션의 진입점이 ./dist/server.js인 경우 다음과 같이 require 플래그를 사용합니다.

   bash

   복사

   $
   node -r newrelic ./dist/server.js

   Docker 명령의 예:

   CMD ["node", "-r", "newrelic", "server.js"]

   복사

   중요

   Next.js의 경우 -r newrelic 대신 -r @newrelic/next를 사용합니다.

   Nest.JS 및 nest start 명령을 사용하여 애플리케이션을 시작하는 경우 시작 바이너리를 수정하여 뉴렐릭 에이전트: nest start --exec 'node -r newrelic'을 로드합니다. 다음은 Nest.js 애플리케이션의 예입니다.

   Node.js 명령줄 옵션 -r에 대한 보다 자세한 내용은 여기를 참조하십시오.

   중요

   -r require 플래그를 사용할 수 없는 경우, 앱 메인 모듈의 첫 번째 줄로 require('newrelic')을 사용할 수도 있습니다. 참고: Babel 또는 유사한 트랜스파일러 require('newrelic')를 사용하는 경우 계측 문제가 발생합니다.

   이 옵션 모두 제대로 작동하지 않는다면(예: 애플리케이션 부트스트랩 중에 원격 위치에서 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
   );

   복사

7. 선택사항: 추가적인 Node.js 런타임 수준 통계의 경우 @newrelic/native-metrics 패키지가 설치되어 있는지 확인합니다.

8. 일부 트래픽을 생성한 다음, 데이터가 APM UI에 표시될 때까지 몇 분 정도 기다립니다.

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

보다 자세한 내용은 API 문서를 참조하십시오.

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

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

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

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

문제 해결

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