PHPエージェントには、レポートされたデータのタイプと量を微調整するための多くの設定があります。ほとんどのユーザーにとっては、デフォルト値で最善のオーバーヘッドと使用しやすさが実現されます。ただし、特定のニーズに対する設定は変更できます。
以下の簡単な図は、PHPエージェントが設定で従う優先度です。サーバー側の設定 には適用されません。PHPエージェントを使用してアプリのUIで変更できる唯一の値は、アプリのエイリアスとApdex-T値です。
New RelicのPHPエージェントを使用すると、API設定はディレクトリごとの設定 を上書きします。ディレクトリごとの設定は、php.iniファイル設定を上書きします。サーバー側の設定には適用されません。
インストール中、newrelic-installnewrelic.iniという名前の設定ファイルを作成しようとします。
場合によっては、設定オプションをphp.iniファイルに追加するよう指示されます。必要に応じて、そうしてください。どのファイルを編集する必要があるかは、PHPの特定のバージョン（1つまたは複数）が設定されている方法によって異なります。
2つの最も一般的な設定は、次のとおりです。
単一のnewrelic.iniファイルを使用します。特別のオプションなしでPHPを自分でインストールまたはコンパイルした場合は、これが通常デフォルトとなります。 すべての.iniファイルについて所定のディレクトリをスキャンします。 どのファイルを編集するか分からない場合：
コマンドラインから、php -iの出力を見直します。
ブラウザで、次のスクリプトを含むページの出力を見直します：
newrelic.iniファイルが表示されたら、それを使用します。
newrelic.iniファイルの各変数には、定義された範囲があります。範囲は、設定をどこで確立または変更できるかを制御します。
New Relic設定にサポートされている2つの範囲は、次のとおりです。
SYSTEM ：値はグローバルnewrelic.iniファイルでグローバルに設定されます。PERDIR : 値はディレクトリごと に設定されます。それぞれを、より一般的なレベルで設定することもできます。それぞれの有効なロケーションは、次のとおりです。
以下について設定できます。
SYSTEM
PERDIR
グローバルnewrelic.iniファイルで設定します。
ディレクトリごとに設定します。
重要 New Relic設定に、ini_set()は使用できません。
newrelic.iniファイルの各変数には、定義されたタイプがあります。タイプによって使用する値の構文が指定されます。
変数のタイプ
フォーマットと内容
文字列
文字列値には、英数字とピリオドを含めることができます。値は引用符で区切られます。
ブール値
論理的な真偽設定。有効な値は、次のとおりです。
trueまたはenabledの場合：on、true、番号1。 falseまたはdisabledの場合：off、false、番号0。 数
数値には、桁数に加え、フロートを表すピリオドのみを含めることができます。別途記載がある場合を除き、すべての数字はフロートではなく整数です。
期間
期間を表す、引用符で区切られた文字列の値。文字フラグを使用して、時間コンポーネントを区切ります。フラグがない場合、時間はミリ秒となります。
これらの設定は、newrelic.iniファイルで使用できます。
newrelic.appname （強く推奨） 範囲：
PERDIR
タイプ：
文字列（引用符を使用）
デフォルト：
"PHP Application"
この設定オプションで、APMでデータがレポートされるアプリケーション名が設定されます。混同や非意図的なデータの集計を避けるために、デフォルト名を分かりやすい名前に置き換えることを強く推奨します。同じ名前のすべてのアプリケーションのデータは、New Relicにマージされるため、この設定は慎重に行ってください。
ディレクトリごとの設定を含むすべてのアプリケーション命名オプションについては、PHPアプリケーションの命名 を参照してください。
設定の値は、最大で3つのアプリケーション名をセミコロンで区切ったリストです。リストの最初の名前は、主たる アプリケーション名です。各アカウントに一意でなければなりません 。アプリケーション名は、キャッシュへのキーとして使用されます。アプリに複数の名前 を使用する場合、New Relicはキャッシングに最初の名前のみを使用します。したがって、各アプリケーション名は、最初の要素として一度 しか表示されません。
キャッシング例 newrelic.appname="App1;App2"を設定し、後でコードセットnewrelic.appname="App1;App3"で設定すると、2番目のコードが機能しなくなります。キャッシングのため、App1 とApp2 にレポートします。
アプリケーション名を重複 させる必要がある場合は、共通のアプリケーション名を第二または第三の位置に設定します。例：newrelic.appname="App2;App1"とnewrelic.appname="App3;App1"。たとえば、アプリケーションのスーパーセットを追跡する場合にこれは有用です。
newrelic.capture_params 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
false
注意 この設定は非推奨となっており、想定どおりに動作しない場合があります。代わりに、属性プロパティ を使用します。
この値をプログラムで設定するには、newrelic_capture_params()
機密情報をURLで直接渡す場合は、これを無効にしてください。
trueに設定すると、トランザクショントレースでURL（URLの?の後のすべて）を介してPHPスクリプトに渡されたパラメーターの記録が有効になります。これらは、トランザクショントレースを表示すると、パラメーター ドロップダウンに表示されます。
newrelic.framework 範囲：
PERDIR
タイプ：
文字列（引用符を使用）
デフォルト：
（自動検出）
New Relic PHPエージェントは、サポートしているフレームワークは自動的に検出しますが、実験的な新バージョンを使用している、またはフレームワークをカスタマイズしている場合は、問題が発生することがあります。この設定では、エージェントに指定のフレームワークに従いトランザクションに名前を付けるよう指示するのではなく、フレームワークの自動検知は無効になります。
"no_framework"を指定すると、フレームワーク関連のトランザクションのネーミングがすべて無効になります。
必要に応じて、次の値のいずれかを使用します。
"cakephp"
"codeigniter"
"drupal" （Drupal 6および7の場合）
"drupal8"
"joomla"
"kohana"
"laravel"
"magento"
"magento2"
"mediawiki"
"silex"
"symfony1"
"symfony2" （Symfony 2および3の場合）
"symfony4" （Symfony 4および5の場合）
"wordpress"
"yii"
"zend"
"zend2" （Zendフレームワーク2および3の場合）
"no_framework" （1つが検出された場合でもフレームワークを強制しない）
フレームワークの自動検知に失敗すると、このコマンドも失敗します。
newrelic.ignored_params 範囲：
PERDIR
タイプ：
文字列（引用符を使用）
デフォルト：
""
注意 この設定は非推奨となっており、想定どおりに動作しない場合があります。代わりに、属性プロパティ を使用します。
newrelic.ignored_params設定を使用して、New Relic Serversに送信されたパラメーターのリストから除外されるパラメーター名のカンマ区切りされたリストを指定します。引用符で文字列の値を囲います。
newrelic.capture_params
newrelic.license （必須） 範囲：
PERDIR
タイプ：
文字列（引用符を使用）
デフォルト：
""
メモ：
エージェントバージョン3.0で導入されました。
使用するNew Relicライセンスキー を設定します。マルチテナントシステムでは、これはディレクトリごとに設定できます。
ヒント 旧エージェントバージョンから3.0以上にアップグレードすると、ライセンスは（理由を説明するコメントとともに）デーモン設定ファイルから削除され、ファイル/etc/newrelic/upgrade_please.keyに保存されます。そのファイルからライセンスをコピーし、newrelic.iniファイルに設定します。upgrade_please.keyファイルを削除します。
newrelic.loglevel 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
"info"
ログファイルに送信されたメッセージの詳細レベルを設定します。詳細度が低い順での可能な値は、次のとおりです。
error
warning
info
verbose
debug
verbosedebug
エージェントの問題をNew Relicテクニカルサポートに報告する場合は、verbosedebugが最も有用な設定です。ただし、これにより多くの情報が非常に迅速に生成されるため、発生している問題の再現にかかる時間以上に、verbosedebugレベルでエージェントを保存しない
エージェントの問題をNew Relicテクニカルサポートに報告する際、これをカスタムレベルに設定し、特定のサブシステムについてのみデバッグを有効にするよう求められる場合があります。カスタムレベルは本ドキュメントの範囲外です。
newrelic.transaction_tracer.detail 範囲：
PERDIR
タイプ：
数
デフォルト：
1
メモ：
これは以前はnewrelic.transaction_tracer.top100でした。
トランザクショントレースで詳細のレベルを設定します。
1に設定すると、すべてのサーバーの呼び出しがトレースされます。
0に設定すると、トレースにはNew Relicにより内部でインストゥルメントされた呼び出しと、newrelic.transaction_tracer.custom
デフォルトのレベル1は、パフォーマンスに影響を与えます。パフォーマンスを改善する必要がある場合、詳細レベルを0に設定するようにしてください。
すべてのサーバーの呼び出しをトレースしていない場合、トランザクショントレースの時間のブロックにはインストゥルメントされていない時間 とラベルが付けられ、特定の関数（エージェントにより内部で定義）のみがインストゥルメントされます。すべての呼び出しをレポートする場合でも、トレースにインストゥルメントされない時間 がある場合があります。
newrelic.high_security 範囲：
SYSTEM
タイプ：
ブール値
デフォルト：
false
すべてのアプリケーションについて高セキュリティを有効にします。高セキュリティをtrueに設定すると、次の動作が有効になります。
newrelic-daemonが安全な接続（HTTPS）を使用している場合を除き、データはNew Relicに送信されません。PHPプロセスがnewrelic-daemonを作成する場合、newrelic.daemon.sslの値にかかわらずHTTPSを使用するよう設定されます。
行のクエリ文字列は、newrelic.transaction_tracer.record_sqlの値にかかわらず収集されることはありません。
リクエスト属性は、newrelic.attributesの設定にかかわらず取得されることはありません。
newrelic_add_custom_parameternewrelic_set_user_attributesfalseを返します。
newrelic_record_custom_eventNew Relic にイベントを送信しません。
エージェントはエラーから例外メッセージを除去します。
注意 newrelic.high_security設定を変更する場合、APMユーザーインタフェースでセキュリティ設定も 変更する必要があります。2つの設定が一致しない場合、データは収集されません。詳細については、高セキュリティ を参照してください。
newrelic.labels 範囲：
PERDIR
タイプ：
文字列（引用符を使用）
デフォルト：
""
タグ を追加します。
タグの例
"Server:One;Data Center:Primary"
newrelic.process_host.display_name 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
""
APM UIに表示される . ホスト名を設定します。設定すると、エージェントが自動的に取得するデフォルトのホスト名が上書きされます。
New Relic APMとCodeStreamを使用している場合は、リポジトリを関連付ける方法 と、ビルドSHAまたはリリースタグをエラー受信トレイに関連付ける方法 をご覧ください。
これらの設定の値は、デーモン起動を制御します。デーモンの起動が必要なことをエージェントが検知すると、これらのオプションが、デーモンに適切なコマンドラインオプションに変換します。
これらのすべての設定は、newrelic.cfgファイルの設定を反映します。すべての .ini設定を1か所に保管するため、これらはここで繰り返されます。newrelic.cfgの各設定ではここに、プレフィックスとしてnewrelic.daemon.が付いた相手があります。たとえば、newrelic.cfgのssl設定は.iniファイルのnewrelic.daemon.sslです。
重要 ファイル/etc/newrelic/newrelic.cfgがある場合、エージェントはこれらの設定を無視し、デーモンを自動的に起動しません 。
デーモンの起動方法および外部設定ファイルをいつ使用するかの詳細については、PHPデーモン起動モード を参照してください。
newrelic.daemon.app_timeout 範囲：
SYSTEM
タイプ：
時間仕様文字列は、たとえば、"5m"または "1h20m"
デフォルト：
"10m"
アプリケーションが非アクティブと見なされてからの経過時間を設定します。非アクティブアプリケーションは、アプリケーションの上限250にはカウントされません。許容単位は"ns"、"us"、"ms"、"s"、"m"、および"h"です。
値0は、「タイムアウトなし」と解釈されます。これにより、新規アプリケーションは常にアプリケーションの上限250に対しカウントされ、デーモンはアプリケーションごとに少量のメモリをオペレーティングシステムに解放できなくなります。
推奨: New Relic Supportの要請がある場合を除き、この値は使用しないでください。代わりに、時折行われるバックグラウンドトランザクションには、間隔の2倍の値を使用してください。たとえば、1時間ごとのバックグラウンドジョブでは、タイムアウトを2時間に設定します。
newrelic.daemon.app_connect_timeout 範囲：
SYSTEM
タイプ：
時間仕様文字列は、たとえば、"1s"または "5m"
デフォルト：
"0"
アプリケーションに接続するデーモンに対する、エージェントの最大待ち時間を設定します。値が0の場合、エージェントはデーモンへの接続を1回しか試みません。許容単位は"ns"、"us"、"ms"、"s"、"m"、および"h"です。
このタイムアウトが設定されていると、デーモンがまだバックエンドに接続していない場合、エージェントはただちにトランザクションを停止せず、デーモンに接続を確立する時間を許可します。
推奨： タイムアウトを設定する場合、推奨値は15sです。接続に問題がある場合、エージェントはすべてのトランザクション開始時に所定のタイムアウトをブロックするため、時間のかかるバックグラウンドタスクのインストゥルメントをしている場合にのみこのタイムアウトを設定してください。
newrelic.daemon.auditlog 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
""
設定では、監査ログの名前を指定します。ログには、完全なURL、日付、時間、各リクエストのエンコード化されていない非圧縮データを含む、デーモンからNew Relicサーバーに送信されたすべてのデータが含まれます。
このファイルは、デーモンのログと同じファイルにはできません。
重要 この監査ログは、非常に短時間で非常に大きくなる場合があります。長期間newrelic.daemon.auditlog設定を使用しないようにしてください。システムアドミニストレーターがセキュリティレビューを行い、どのデータが転送されるかを正確に観察できるようにすることが、主な目的です。
newrelic.daemon.collector_host 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
"collector.newrelic.com"
ライセンスキーの確認およびエージェントデータの送信のためにデーモンが連絡するコレクターホストの名前とオプションのポートを設定します。
これは、単にホストの名前または"hostname:port"形式のポート番号のいずれかです。 ポート番号0を指定すると、デフォルトポート80を使用します。
注意 New Relic Supportからのガイダンスなしに、この値を変更しないでください。
newrelic.daemon.dont_launch エージェントの起動前にデーモンを外部で起動したい場合は、この値により、エージェントがデーモンの起動をいつ許可されるかが決まります。
0：デーモンの起動には制限はなく、エージェントはデーモンをいつでも起動できます。
1：非コマンドライン（Apacheやphp-fpmなど）エージェントは、デーモンを起動できます。
2：コマンドラインエージェントのみが、デーモンを起動できます。
3：このエージェントはデーモンを起動することはありません。newrelic.cfgを介してデーモンを設定しており、エージェント以外から起動している場合は、この設定を使用します。
重要 /etc/newrelic/newrelic.cfgがある場合、エージェントは、エージェントを介してではなく、起動スクリプトによりデーモンが起動されるものと仮定します。この設定は、newrelic.cfgに影響を与えず、そこに表示されません。
newrelic.daemon.location 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
"/usr/bin/newrelic-daemon"
起動可能なデーモンの名前を設定します。
この変数は、デーモンが実行可能なファイルへのフルパスを特定します。標準パッケージを使用してNew Relicシステムがインストールされた場合、デフォルトの場所は正しいものとなります。tar配布を使用してカスタムの場所にインストールした（かつ/usr/binへの書き込み許可がない）場合、デーモンは別の場所にある場合があります。
この設定はPHPにのみ関連しているため、newrelic.cfgファイルには表示されません。
重要 OpenSolarisでは、/usrは多くの場合読み取り専用ファイルシステムです。OpenSolarisのデフォルトのデーモンの場所は/opt/newrelic/bin/newrelic-daemonです。
newrelic.daemon.logfile 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
"/var/log/newrelic/newrelic-daemon.log"
デーモン固有のログメッセージを記録するためのログファイルの名前を設定します。デーモンがこのファイルに書き込める必要があります。一般的には、Apacheユーザーの場合、Apache自体が起動するとデーモンが起動されるため、Apacheプロセスを実行しているユーザーがファイルに書き込みできることを確認してください。
注意 デーモンのログファイルに書き込みできない場合は、デーモンは自動的に起動せず、データのレポートは行われません。
誰がデーモンを起動できるかを制限する手段として、このファイルへの書き込み許可を使用できます。
newrelic.daemon.loglevel 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
"info"
New Relicのデーモンのログファイルに記録されるメッセージの詳細レベルを設定します。詳細の度合いが低い順の、可能な値は次のとおりです。
newrelic.daemon.pidfile 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
（OSにより異なります）
デーモンがプロセスID（pid）を記録するファイルの名前を設定します。
このファイルは、デーモンがすでに実行中かどうか判断するため、デーモン起動とシャットダウンスクリプトが使用します。
newrelic.daemon.address（newrelic.daemon.portのエイリアス） 範囲：
SYSTEM
タイプ：
文字列または数字
デフォルト：
"@newrelic" on Linux, "/tmp/.newrelic.sock" otherwise
ヒント v9.2.0.247 から、PHPエージェントは新たな設定であるnewrelic.daemon.address,をサポートします。この設定は、newrelic.daemon.portのエイリアスとなるものです。New Relic PHPデーモンの場所を指定する場合にも使用できます。両方の値が設定された場合、newrelic.daemon.addressが優先されます。
エージェントからデーモンへの通信用にソケットエンドポイントが設定されます。
これは4つの方法で指定できます。
UNIXドメインソケット（UDS）として指定されたファイルを使用するには、文字列として絶対 パス名を入力します。これが、Linux以外のシステムではデフォルトです。
標準のTCPポートを使用するには、1から65534の範囲で数字を指定します。
抽象ソケットを使用するには、値@newrelic-daemon（エージェントバージョン5.2.0.141 以上で使用可能）を使用します。これが、Linuxシステムではデフォルトです。
別のホストで実行中のデーモンに接続するには（コンテナ環境 で有用）、この値をhost:portに設定します。ここで、hostはホスト名またはIPを表し、portは有効なポート番号を表します。IPv4とIPv6の両方がサポートされています。これは、エージェントバージョン9.2.0.247以上で使用できます。
注意 エージェントからデーモンに転送されたデータは暗号化されません 。唯一の例外は、データをデーモンに送信する前に行われるSQL難読化 です。当社では、エージェントとデーモンとの間ではプライベートネットワーク接続のみを使用することを推奨しています（これは、エージェントとデーモンが別のホストで実行中の場合にのみ適用されます）。
ポート番号を使用する場合、Unixシステムでは、ポートは1から1023の範囲にあり、デーモンはスーパーユーザーとして実行する必要があります。デーモンが標準以外のポートを使用する場合、この変数は、エージェントがデーモンとの通信に使用するポート番号も設定します。
重要 デーモンについてnewrelic.cfg起動メカニズムを使用中の場合は、この設定とそのファイルのaddress
newrelic.daemon.proxy 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
""
イグレスプロキシとして使用するホストとユーザー認証情報を設定します。
これは、New Relicデータ収集サーバーにアクセスするために、サイトでプロキシが必要な場合にのみ使用します。プロキシ設定に応じて、次のいずれかの形態となります。
hostname
hostname:port
user@hostname
user@hostname:port
user:password@hostname
user:password@hostname:port
proxytype://user:password@hostname:port
別のproxytype が指定されている場合を除き、HTTPのプロキシタイプとなります。その場合、proxytype は、http 、socks4 、socks4a 、socks5 のいずれかにできます。
newrelic.daemon.ssl 範囲：
SYSTEM
タイプ：
ブール値
デフォルト：
true
この設定はPHPエージェントバージョン8.0以上では無視され、常にHTTPSを使用してNew Relicと通信します。
PHPエージェントバージョンが8.0以下の場合、New Relicコレクターとの通信で安全なHTTP接続を使用するかどうかが制御されます。エージェントはデフォルトでHTTPSを介してNew Relicと通信します。New Relicは、 APMとNew Relic REST APIへのすべてのトラフィックにHTTPSを要求 します。
newrelic.daemon.ssl_ca_bundle 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
""
PEM形式のCA証明書を含むファイルの場所を設定します。設定すると、このファイルの証明書を使用して、New Relicコレクターが認証されます。ほとんどの場合、CAバンドの設定は不要です。New Relic PHPエージェントには、必要なCA証明書が同梱されます。
newrelic.daemon.ssl_ca_pathnewrelic.daemon.ssl_ca_pathディレクトリに含まれる証明書が検索されます。
newrelic.daemon.sslfalseに設定されている場合、この設定には影響しません。
newrelic.daemon.ssl_ca_path 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
""
PEM形式の信頼されるCA証明書を含むディレクトリの場所を設定します。設定すると、このディレクトリの証明書を使用して、New Relicコレクターが認証されます。ほとんどの場合、CAパスの設定は不要です。New Relic PHPエージェントには、必要なCA証明書が同梱されます。
また、newrelic.daemon.ssl_ca_bundlenewrelic.daemon.ssl_ca_pathに含まれる証明書が検索されます。
newrelic.daemon.sslfalseに設定されている場合、この設定には影響しません。
newrelic.daemon.start_timeout 範囲：
SYSTEM
タイプ：
時間仕様文字列は、たとえば、"1s"または "5m"
デフォルト：
"0"
デーモン起動がトリガーされた後に、エージェントが待機する必要がある最大時間を設定します。値を0にすると、エージェントは待機しません。許容単位は"ns"、"us"、"ms"、"s"、"m"および"h"です。
指定されたタイムアウト値は、--wait-for-portフラグを介してデーモンに渡されます。これにより、ソケットの取得、またはタイムアウト時間が経過するまで、デーモンの起動がブロックされます。
推奨： タイムアウトを設定する場合、推奨値は2sから5sです。デーモンの起動に問題がある場合、エージェントはすべてのトランザクション開始時に所定のタイムアウトをブロックするため、時間のかかるバックグラウンドタスクのインストゥルメントをしている場合にのみ、このタイムアウトを設定することが推奨されます。
これらの設定値を使用して、トランザクショントレースを制御します。
newrelic.transaction_tracer.custom 範囲：
PERDIR
タイプ：
文字列（引用符を使用）
デフォルト：
""
これを、ユーザー定義の関数またはインストゥルメントのメソッドのコンマで区切ったリストに設定します。
"myfunction ,myclass ::method ,otherfunction "内部PHP関数は、カスタムトレーシングを有することはできません。
各PERDIRファイルをカスタム関数のリストに追加できますが、すでに追加されている関数またはメソッドを削除することはできません。プログラムで関数またはインストゥルメントするメソッドを追加する場合は、newrelic_add_custom_tracer()
newrelic.transaction_tracer.enabled 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
トランザクショントレーサーを有効化または無効化します。
トレーサーは、newrelic.transaction_tracer.threshold値で設定された閾値より時間がかかるトランザクションの、詳細なトランザクショントレースを作成します。1収集サイクル、1アプリケーションにつき、1つのトランザクショントレースのみが保存され、それは常にそのサイクル中で最も遅いトランザクションとなります。
トランザクショントレース は、特定のトランザクションが遅い理由を診断する際に有用です。メモリとパフォーマンスがクリティカルな場合を除き、ほとんどは無効にしないでください。これを有効にしてもパフォーマンスへの影響は非常にわずかで、メモリの使用量は増えます。
詳細については、newrelic.transaction_tracer.detail
newrelic.transaction_tracer.explain_enabled newrelic.transaction_tracer.explain_threshold 範囲：
PERDIR
タイプ：
期間
デフォルト：
"500"
クエリが「遅い」と見なされ、スロークエリ
期間の例
"200ms""1s250ms""1h30m""750us"newrelic.transaction_tracer.internal_functions_enabled 範囲：
SYSTEM
タイプ：
ブール値
デフォルト：
false
内部関数（Cで記述され、PHP標準ライブラリまたはPECL拡張子のいずれかで提供される関数）のトレーシングのサポートを有効化または無効化します有効にすると、内部関数は、PHPで記述された関数のようにトランザクショントレース に表示されます。
このオプションを有効にすると、特にPHP 5.xから多くのトレースを収集する際に、トランザクションが遅くなる場合があります。このオプションの有効化は、特に内部関数が遅いと疑われるパフォーマンス問題をデバッグする場合にのみ推奨されます。
newrelic.transaction_tracer.record_sql 範囲：
PERDIR
タイプ：
文字列（引用符を使用）
デフォルト：
"obfuscated"
クエリの記録方法（行う場合）を設定します。
トランザクショントレースを内部で記録する場合、スロークエリ呼び出しのクエリ全体が記録されます。このクエリをNew Relicに送信すると、セキュリティに重大な影響が生じる場合があるため、デフォルトではすべてのデータベースステートメントは、New Relicに送信する前に難読化されます。難読化ではクエリの文字列と数字を疑問符に置換するため、可逆性はありません。値も変わるため、影響がないのは、フィールド名だけとなります。
newrelic.transaction_tracer.slow_sql 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
スロークエリ機能を有効化または無効化するには、この設定を使用します。有効化すると、次のようになります。
newrelic.transaction_tracer.stack_trace_threshold 範囲：
PERDIR
タイプ：
期間
デフォルト：
"500"
これにより、クエリを記録中のトランザクショントレースのPHPスタック全体をエージェントが記録する上限閾値が設定されます。
単位付きの絶対値として期間を指定します。指定がない場合、デフォルトの単位はミリ秒となります。
期間の例
newrelic.transaction_tracer.threshold 範囲：
PERDIR
タイプ：
期間
デフォルト：
"apdex_f"
この変数を使用して、トランザクションがトレースの対象となる閾値を設定します。使用できる値は、以下のとおりです。
範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
この設定を使用して、スロークエリおよびトランザクショントレースによるDQL入力クエリの収集を有効化または無効化します。有効にすると、スロークエリおよびトランザクショントレースとともに表示されます。
newrelic.transaction_tracer.max_segments_web PHPエージェントがウェブトランザクションについて記録するセグメントの最大数を指定します。この最大値に達すると、サンプリングされます。
PHPエージェントは、収集したセグメントとして、トランザクショントレースとディストリビューティッド（分散）トレースをレポートします。各セグメントは、トランザクショントレースでのメソッドまたは関数呼び出しを表します。この設定のデフォルト値は0です。これは、PHPエージェントがウェブトランザクション中にすべてのセグメントをキャプチャすることを表します。トランザクション終了時に、最も優先順位の高いセグメントを組み合わせて、トランザクショントレースでレポートします。
数十万または数百万の関数呼び出しのある、長時間実行されるPHPプロセスでは、この値を1より大きな値に設定すると、PHPエージェントがセグメント記録時にシステムメモリを大量に消費することがなくなります。
セグメントサイズは、対応するメソッド名、クラス名の長さ、メソッドによるその後の呼び出し数によって異なります。つまり、控えめに見積もっても、1セグメント当たり400バイトとなります。PHPエージェントをセグメントのキャプチャにつき40 MBに制限するには、この値を100000に設定します。この値を2000より低く設定すると、トランザクショントレースにレポートされるセグメントの合計数がさらに制限されます。
この設定はPHPのウェブプロセス専用です。PHP CLIプロセスに影響はありません。CLIプロセスの制限を設定するには、newrelic.transaction_tracer.max_segments_cliを使用します。
newrelic.transaction_tracer.max_segments_cli 範囲：
PERDIR
タイプ：
数
デフォルト：
100000
PHPエージェントがCLIトランザクションについて記録するセグメントの最大数が指定されます。その最大値に達すると、サンプリングされます。
PHPエージェントは、収集したセグメントとして、トランザクショントレースとディストリビューティッド（分散）トレースをレポートします。各セグメントは、トランザクショントレースでのメソッドまたは関数呼び出しを表します。この設定のデフォルト値は0です。これは、PHPエージェントがウェブトランザクション中にすべてのセグメントをキャプチャすることを表します。トランザクション終了時に、最も優先順位の高いセグメントを組み合わせて、トランザクショントレースでレポートします。
数十万または数百万の関数呼び出しのある、長時間実行されるPHPプロセスでは、この値を1より大きな値に設定すると、PHPエージェントがセグメント記録時にシステムメモリを大量に消費することがなくなります。
セグメントサイズは、対応するメソッド名、クラス名の長さ、メソッドによるその後の呼び出し数によって異なります。つまり、控えめに見積もっても、1セグメント当たり400バイトとなります。PHPエージェントをセグメントのキャプチャにつき40 MBに制限するには、この値を100000に設定します。この値を2000より低く設定すると、トランザクショントレースにレポートされるセグメントの合計数がさらに制限されます。
この設定はPHP CLIプロセス専用です。PHPウェブプロセスに影響はありません。ウェブプロセスの制限を設定するには、newrelic.transaction_tracer.max_segments_webを使用します。
これらの設定値を使用して、さまざまなトレーサー機能を制御します。
newrelic.cross_application_tracer.enabled 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
false
クロスアプリケーショントレーサーを有効化または無効化します。クロスアプリケーショントレーサーは、アプリケーション間でウェブトランザクションメトリクスとトランザクショントレースを関連付けるため、HTTPヘッダーをアウトバウンドリクエストとレスポンスに挿入します。
ディストリビューティッド（分散）トレーシングとクロスアプリケーショントレーシングは同時に使用できません。PHPエージェントのデフォルト設定では、ディストリビューティッド（分散）トレーシングが有効になり、クロスアプリケーショントレーシングが無効になります。
newrelic.distributed_tracing_enabled 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
ディストリビューティッド（分散）トレーシング を有効化または無効化します。エージェントのトランザクショントレーサーとディストリビューティッド（分散）トレーシング機能が有効になっている場合、エージェントはヘッダーをアウトバウンドリクエストに挿入し、ディストリビューティッド（分散）トレーシングヘッダーの着信リクエストをスキャンします。
newrelic.transaction_tracer.enabled = true
newrelic.distributed_tracing_enabled = true
newrelic.distributed_tracing_exclude_newrelic_header 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
false
アウトバウンドリクエストに添付されたNew Relicディストリビューティッド（分散）トレーシングヘッダーを除外するには、これをtrueに設定し、ディストリビューティッド（分散）トレーシング用のW3Cトレースコンテキストヘッダーにのみ依存します。これがfalseの場合、両方のタイプのヘッダーがアウトバウンドリクエストに添付されます。
New Relicディストリビューティッド（分散）トレーシングヘッダーを使用すると、W3Cトレースコンテキストヘッダーをサポートしていない古いエージェントとの相互運用が可能になります。W3Cトレースコンテキストヘッダーをサポートするエージェントバージョンは、ディストリビューティッド（分散）トレーシング用のNew Relicヘッダーよりこのヘッダーを優先します。
newrelic.span_events_enabled newrelic.span_events.max_samples_stored スパンイベントはディストリビューティッド（分散）トレーシング にレポートされます。この値は、収集サイクルごとにコレクターに送信されるスパンイベントの最大数を設定します。値0はエージェントのデフォルトである2000を使用します。最大設定は10000です。
newrelic.infinite_tracing.trace_observer.host 無限トレーシングに使用するトレースオブザーバーを設定します。空白の場合、無限トレーシングのサポートは無効になります。この場合、ディストリビューティッド（分散）トレーシング とスパンイベントが有効になっている必要があります。
newrelic.infinite_tracing.trace_observer.port 無限トレーシングトレースオブザーバーとの通信に使用するTCP/IPポートを設定します。newrelic.infinite_tracing.trace_observer.hostが空の場合、この設定は無視されます。この設定は、通常、変更する必要はありません。
newrelic.infinite_tracing.span_events.queue_size 範囲：
PERDIR
タイプ：
整数（1000以上）
デフォルト：
100000
無限トレーシングトレースオブザーバーへの送信についてキューに登録可能なスパンイベント数を設定します。エージェントは、スパンバッチ内の無限トレーシングのスパンイベントを内部で管理します。これらのスパンバッチは、最大で1000スパンを保有できます。よって、スパンイベントのキューサイズは1000以下にはできません。1000以下にすると、1つのスパンバッチもキューに登録できません。1000以下のキューサイズを指定すると、最大サイズ1000が使用されます。
newrelic.error_collector.enabled 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
エラーコレクターを有効化または無効化します。有効にすると、エージェントはPHPエラーを収集し、New Relic UIにレポートします。
エージェントは、各トランザクションの最も重大なエラー、および収集サイクル 当たり最大20件のエラーのみを記録します。
newrelic.error_collector.record_database_errors 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
有効 にすると、エージェントはMySQL関数が返したエラーを、PHPエラーとして収集します。
newrelic.error_collector.prioritize_api_errors newrelic.error_collector.ignore_exceptions 範囲：
PERDIR
タイプ：
文字列
デフォルト：
(なし)
エージェントが無視すべき完全修飾例外クラス名の、カンマで区切ったリスト。捕捉されない例外が発生した場合、エージェントはリストにある各クラスについて、$exception instanceof Classと同様のことを実行します。これらのチェックでtrueが返された場合、エージェントは例外を記録しません。
サポートされているPHPリリース によっては、これらの値は例外レポートを無効にする 場合と同じになります。
サポートされたPHP 5バージョン: newrelic.error_collector.ignore_exceptions = Exceptions サポートされたPHP 7バージョン: newrelic.error_collector.ignore_exceptions = Throwable newrelic.error_collector.ignore_errors PHPエージェントのエラーレベル をignore に設定します。この設定の値は、PHPのerror_reportingオプション と同様の構文を使用します。たとえば、PHPエージェントがE_WARNINGとE_ERRORレベルエラーを無視するように設定する場合は、次を使用します。
newrelic.error_collector.ignore_errors = E_WARNING | E_ERROR
または
newrelic.error_collector.ignore_errors = 3
PHPエージェントを使用してE_WARNING以外のすべてを無視するよう設定するには、次を使用します。
newrelic.error_collector.ignore_errors = E_ALL & ~E_WARNING
newrelic.framework.drupal.modules 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
メモ：
バージョン3.0以下のエージェントでは、この値のデフォルトはfalseでした。このオプションを設定すると、newrelic.transaction_tracer.detail = 1が暗示されます。
Drupalモジュールトラッキングを有効にするには、これをtrueに設定します。このオプションは、newrelic.transaction_tracer.detailモジュール タブに表示されます。
newrelic.framework.wordpress.hooks 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
WordPressフックトラッキングを有効にするには、これをtrueに設定します。WordPressフック、プラグイン、テーマの記録が有効になり、 New Relic UIのWordPress
newrelic.webtransaction.name.files newrelic.webtransaction.name.functions 範囲：
PERDIR
タイプ：
文字列（引用符を使用）
デフォルト：
""
New RelicエージェントがDrupalまたはWordpressなど、特定のフレームワークを検知する場合を除き、ウェブトランザクションは最初のPHPファイルの後に命名されます。たとえば、article.phpのようになります。
最初のファイルがディスパッチャーの場合、この命名スキームでは有用性が低いデータが生成されます。この変数を使用して、ディスパッチャーが生成した「アクション」である関数のリストを指定します。ウェブトランザクションの名前は、関数が実行する最初のアクションとなります。
ディスパッチ関数命名の例
index.phpが以下の名前の関数にディスパッチする場合：
login、
logout、
admin、
show、および
edit
この値を"login,logout,admin,show,edit"に設定します。
ウェブトランザクションは、/index.php（最初のファイル名）ではなく、login、logoutなどと命名されます。
newrelic.webtransaction.name.remove_trailing_path 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
false
有効になっている場合、これにより、スクリプト名の後のリクエストURIの内容が削除されます。たとえば、これにより末尾の/xyz/zyが/path/to/foo.php/xyz/zyから削除されます。
newrelic.datastore_tracer.instance_reporting.enabled 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
falseの場合、エージェントはデータストアインスタンスメトリクスをレポートせず、hostまたはport_path_or_idパラメーターをトランザクションまたは遅いsqlトレースに追加しません。
newrelic.datastore_tracer.database_name_reporting.enabled 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
falseの場合、エージェントはdatabase_nameパラメーターをトランザクションまたは遅いsqlトレースに追加しません。
このセクションには、属性の収集とレポートに影響を与える設定が一覧記載されています。
newrelic.attributes.enabled newrelic.{destination}.attributes.enabled 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
browser_monitoring.attributes.enabledの場合を除きtrue
どの宛先が属性を受信するかを制御します。この設定は、.includeおよび.exclude 設定 を上書きします。
使用可能な宛先の詳細については、属性の有効化および無効化 を参照してください。
newrelic.attributes.{include|exclude} 範囲：
PERDIR
タイプ：
文字列
デフォルト：
(なし)
これは、属性の宛先の細かい制御を可能にする設定オプションのファミリーです。詳細については、属性の有効化および無効化 を参照してください。
このセクションには、残りのnewrelic.ini設定が一覧記載されています。
newrelic.enabled 範囲：
SYSTEM
タイプ：
ブール値
デフォルト：
(なし)
New Relicエージェントを有効化または無効化します。デフォルトでは、New Relic PHPエージェントはすべてのディレクトリに対して有効になっています。
ウェブサーバーに複数のサイトがあるが、PHPエージェントに特定のサイトのみを監視させたい場合：
newrelic.iniファイルのグローバル（システム）レベルでnewrelic.enabledがtrueに設定されていることを確認します。
1つ以上の特定のサイトについて、ディレクトリごと（PERDIR）に、newrelic.enabledをfalseに設定します。
グローバルにエージェントを無効にする必要がある場合は、newrelic.iniファイルでnewrelic.enabledの値をfalseに設定します。
エージェントがグローバルで無効になっている場合は、完全に初期化されません。重要な理由でグローバルに無効にしていると想定し、エージェントはPHPへの影響を可能な限りゼロに近くしようとします。
重要 エージェントをグローバルで無効にしてから、.htaccessを使用してディレクトリごとに選択的に有効にすることはできません。
newrelic.logfile 範囲：
SYSTEM
タイプ：
文字列（引用符を使用）
デフォルト：
"/var/log/newrelic/php_agent.log"
ここでは、メッセージのロギング用ファイル名を特定します。これは、エージェントによる問題のデバッグに有用です。設定がどのようなものであっても、以下を確認してください。
含まれるディレクトリとファイル自体の許可が正しい。 PHPが実行するユーザーがファイルに書き込みできる。通常、これはウェブサーバーと同じユーザーです。 newrelic.transaction_events.enabled 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
trueに設定すると、エージェントは分析イベントデータを収集し、レポートします。イベントデータを使用すると、New Relic UIは、ヒストグラム 、パーセンタイル などの追加情報を表示できます。
newrelic.error_collector.capture_events 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
trueに設定すると、エージェントはエラーイベントデータを収集し、レポートします。イベントデータを使用すると、New Relic UIはエラー分析を表示できます。
newrelic.feature_flag 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
この設定により、PHPエージェント内の新規および実験的な機能が有効になります。これらのフラグを使用して、PHPエージェントの後のバージョンでデフォルトで有効化される予定の機能を、選択的に可能にします。
newrelic.browser_monitoring.auto_instrument 範囲：
PERDIR
タイプ：
ブール値
デフォルト：
true
これにより、ブラウザモニタリングのためのJavaScript断片の自動挿入が可能になります。有効化すると、エージェントがヘッダーとフッターをHTML出力に挿入し、エンドユーザー体験のためのページロードタイミングに関するメトリクスが生成されます。詳細については、PHPでのページロードタイミング を参照してください。
newrelic.preload_framework_library_detection 範囲：
SYSTEM
タイプ：
ブール値
デフォルト：
true
メモ：
PHPエージェントバージョン9.4に導入
プレロードが有効化されている場合に、フレームワークとライブラリの検知が可能になります。プレロードはPHPバージョン7.4で導入されました。newrelic.preload_framework_library_detectionは、opcache.preloadがphp.iniファイルで設定されている場合のみ有効になります。