GAEフレキシブル環境にJavaエージェントをインストールする

このページでは、カスタムDockerランタイムを使用して、Google App Engine（GAE）フレキシブル環境にNew Relic Javaエージェントをインストールする方法について説明します。

互換性と要件

サポート対象

• Java 8、11、17、21、24、25、および26 （Java 7はエージェントv6.5.4以前でのみサポートされています）
• カスタムDockerランタイムを備えたGoogle App Engineフレキシブル環境
• サポートされているフレームワークおよびライブラリのバージョン範囲については、互換性および要件を参照してください

サポートされていない

• GAEスタンダード環境 — カスタムランタイムが必要です；スタンダード環境はこれをサポートしていません。
• GAEネイティブモード — Javaエージェントにはカスタムランタイムが必要です
• 他のAPMエージェントとの並行稼働 — 同じJVM内で別のAPMエージェントがアクティブな場合、Javaエージェントは正しい動作を保証できません。

必要なこと

• New Relicアカウントおよびライセンスキー
• SHA-2（256ビット）SSLをサポートするJVM
• App Engine アプリケーションが作成された Google Cloud Platform プロジェクト（Java 向け Google App Engine の手順を参照）
• gcloud CLI がインストールおよび初期化されていること（Google Cloud SDK ドキュメントを参照）
• App Engine プラグインが構成された Maven または Gradle

インストール

newrelic-java.zip をダウンロードし、プロジェクトに解凍してください：[#install-step-1]

$
curl -O https://download.newrelic.com/newrelic/java-agent/newrelic-agent/current/newrelic-java.zip
$
unzip newrelic-java.zip

カスタムランタイム用にapp.yamlを設定してください：

runtime: custom
env: flex

エージェントを追加し、-javaagent 引数を渡すように Dockerfile を設定します。以下の例ではTomcatを使用しています：

ADD ./newrelic/newrelic.jar /usr/local/tomcat/newrelic/newrelic.jar
ENV JAVA_OPTS="$JAVA_OPTS -javaagent:/usr/local/tomcat/newrelic/newrelic.jar"

プロジェクトをビルドします：

$
mvn clean install

設定

newrelic/newrelic.ymlを編集して、2つの必要な値を設定します：

1. license_keyをライセンスキーに設定してください。
2. app_nameにアプリケーションのわかりやすい名前を設定してください。

その他のすべての設定オプションについては、Javaエージェント設定を参照してください。

インストールの確認

GAEへのデプロイ：

$
gcloud --project YOUR_PROJECT_NAME app deploy

デプロイメントが完了するまで待ちます。少なくとも2つのrequestsを送信し、その後2～3分待つと、アプリがAPM & サービスに表示されます。

5分経過してもデータが表示されない場合は、データが表示されない（Java）を参照してください。

関連記事

• Javaエージェントの互換性と要件
• Javaエージェント構成
• Java向けGoogle App Engineドキュメント