설치 방법
윈도우에서 코드를 구현하고 웹 앱을 실행하고 있는 경우, Azure 사이트 확장 프로그램을 사용하여 노드 에이전트를 쉽게 설치할 수 있습니다. []이 지침](/docs/APM 에이전트/nodejs-에이전트/설치-설정/install-nodejs-azure-site-extension)을 참조하십시오.
컨테이너 앱을 구현한 경우 Docker를 위한 지침을 따르면 됩니다.
Linux에서 호스팅되는 웹 앱의 경우 에이전트를 수동으로 설치해야 합니다. 그 방법은 아래와 같습니다.
수동 설치
뉴렐릭의 Node.js 에이전트를 통해 Microsoft Azure 웹 앱을 호스팅 서비스로 사용할 때 특별히 고려해야 할 사항을 알아보십시오.
필요한 사항
이 튜토리얼에서는 Node.js 에이전트의 호환성 및 요구 사항 외에도 플랫폼에 맞는 Node.js 및 Node.js용 Windows Azure SDK가 올바르게 설치되어 있다고 가정합니다.
- Node.js용 Azure SDK를 설치합니다.
- Git이 설치되어 있는지 확인합니다.
중요
Node.js 에이전트는 Azure Functions에 대한 텔레메트리를 제공할 수 없습니다. 대신 Azure Functions 모니터링 통합을 사용해야 합니다.
Node.js 에이전트 설치
Azure 애플리케이션에 뉴렐릭 Node.js 에이전트를 추가하려면 newrelic 모듈이 먼저 로드되었는지 확인하고 Node.js -r/--require 플래그를 사용하여 다음을 실행합니다.
$node -r newrelic server.js중요
Next.js 앱의 경우, 다음과 같이 NODE_OPTIONS 통해 에이전트를 로드합니다.
$NODE_OPTIONS='-r newrelic' next startAzure에 앱 설정 추가
설치 후 Azure 웹 앱에서 앱을 설정해야 합니다.
portal.azure.com에 로그인합니다.
App Services > (select a Node.js app) > Configure을 선택합니다.
app settings에 다음을 추가합니다.
new_relic_app_name: 귀하의 Windows Azure 웹사이트 이름new_relic_license_key: 귀하의 뉴렐릭
설정을 저장합니다.
Node.js 앱을 다시 시작합니다.
앱으로 트래픽을 유도하고 몇 분간 기다립니다. 기다린 후 one.newrelic.com > All capabilities > APM & services > (select your app)으로 이동하여 데이터를 확인합니다.
선택 사항: CLI를 통한 앱 설정 추가
선택 사항: CLI(Node.js SDK)를 사용해 앱 설정을 추가하는 방법의 예는 다음과 같습니다.
$azure account download "YOUR_SUBSCRIPTION_NAME"$azure account import "PATH_TO_PUBLISH_SETTINGS_FILE"$azure site config add "new_relic_app_name=REPLACE_WITH_YOUR_APP_NAME"$azure site config add "new_relic_license_key=REPLACE_WITH_YOUR_LICENSE_KEY"$azure site restart AZURE_WEB_APP_NAME환경 변수 사용
에이전트가 Heroku나 Azure 웹 앱 같은 PaaS 환경에서 실행되는 경우 newrelic.js의 모든 구성 변수에는 환경 변수로 설정할 수 있는 대응 변수가 있습니다. 설정 파일에서는 변수를 자유롭게 혼합해 사용할 수 있습니다. 환경 변수는 구성 파일 설정을 재정의합니다.
예를 들어, Azure 사용자의 편의를 위해 에이전트는 애플리케이션 이름(NEW_RELIC_APP_NAME)으로 APP_POOL_ID를 사용하므로 이름을 두 번 설정하지 않고 선택한 이름을 사용할 수 있습니다. 보다 자세한 내용은 환경 변수로 Node.js 구성을 참조하십시오.