このページでは、New Relic Javaエージェントのサイト拡張機能を使用して、Windows上のAzure App ServiceにNew Relic Javaエージェントをインストールする方法について説明します。拡張機能は、アプリの起動スクリプトを変更することなく、エージェントを自動的に挿入します。
互換性と要件
サポート対象
- Azure Windows App Service で実行されている Java アプリケーション
- Java 8以降と互換性のあるNew Relic Javaエージェントのバージョン(Java 7はエージェントv6.5.4以前でのみサポートされています)
- サポートされているフレームワークおよびライブラリのバージョン範囲については、互換性および要件を参照してください
サポートされていない
- Azure上のLinuxコンテナ — Dockerインストール方法を使用し、次を経由して
-javaagentを渡しますJAVA_TOOL_OPTIONS - 他のAPMエージェントとの並行稼働 — 同じJVM内で別のAPMエージェントがアクティブな場合、Javaエージェントは正しい動作を保証できません。
必要なこと
- New Relicアカウントおよび
- SHA-2(256ビット)SSLをサポートするJVM
- Azure Windows App Service 上で実行されている Java アプリケーション
- 部分的な計装を避けるため、拡張機能をインストールする前にターゲットアプリケーションを停止する必要があります。
インストール
サイト拡張機能のインストール
- Azure ホームページから App Services を選択し、次にターゲットアプリケーションを選択します。
- 左側のメニューで、Development Tools [開発ツール]までスクロールし、Extensions [拡張機能]を選択します。
- ページ上部の+ Addを選択して、拡張機能のドロップダウンを開きます。
- New Relic Javaエージェントを選択してください。
- 法的条件に同意し、OKを選択してインストレーションを開始します。
インストールされると、拡張機能は以下を作成します:
C:\home\NewRelic\JavaAgent\newrelic\のエージェントファイル(jar、設定、ソース)- アプリケーションの起動時に
JAVA_TOOL_OPTIONS環境変数を自動的に注入するXDT変換(applicationHost.xdt)
拡張機能のインストールに失敗した場合は、C:\home\SiteExtensions\NewRelic.Azure.WebSites.Extension.JavaAgent\install.logのログを確認してください。
エージェントを構成します
- アプリケーションの左側のメニューで、Settings > Configurationに移動します。
- 以下のアプリケーション設定を追加します:
| 設定 | 価値 |
|---|---|
NEW_RELIC_LICENSE_KEY | あなたのNew Relicライセンスキー |
NEW_RELIC_APP_NAME | New Relicプラットフォームに表示される名前 |
エージェントをさらにカスタマイズするために、アプリ設定として追加の設定を追加することもできます。
インストールの確認
アプリケーションを起動してください。少なくとも2つのrequestsを送信してください。2~3分待つと、アプリケーションがAPM & サービスに表示されます。
5分経過してもデータが表示されない場合は、データが表示されない(Java)を参照してください。