New Relic APMをintra-martに導入してみよう

Last updated at 2025-07-02Posted at 2025-07-01

New Relic APMはアプリケーションのパフォーマンスやエラーをリアルタイムに観測し、システム障害やユーザー体験の低下につながる原因の特定と解決を支援します。この記事ではNTTデータイントラマート社の intra-mart にNew Relic APMを導入してみます。

New Relic APMの概要について理解されたい方は以下の記事をご確認ください。

intra-martにNew Relic Browserを導入する解説記事もありますので、こちらもぜひ導入してみてください。

はじめに

New Relic APMは様々な開発言語やアプリケーションサーバに導入することができます。
intra-martはJavaで開発されています。また、intra-martはいくつかのアプリケーションサーバでの動作に対応していますが、今回はよく利用される Resin にNew Relic APMの Java Agent を導入してみます。

今回導入する環境

New Relic APM
- Java Agent v8.21.0
intra-mart
- OS: Amazon Linux 9.4
- JDK: Amazon Corretto 17.0.12
- AP Server: Resin 4.0..66

New Relic APMの導入

intra-martにNew Relic APMのJava Agentを導入してみましょう。

[+Integrations & Agents]を選択し、"java" を検索して表示される Java のアイコンをクリックします。
Java Agentのインストール方法として、今回は [On a host] を選択します。
インストールで使用する [license key] と [user key] を指定します。
インストール先のOSとして [Linux] を選択します。
画面の指示にしたがい、インストールされているJavaがサポートされているバージョンであることを確認します。
「③ Choose your framewark」で [Resin] を選択します。
「Choose your download option」では画面の指示にしたがいます。
1. Javaエージェント(zipファイル)のダウンロード
2. ダウンロードしたzipファイルを任意のディレクトリにコピー
3. zipファイルの展開
  ※ 本記事では /opt/newrelic に展開されたこととします
4. New Relic APMに表示されるアプリケーション名を入力
5. Java Agentの設定ファイル(newrelic.yml)をダウンロードし、zipファイルを展開したディレクトリにコピー
Javaのバージョンとして [Java 9 or later] を選択します。
Java Agentを起動する方法が例示されます。

resin.properties の jvm_args に -javaagent:/\<PATH>/newrelic.jar の引数を追加してください。
また環境によっては「NoClassDefFoundError: java/sql/SQLException」例外によってJava Agentが起動しない場合があります。この場合は jvm_args に -Dnewrelic.config.sql.platformClassloader=false を追加してください。このパラメータでjava.sqlのクラスローダーのロードを無効にします。
resin.propertiesの例
```
# Arg passed directly to the JVM
# Tuned by NTTDATA INTRAMART
# jvm_args  : -Dfile.encoding=UTF-8 -Xmx4096m
# jvm_mode    : -server
jvm_args : -javaagent:/opt/newrelic/newrelic.jar -Dnewrelic.config.sql.platformClassloader=false -Dfile.encoding=UTF-8 -Djava.io.tmpdir=tmp.....
```
intra-martを再起動します。
Infrastructure Agentのインストールのステップが表示されますが、今回はスキップします。
Visual Studio CodeなどIDEとAPMの計測データを連携できるCodeStreamという機能の連携を求められますが、今回はスキップします。
intra-martにアクセスし、トランザクションを発生させたあとに [Test connection] をクリックして計測したデータが取得できていることを確認します。