New Relic Azure Site Extension for Nodeを使用して、Azureで管理されるWebアプリにNode.js エージェントをインストールできます。このドキュメントでは、Azure Web アプリのデータをNew Relicに取り込むための互換性、インストレーション、設定について説明します。
互換性および要件
Azure Site Extensionsは、コードとしてデプロイされたWindowsベースのApp Serviceアプリでのみ使用できます。Windows 32で実行されるアプリケーションの場合、コードレベルメトリクスの完全なサポート（ファイルパス、行、列）は利用できません。プロファイリングは関数名のみにフォールバックします。
Azure Site Extensionを使用したNode.jsエージェントのインストール
New Relic Azure Site Extensionをインストールするには、AzureホームページからNewRelic.Azure.WebSites.Extension.NodeAgentサイト拡張機能を追加します。次の手順に従ってください。
- Azure ホームページで [App Services] タイルをクリックし、表示されたリストから目的の’アプリケーションを選択します。
- 左側のDevelopment ToolsカテゴリにリストされているオプションでExtensionsまでスクロールします。
- ページ上部の+ Addをクリックして拡張機能のドロップダウンを切り替え、 New Relic Node Agentを選択します。法的条件に同意するチェックボックスをオンにしてください
- 拡張機能のインストールを開始するには、ページの下部にあるAddをクリックしてください。
インストールされると、拡張機能は以下のアーティフアクトを作成します。
- フォルダ：
C:\home\SiteExtensions\NewRelic.Azure.Websites.Extension.NodeAgent - XMLドキュメント変換（XDT）：
applicationHost.xdtは、アプリケーションの起動時に必要なNODE_OPTIONS環境変数を追加します。 - New Relic Nodeエージェントと依存関係は、
C:\home\site\wwwroot\node_modules
ログを有効にしてエージェントのインストールが成功すると、エージェントはそのログをC:\home\site\wwwroot\newrelic_agent.logのファイルに追加します。拡張機能のインストールに失敗した場合、ログファイルがC:\home\SiteExtensions\NewRelic.Azure.Websites.Extension.NodeAgent\install.logに作成されます。
Node.jsエージェントを設定する
Node.js エージェントは、 newrelic.jsファイルまたは環境変数を使用して設定されます。より詳細な設定については、ドキュメントを参照してください。
サイト拡張機能のインストールが完了したら、アプリケーションを再起動する前に、設定項目を1つ手動で入力する必要があります。左側のオプションリストから、 Settings [設定]を見つけて、 Environment variables [環境変数]まで下にスクロールします。ライセンスキーの値を使用して、NEW_RELIC_LICENSE_KEY変数を追加してください。
New Reliceのサイト拡張機能は、-r newrelic環境変数を自動的に追加し、その値はNODE_OPTIONSとなります。これにより、Nodeの起動時にエージェントが挿入されます。以前に定義されたNODE_OPTIONSは削除され、 -r newrelicにリセットされます。
重要
この Azureサイト拡張機能のインストールや削除は、Web アプリケーションを停止している間に行うことをお勧めします。