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

Java用New Relicの概要

New RelicのJavaエージェントを使用すると、コード内のパフォーマンスの問題から小さなエラーまですべてを追跡できるようになります。エージェントは1分ごとにメトリックタイムスライスとイベントデータをNew Relicのユーザーインタフェースに載せます。該当するデータの所有者(オーナー)はインタフェースにサインインしてデータを使用し、ウェブサイトのパフォーマンスを確認することができます。

ヒント

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

インストレーション

Javaエージェントを使用するには:

  1. お使いのシステムがJavaエージェントの互換性要件を満たしていることを確認してください。
  2. New Relic アカウントにサインアップします。
  3. ランチャーを使用して、または次の標準的なインストレーション手順に従ってJavaエージェントをインストールします。ご利用のツールやフレームワークに応じて、追加のインストール手順を参照してJavaエージェントのインストレーションや設定を行います。
インストールドキュメントを読む
Javaデータを追加

New Relic UI でアプリケーションのパフォーマンスを表示するには: https://one.newrelic.com> (アプリケーションを選択) > Summaryの順に移動します。APM のユーザーインタフェースには専用のJVMメトリックスページトランザクションエラー情報、スレッドプロファイラツールが含まれており、Javaスレッドの標本化やスタックトレースのレポートなどを行うことができます

また、エージェントインストゥルメンテーションを拡張し、New Relic Oneのデータエクスプローラーダッシュボードなどの他のNew Relic製品を使ってデータを調査することもできます。

起動設定

Javaエージェントは、newrelic.jarと同じディレクトリにある必要がある、newrelic.ymlファイルからスタートアップ設定を読み込みます。また、Javaシステムのプロパティを使用して設定を上書きすることもできます。

エージェントは、スタートアップ(ブートストラップ)時に、license_keyapp_nameの設定を必要とします。ログファイルの場所、およびその他設定は、newrelic.ymlファイルでカスタマイズできます。また、アプリケーションサーバーが同一のJVMで複数のアプリケーションを実行している場合は、命名設定を調整することができます。

設定オプション

New Relic ウェブインタフェースからアプリケーションのレポーティングをサーバーサイドコンフィグレーションを使用して設定できます。変更内容はJVMを再起動した際にアプリケーションをレポートするすべてのエージェントに適用されます。ただし、サーバーサイドコンフィグレーションを使用する場合は、引き続き必要な設定(license_keyapp_name)をローカル設定ファイルに保持する必要があります。

トランザクションのトレースとエラーのスナップショットの両方で、HTTP パラメーターを記録することもできます。HTTPパラメーターには、クレジットカード番号のような機密情報が含まれる場合があります。エージェントには特定の名前を持ったパラメーター以外のHTTPパラメーターを収集するような、データセキュリティを確保するための設定オプションが複数存在します。

追加のインストゥルメンテーション

Javaエージェントをインストール後、以下のいずれかの方法を使用してインストゥルメンテーションを拡張できます。

JVMの再起動タイミング

設定ファイルやカスタムXMLに変更を行った場合は、ほぼすべての場合においてJVMを再起動する必要があります。再起動が不要なのは、以下の4つの場合に限定されます。

JVMの再起動は次の場合に不要です。

コメント

ログレベルや監査モードの変更

Javaエージェント設定ファイルlog_levelまたはaudit_modeを単に変更する場合は、JVMを再起動する必要はありません。

カスタムインストゥルメンテーションXMLファイルの変更

JVMを再起動するかどうかは、お使いのJavaエージェントのバージョンによります。

  • 3.15.0以降:extensionsフォルダ内のカスタムインストゥルメンテーションXMLファイルを更新する場合、更新内容は1分以内に自動的に再読み込みされます。
  • Javaエージェントのバージョン3.15.0以前:バージョン3.15.0以前のエージェントを使用している場合は、JVMを再起動する必要があります。

ブレーカーの変更

Javaカスタムインストゥルメンテーション用のブレーカーを変更する場合は、JVMの再起動は不要です。

無視された、または想定済みのエラー

newrelic.ymlファイルを設定してエラーを無視または想定している場合は、JVMを再起動する必要はありません。これには、バージョン3.40.0以降のJava エージェントを使用している場合に、newrelic.ymlファイルにステータスコードまたはクラスを追加することが含まれます。例えば:

  • ignore_status_codes
  • expected_status_codes
  • ignore_classes
  • ignore_messages
  • expected_classes
  • expected_messages

その他すべての変更についてはエージェントの再起動、つまりJVMの再起動が必要です。

JSR 163準拠

New Relic Javaエージェントはウェブのトランザクションを監視し、その情報を受信し、強力なデータセキュリティ対策を施したNew Relicのユーザーインタフェースにその情報を伝達します。このエージェントは、JVMの起動処理を変更することでJVMによってアクティブ化される、JSR 163準拠のjavaagentとしてパッケージ化されています。有効化されると、エージェントは自身をクラス読み込み処理の中に組み込み、バイトコード・インストゥルメンテーション(BCI)を使用してクラスメソッドをインストゥルメントします。

Webアプリケーションへの影響を最小限に抑えるように設計されたクラスはすべて、ユーザー独自クラスと衝突しないように、newrelicパッケージネームスペースに存在します。このエージェントは、ソフトウェアプローブの挿入にASMのbciエンジンを使用します。

このエージェントは、オペレーティングシステム、Javaのバージョン、システムのプロパティ、New Relicの設定ファイルなど、使用中のホスト環境に関する基本的な情報を受信します。また、このエージェントはJVMとJMXからデータをポーリングします。

トラブルシューティング手順

Javaエージェントに問題が発生した場合は、トラブルシューティング関連ドキュメントをご覧ください。

その他のヘルプ

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

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