• /
  • ログイン

PHPエージェントの設定

PHPエージェントには、レポートされたデータのタイプと量を微調整するための設定がいくつかあります。大半のユーザーにとっては、デフォルトの値で最善のオーバーヘッドと使用しやすさが実現されますが、特定のニーズにより設定を変更することもできます。

重要

INI設定の変更後、必ずウェブサーバーを再起動してください。再起動しないと、すぐに有効になりません

優先度の設定

PHPエージェントが設定で従う優先度が、次の図に簡単に示されています。サーバー側の設定には適用されません。PHPエージェントを使用してアプリのUIで変更できる唯一の値は、アプリのエイリアスとApdex-T値です。

php-config-order.png

New RelicのPHPエージェントを使用すると、API設定はディレクトリごとの設定を上書きします。ディレクトリごとの設定は、php.iniファイル設定を上書きします。サーバー側の設定には適用されません。

設定ファイルの変数

インストールの間、newrelic-installスクリプトは、作成された設定ファイルまたは編集が必要なファイルのリストについての情報を提供します。デフォルトでは、newrelic.iniという名前の設定ファイルを作成しようとします。

場合によっては、設定オプションをphp.iniファイルに追加するよう指示されます。必要な場合にのみそうしてください。どのファイルを編集する必要があるかは、PHPの特定のバージョン(1つまたは複数)が設定されているかどうかで異なります。

2つの最も一般的な設定は次のとおりです:

  • 単一のnewrelic.iniファイルを使用する。特別のオプションなしでPHPを自分でインストールまたはコンパイルした場合、これが通常デフォルトとなります。
  • すべての.iniファイルについて所定のディレクトリをスキャンする。

どのファイルを編集するか分からない場合:

  • コマンドラインから、php -iの出力を見直します。

  • ブラウザで、次のスクリプトを含むページの出力を見直します:

    <?php phpinfo(); ?>
  • newrelic.iniファイルが表示されている場合、それを使用します。

変数の範囲

newrelic.iniファイルの各変数には、定義された範囲があります。範囲は、設定をどこで確立または変更できるかを制御します。

New Relic設定でサポートされた2つの範囲は次のとおりです:

  • SYSTEM: 値はグローバルのnewrelic.iniファイルでグローバルに設定されます。
  • PERDIR: 値はディレクトリごとに設定されます。

それぞれ、より一般的なレベルで設定することもできます。それぞれの有効なロケーションは次のとおりです:

次のものについて設定できます:

SYSTEM

PERDIR

グローバルなnewrelic.iniファイルで設定します。

ディレクトリごとに設定します。

重要

New Relic設定ではini_set()を使用できません。

変数のタイプ

newrelic.iniファイルの各変数には、定義されたタイプがあります。タイプは、使用する値の構文を指定します。

変数のタイプ

フォーマットと内容

文字列

文字列の値には、英数字とピリオドを含めることができます。値は引用符で区切られます。

ブール値

論理的な真偽設定。有効な値は次のとおりです:

  • trueまたは有効な場合:ontrue、数字の1
  • falseまたは無効な場合: offfalse、数字の0

数値

数値には、数字に加え、浮動小数を表すピリオドのみを含めることができます。別途記載がある場合を除き、すべての数字は浮動小数ではなく整数です。

期間

期間を表す、引用符で区切られた文字列の値。文字フラグを使用して、時間コンポーネントを区切ります。フラグがない場合、時間はミリ秒となります。

  • w\= 週

  • d\= 日

  • h\= 時間

  • m\= 分

  • s\= 秒

  • ms\= ミリ秒

  • us\= マイクロ秒

    期間の例:

  • "1w3d23h10m"\= 1週、3日、23時間、10分

  • "5h30m"\= 5時間30分

  • "500"\= 500ミリ秒

一般構成設定

この設定は、newrelic.iniファイルで使用できます。

デーモンの .ini設定

この設定の値は、デーモン起動を制御します。デーモンの起動が必要なことをエージェントが検知すると、このオプションが、そのデーモンについて適切なコマンドラインオプションに変換されます。

これらすべての設定は、newrelic.cfgファイルの設定を反映します。すべての .ini設定を1か所に保管するため、これらはここで繰り返されます。newrelic.cfgの各設定にではここに、 プレフィックスとしてnewrelic.daemon.が付いた相手があります。たとえば、newrelic.cfgssl設定は、.iniファイルのnewrelic.daemon.sslとなります。

重要

ファイル/etc/newrelic/newrelic.cfgがある場合、エージェントはこの設定を無視し、デーモンを自動的に起動しません

デーモンの起動方法および外部設定ファイルをいつ使用するかの詳細については、PHPデーモン起動モードをご覧ください。

エージェントとデーモン間の通信向けにソケットエンドポイントを設定します。

これは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起動メカニズムを使用している場合、この設定とそのファイルのアドレス設定は一致する必要があります。

デーモン起動がトリガーされた後に、デーモンについてのエージェントの最大待ち時間を設定します。値を0にすると、エージェントが待たなくなります。認められた単位は、"ns"および"us""ms""s""m""h"です。

指定されたタイムアウト値は、--wait-for-portフラグを介してデーモンに渡されます。これにより、ソケットの取得、またはタイムアウトの時間が経過するまで、デーモンの起動がブロックされます。

推奨事項:タイムアウトを設定する場合、推奨値は2sから5sです。デーモンの起動に問題がある場合、エージェントはすべてのトランザクション開始時に所定のタイムアウトをブロックするため、時間のかかるバックグラウンドタスクのインストゥルメントを行っている場合にのみこのタイムアウトを設定することが推奨されます。

トランザクショントレーサー .ini設定

この設定の値を使用して、トランザクショントレースを制御します。

その他のトレーサーの .ini設定

この設定の値を使用して、さまざまなトレーサー機能を制御します。

属性の設定

このセクションには、属性の収集とレポートに影響を与える設定が一覧記載されています。

その他の .ini設定

このセクションには、残りのnewrelic.ini設定が一覧記載されています。

その他のヘルプ

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

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