• English日本語한국어
  • 로그인지금 시작하기

Node.js 에이전트 설치

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

계정 신청하기

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

Node.js 에이전트 설치

중요

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

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');을 추가합니다.

중요

Babel 또는 유사한 트랜스파일러(변환기)를 사용하는 경우 Node.js 명령줄 옵션 '-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
);
  1. 선택사항: 추가적인 Node.js 런타임 수준 통계의 경우 @newrelic/native-metrics 패키지가 설치되어 있는지 확인합니다.
  2. 일부 트래픽을 생성한 다음, 데이터가 APM UI에 표시될 때까지 몇 분 정도 기다립니다.

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

이 문서가 설치하는데 도움이 되셨나요?

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

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

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

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

문제 해결

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

Copyright © 2023 New Relic Inc.

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