インストレーションの方法
Windows上でWebアプリをコードとしてデプロイしている場合は、Azureサイト拡張機能を使用してNodeエージェントを簡単にインストールできます。[]こちらの手順を参照してください](/docs/apm/agents/nodejs-agent/installation-configuration/install-nodejs-azure-site-extension)。
コンテナアプリをデプロイする場合は、 Dockerの手順に従ってください。
LinuxでホストされるWebアプリの場合は、エージェントを手動でインストールする必要があります。これについては以下で説明します。
手動インストレーション
New RelicのNode.jsエージェントを使用してMicrosoft Azure Web Appsをホスティングサービスとして使用する場合の特別な注意事項について説明します。
必要なこと
Node.jsエージェントの互換性と要件に加えて、このチュートリアルでは、プラットフォームにNode.jsとWindows Azure SDK for Node.jsが正しくインストールされていることを前提としています。
- Azure SDK for Node.jsをインストールします。
- Gitがインストールされていることを確認します。
重要
Node.jsエージェントは、 Azure Functionsのテレメトリーを配信できません。代わりに、 Azure Functions監視インテグレーションを使用する必要があります。
Node.jsエージェントのインストール
New Relic Node.js エージェントをAzureアプリケーションに追加するには、まずnewrelic
モジュールが読み込まれていることを確認し、Node.js -r
/ --require
フラグを使用して以下を実行します。
$node -r newrelic server.js
重要
Next.jsアプリの場合は、次のようにNODE_OPTIONS
経由でエージェントを読み込みます。
$NODE_OPTIONS='-r newrelic' next start
Azureでのアプリ設定の追加
インストール後、Azure Web Appsでアプリを設定する必要があります。
portal.azure.comにサインインします。
App Services > (select a Node.js app) > Configureを選択します。
app settingsに以下を追加します。
new_relic_app_name
:Windows Azure Webサイト名new_relic_license_key
:お使いのNew Relic
設定を保存します。
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 Web AppsなどのPaaS環境で実行される場合、 newrelic.js
内のすべての構成変数には、環境変数として設定できる対応する変数があります。設定ファイル内の変数を自由に組み合わせることができます。環境変数は設定ファイルの設定を上書きします。
たとえば、Azureユーザーの利便性のためにAPP_POOL_ID
が設定されている場合、エージェントはそれをアプリケーション名(NEW_RELIC_APP_NAME
)として使用します。これにより、設定を2度行うことなく、選択した名前を使用できます。詳細については、 環境変数を使用したNode.jsの構成を参照してください。