New Relic Javaエージェントは、newrelic.ymlファイルから設定を読み取ります。デフォルトで、エージェントは、newrelic.jarを含むディレクトリでこのファイルを検索します。newrelic.config.fileシステムプロパティを完全修飾ファイル名に設定して、設定ファイルの場所を上書きできます。
New Relicアカウントを作成（永久無料）し、Javaエージェントをインストールした後、環境に合わせてJavaエージェントを設定することができます。
設定ファイルの構成
newrelic.ymlファイルには、次の異なる環境ごとに個別のセクションがあります。
- テスト
- 開発
- ステージング
- 本番環境（デフォルト）
New Relicは、commonセクションの設定を、これらの各環境に適用します。newrelic.environmentシステムプロパティを環境名に設定して、デフォルトとしてその他の環境を選択できます。
ヒント
newrelic.ymlテンプレートが利用可能です。
newrelic.ymlを編集する場合、YAML形式に従うよう注意してください。New RelicのJavaエージェントで使用する前に、YAMLバリデータを使用して構文が正しいことを確認し、以下の規則に従ってください。
Java agent newrelic.yml | Requirements |
|---|---|
形式 | YMLファイルには、大文字と小文字の区別があります。 |
インデント | すべてのインデントは、2文字の空白にする必要があります。その他のインデントにすると、エージェントの起動時に
|
ファイルの変更 | 変更を有効にするには、JVMホストプロセスを再起動する必要があります。 Exception: |
設定の優先順位
設定ファイルで設定を上書きするには、システムプロパティの上書きを使用します。環境によっては、環境変数を使用して、設定ファイルとシステムプロパティの両方を上書きすることもできます。環境変数は主に、Herokuをサポートするために存在します。使用すると、サーバーサイドコンフィグレーションが、その他すべての設定を上書きします。
Javaエージェントでは、サーバーサイドコンフィグレーションが、その他すべての設定を上書きします。環境変数は、Javaシステムプロパティを上書きします。Javaプロパティは、お使いのnewrelic.ymlファイルのユーザー設定を上書きします。ユーザー設定は、newrelic.ymlデフォルト設定を上書きします。
Javaエクステンションディレクトリの設定
Javaエージェントは、プロセスの開始時に設定ファイルを読み込みます。ファイルのあるディレクトリを特定するには、新規のディレクトリを作成するか、既存のエクステンションディレクトリを指定します。
設定インデックス
以下のページには、各設定エリアの完全な設定リファレンスが記載されています。
| 設定ページ | 説明 |
|---|---|
| 全般設定 | コア設定：ライセンスキー、アプリ名、プロキシ、高セキュリティ、拡張機能 |
| トランザクショントレーサー設定 | トランザクショントレーシング、SQLキャプチャ、トランザクションイベント、セグメント、メッセージトレーサー |
| エラーコレクター設定 | エラー収集、無視/予期されるクラスとステータスコード、Errors Inbox |
| ディストリビューティッド（分散）トレースの設定 | ディストリビューティッド（分散）トレーシング、無限トレーシング、スパンイベント、クロスアプリケーショントレーサーサー |
| Logs in Context設定 | ログ転送、ログメトリクス、ローカル装飾、ロギング設定 |
| 属性の設定 | 属性フィルタリング、包含/除外リスト、HTTP属性モード |
| セキュリティ設定 | IASTセキュリティエージェント、脆弱性検出設定 |
| AI監視設定 | AI監視とLLMコンテンツ記録 |
| ブラウザ監視の設定 | Browserエージェントの自動インストゥルメンテーションと属性の設定 |
| 非同期インストゥルメンテーション設定 | 非同期トークンとセグメントタイムアウトの設定 |
| OpenTelemetry設定 | OpenTelemetryトレース、メトリクス、ログのシグナル設定 |
| JFR設定 | Java Flight Recorderのリアルタイムプロファイリング |
| Class transformer設定 | Springトランザクション命名、トレースアノテーション、Lambdaトランザクション |
| JMX設定 | JMXの監視とメタデータのリンク |
| その他の設定 | サーキットブレーカー、クラウド設定、使用率、カスタムイベント、jarコレクター、JVM難読化、スレッドプロファイラーなど |
重要
設定が必要な2つの項目は、アプリ名とライセンスキーです — newrelic.ymlのapp_nameおよびlicense_key（または環境変数NEW_RELIC_APP_NAMEおよびNEW_RELIC_LICENSE_KEY）を使用して設定します。その他のすべての設定はオプションです。