PHP のディレクトリ毎の INI 設定

ウェブサーバーが複数のドメインを提供している場合は、INIファイルの例にある構文を使用してください。New Relic でこれらのドメインをそれぞれ個別に表示するには、次のようにします。

1. メインドメインの場合、グローバルINIファイルにnewrelic.appname = "My Main Domain"を設定します。

2. 仮想ホスト構成の一部としてphp_valueエントリを追加して、各仮想ホストの値を上書きします。

   重要

   PHPのインストールに適切なモジュール名を使用していることを確認してください。以下の例のPHP_MODULEは、インストールされているPHP5モジュールの名前に置き換えてください。この名前は、使用されているLinuxおよび/またはPHPディストリビューションによって異なります。たとえば、一般名にはphp5_module 、 mod_php5 、 php_moduleなどがあります。大文字と小文字は異なる場合があります。

   Apache サーバの場合、以下のいずれかの方法でモジュール名を見つけることができます。それぞれ、インストールされているモジュールのリストが生成されます。

• コマンドラインから、以下を実行してください。

  bash

  コピー

  $
  apachectl -t -D DUMP_MODULES

  OR

• ウェブページ内では

  <?php
    print_r(apache_get_modules());
  ?>

  コピー

  ドメイン別にappnameを設定する

  以下はドメインを分割する例です。ここで、 PHP_MODULE は PHP5 モジュールの名前です。

  <VirtualHost 192.168.42.43>
    ServerName www.myvhost1.com
    DocumentRoot "/path/to/vhost1/"
    ...
    <IfModule PHP_MODULE>
      php_value newrelic.appname "Virtual Host 1"
    </IfModule>
  </VirtualHost>
  
  <VirtualHost 192.168.123.45>
    ServerName www.myvhost2.com
    DocumentRoot "/path/to/vhost2/"
    ...
    <IfModule PHP_MODULE>
      php_value newrelic.appname "Virtual Host 2"
    </IfModule>
  </VirtualHost>

  コピー

  上記の例では、 newrelic.appnameは仮想ホストごとに異なる値に設定されています。

  文字列と数値の値には、 php_value name VALUEを使用します。ここで：

• name PHP INI設定にリストされているように、変更するINI設定の名前です。

• VALUE その特定の仮想ホストに設定する値です。

  文字列値は必ず引用符"で囲んでください。

  ブール設定を変更する場合は、構文php_flag name VALUEを使用します。ここで、 nameはPHP INI設定にリストされている変数名であり、 VALUEはonまたはoffのいずれかです。

  バーチャルホストのNew Relicエージェントを完全に無効にするには、ブーリアンフラグを使用します。

  <VirtualHost 192.168.56.78>
    ServerName www.myvhost3.com
    DocumentRoot "/path/to/vhost3/"
    ...
    <IfModule PHP_MODULE>
      php_flag newrelic.enabled off
    </IfModule>
  </VirtualHost>

  コピー

.htaccessファイル内のINIファイルの例の構文を使用します。例えば：

php_value newrelic.appname "My Blog App"

これにより、ディレクトリ単位での設定をディレクトリ内から制御することができます。

この例では、Webサーバーのドキュメントルートは/data/webrootです。また、特殊なアプリケーション用に2つのサブディレクトリがあります。

• /data/webroot/blog

  にはブログ アプリケーションが含まれています。

• /data/webroot/shopにはショッピングカートアプリケーションが含まれています。

サイトの3つの部分がNew RelicのUI上で別々のアプリケーションとして報告されるようにするためです。

1. INIファイルにメインアプリケーションの名前を設定します。
2. 各専用ディレクトリの.htaccessファイルを使用してその名前を上書きします。

特定の.htaccessファイルを持たないWebサーバーの部分（たとえば、 /data/webroot/something ）は、INIファイルで定義されたグローバルアプリケーション名を使用します。

.htaccessファイルの使用とセキュリティ保護の詳細については、 Apache HTTP サーバー チュートリアルを参照してください。

poolは、そのプールのリクエストのみを処理する専用のワーカーの子セットです。 PHP-FPM は専用のワーカー子プロセスを必要とするため、個別のオプションを設定する必要がある仮想ホストまたはアプリケーションの数が多すぎると、スケーリングが不十分になります。

PHP-FPMをディレクトリごとに設定するには、次のようにします。

1. INIファイルにメインアプリケーション名を設定する。

2. 追加した2つのアプリケーション用に2つのプールを設定します。

3. これらのプールでアプリケーション名の設定を上書きします。

   各プールには固有の接続メカニズムが必要です（Webサーバー構成ファイルで使用するプールを識別できるようにするため）。 php-fpm.confの例を次に示します。

   [app1]
   listen=/tmp/pool-app1.sock
   php_value[newrelic.appname] = "My App 1"
   
   [app2]
   listen=/tmp/pool-app2.sock
   php_value[newrelic.appname] = "My App 2"
   
   [app3]
   listen=/tmp/pool-app3.sock
   php_flag[newrelic.enabled] = off

   コピー

   プールごとの変数設定の一般的な形式は、文字列変数または数値変数の場合はphp_value[name] = VALUE 、ブール値の場合はphp_flag[name] = VALUEです。文字列値は常に引用符で囲みます" 。ブール値はonまたはoffのいずれかでなければなりません。

   設定ファイルをセットアップしたら、Webサイトのさまざまな部分に異なるプールを使用するようにWebサーバーに指示する必要があります。詳細については、お使いのWebサーバーのドキュメントを参照してください。

.user.iniファイルのCGI/FastCGIのINIファイルの例の構文を使用できます。これはApacheの.htaccessファイルに似ていますが、PHP-FPMに固有のものです。 PHPが実行されるディレクトリで.user.iniファイルがスキャンされます。この機能の詳細については、 PHP user.iniファイルのドキュメントを参照してください。

以下の手順でアプリの名前を変更します。 Webページのルートディレクトリで

1. .user.iniファイルを作成します

2. 変更したい設定を追加します
   newrelic.appname = "New Appname"

3. ファイルを保存します。

   デフォルトでは、 .user.ini fileは5分ごとに読み取られるため、再起動は必要ありません。

   これは以下のような場面で有効です。

4. サーバー構成が機能しません。 NGINX / PHP-FPMセットアップでは、FastCGIとPHPの間の通信、およびからの情報が不足している可能性があります
   fastcgi_param PHP_VALUE newrelic.appname="Appname"
   PHPに到達することはありません。

5. PHPがsuPHPで実装されている場合など、 .htaccessは機能しません

ここでは、NGINX のロケーションに基づいて FastCGI マネージャに値を渡す一般的な手順を示す NGINX コンフィグファイルの小さな断片を紹介します。

location /blog {
  fastcgi_param PHP_VALUE "newrelic.appname=My Blog";
  ...
}

location /shop {
  fastcgi_param PHP_VALUE "newrelic.appname=Shopping Cart";
  ...
}

location /admin{
  fastcgi_param PHP_VALUE "newrelic.enabled=false";
  ...
}