Docker용 Node.js 에이전트 설치

Node.js 에이전트를 사용하여 Docker 컨테이너에 배포된 Node.js 애플리케이션을 계측할 수 있습니다. 이 문서는 New Relic으로 계측된 Dockerized Node.js 애플리케이션을 빌드, 구성 및 배포하는 방법을 설명합니다.

컨테이너 계측

몇 가지만 추가하면 기존 Dockerfile을 Node.js 에이전트와 함께 사용할 수 있습니다. 환경 변수가 설정된 새 Docker 이미지를 실행하여 에이전트를 구성합니다.

1. package.json 에 newrelic 추가:

   "newrelic": "latest",

   카피

   특정 버전을 설치하거나 package.json 형식 에서 제공하는 다른 옵션을 사용하십시오. 이전 에이전트 버전에 대한 정보 는 Node.js 에이전트 릴리스 정보 를 확인하십시오.

2. 컨테이너 설정 방법에 따라 node -r newrelic YOUR_PROGRAM.js 실행하여 Node.js -r/--require 플래그와 함께 먼저 newrelic 모듈을 포함하도록 ENTRYPOINT 를 편집할 수 있습니다. 프로그램 실행 방법을 제어할 수 없는 경우 require('newrelic') 추가하여 프로그램의 다른 모듈보다 먼저 newrelic 모듈을 로드할 수 있습니다.

   Next.js의 경우 newrelic 대신 @newrelic/next 사용하세요.

   팁

   npm start 와 같은 프로그램을 실행하기 위한 npm 스크립트가 있는 경우 npm pkg set scripts.start="node -r newrelic your-program.js" 실행하여 이 스크립트를 프로그래밍 방식으로 수정할 수 있습니다.

   중요

   Node.js 에이전트가 v7.2.0 보다 이전 버전인 경우 구성 파일 없이 에이전트를 실행할 수 있도록 Dockerfile에 환경 변수 NEW_RELIC_NO_CONFIG_FILE=true 를 추가해야 합니다. 구성 설정 및 우선 순위에 대한 자세한 내용은 여기에서 확인할 수 있습니다.

3. 평소와 같이 Docker 이미지를 빌드합니다.

4. 에이전트가 활성화된 상태에서 Docker 앱을 실행하려면 다음을 추가하십시오. 라이선스 키환경 변수로 docker run 명령에 대한 앱 이름 :

   bash

   카피

   $
   docker run -e NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY \
   >
          -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \
   >
          YOUR_IMAGE_NAME:latest

기타 구성 옵션

애플리케이션 이름 또는 라이선스 키를 설정하는 것 외에도 -e 옵션으로 컨테이너를 시작하여 다른 구성 옵션 을 설정할 수 있습니다. 예를 들어, 분산 추적 을 사용하려면 다음을 사용하십시오.

$
docker run -e NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY \
>
        -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \
>
        -e NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true \
>
        YOUR_IMAGE_NAME:latest

ENV 지시문을 사용하여 Dockerfile에서 구성 옵션을 설정할 수도 있습니다.

ENV NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true \
    NEW_RELIC_LOG=stdout
    # etc.