• /
  • ログイン
  • 無料アカウント

JVMの引数にJavaエージェントを含める

このドキュメントでは、お使いのフレームワーク用のJVMに-javaagent引数を渡す方法を説明します。このインストール手順に従うと、アプリケーション内にエージェントを確実に含めることができます。すべてのアプリケーションサーバーに対して、newrelic.jarファイルへのフルパスを渡すようにしてください。

このドキュメントは、単に引数の渡し方を説明するための参考資料です。詳細なインストール手順については、「Javaエージェントのインストレーション」をご覧ください。

ヒント

Javaなどのエージェント、およびその他のオブザーバビリティ プラットフォームを使用するには、New Relicファミリーに参加してください。サインアップして、わずか数秒で無料アカウントを作成できます。次に、毎月最大で100GBのデータを無料で取り込みます。期間無制限です。

Coldfusion

Coldfusionで-javaagent引数を渡すには、次の手順を実行します:

  1. ColdFusionサーバーを起動して、ColdFusionアドミンコンソールに移動します。

  2. 左側のメニューから、SERVER SETTINGS > Java and JVM を選択します。

  3. エージェントAPIを使用している場合:ColdFusion Class Pathフィールドでnewrelic-api.jarへのパスを指定します。

  4. JVM Argumentsフィールドに-javaagent引数を追加します:

    -javaagent:/full/path/to/newrelic.jar
  5. 変更の送信を選択し、ColdFusionサーバーを再起動します。

Geronimo

Geronimoで-javaagent引数を渡すには、startup コマンドを実行するときに、JAVA_OPTS環境変数内のNew Relic agent jarを参照します:

export JAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar" && geronimo run

Glassfish

Glassfishで-javaagent引数を渡すには、次の手順を実行します:

  1. Glassfishのコンソールから、Application Server > JVM Settings > JVM Optionsを選択します。

  2. JVMオプションページで、Add JVM Optionを選択します。

  3. -javaagentエージェントに対してエントリを追加します:

    -javaagent:/full/path/to/newrelic.jar
  4. 保存してGlassfishを再起動します。

Glassfishが起動しない場合は、-javaagent引数が正しく設定されていない可能性があります。サーバーJVM引数は、domain.xmlファイルを編集することで変更できます。

重要

Glassfish 2.1のバグにより、ブートストラップクラスローダーが読み込んだクラス(New Relicエージェント)ではJavaロギングAPIを使用できません。この問題は、2.1.1以上のリリースでは修正されているようです。

Grails

Grailsで-javaagent引数を渡すには、次の手順を実行します:

JBoss

JBossで-javaagent引数を渡すには、次の手順を実行します:

Jetty

Jettyで-javaagent引数を渡すには、次の手順を実行します:

Play

Playで-javaagent引数を渡すには、次の手順を実行します:

Resin

Resinで-javaagent引数を渡すには、この引数をresin.confまたはresin.xmlファイルの<jvm-args>セクションに追加します:

<jvm-arg>-javaagent:/full/path/to/newrelic.jar</jvm-arg>

Solr

Solrで-javaagent引数を渡すには、次の手順を実行します:

Spring Boot

Spring Bootで-javaagent引数を渡すには、アプリケーションを起動するコマンドラインに、この引数を追加します。この引数は必ず-jar引数の前に追加するようにしてください:

java -javaagent:/full/path/to/newrelic.jar -jar app.jar

Tanuki Wrapper

Tanuki Wrapperで-javaagent引数を渡すには、wrapperオプションをwrapper.confに追加します。以下の行で、このファイル内の未使用の番号をXXXに置き換えます:

wrapper.java.additional.XXX=-javaagent:/full/path/to/newrelic.jar

ヒント

Linuxシステムでは、この値を設定する際に引用符を使う必要はありません。この挙動は、他のオペレーティングシステムでは異なる場合があります。

Tomcat

Tomcatで-javaagent引数を渡すには、次の手順を実行します:

WebLogic

WebLogicで-javaagent引数を渡すには、次の手順を実行します:

WebSphere

WebSphereで-javaagent引数を渡すには、次の手順を実行します:

  1. アドミンコンソールから、Servers > Application servers > (サーバーを選択) > Configuration > Service Infrastructure > Java and Process Managementを選択します。

  2. Process Definition > Additional Propertiesを選択し、Java Virtual Machineを選択します。

  3. Generic JVM argumentsフィールドに、newrelic.jarファイル用の-javaagent引数を追加します:

    -javaagent:/full/path/to/newrelic.jar
  4. 適用 を選択し、保存を選択します。

  5. サーバーを再起動します。

詳細については、「WebSpherePMIメトリックスの収集」に関するドキュメントをご覧ください。

WebSphere Community

WebSphere Community Editionで-javaagent引数を渡すには、startupコマンドを実行するときに、JAVA_OPTS環境変数でNew Relic エージェントのjarを参照します:

export JAVA_OPTS="$JAVA_OPTS -javaagent:/full/path/to/newrelic.jar" && startup

WebSphere Libertyプロファイル

WebSphere Libertyプロファイルで-javaagent引数を渡すには、次の手順を実行します:

  1. ${server.config.dir}/jvm.optionsを編集します。

  2. newrelic.jarファイルをポイントするように-javaagent引数を追加します。

    -javaagent:/full/path/to/newrelic.jar
  3. サーバーを再起動します。

Wildfly

Wildflyで-javaagent引数を渡すには(Wildfly 11以降をお使いの場合は、追加のインストール手順を参照):

その他のアプリケーションサーバー

New Relic Javaエージェントは任意のサポート対象のアプリケーションサーバーで動作します。お使いのアプリケーションサーバーがこのドキュメントに記載されていない場合、お使いのアプリケーションサーバーの標準的な手順に従い、この引数をアプリケーションjarより前にJVMに渡すようにしてください。

-javaagent:/full/path/to/newrelic.jar

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:

問題を作成するこのページを編集する
Copyright © 2020 New Relic Inc.