非標準の PHP インストールを使用している場合は、この手順に従って New Relic を正しくインストールしてください。これは、デフォルトのインストーラーがお使いの PHP インストールを見つけられない場合によく見られます (たとえば、セルフコンパイルされた PHP や自己完結型の PHP スタックを使用している場合など)。
重要
インストール作業の一環として、デフォルトの アプリケーション名 を意味のある名前に変更します。
要件
PHPのコマンドラインバージョン（ php -i ）を使用するか、 phpinfo()の出力を確認して以下を判別します。
- PHP拡張バージョン（
20090626、20100525、20121212、20131226、20151012、または20160303） - 拡張機能またはモジュールのインストールディレクトリ
- あなたのバージョンの PHP が ZTS (Zend Thread Safety) をサポートしてコンパイルされているかどうか。
ZTSのオプションは、 PHPエージェントのバージョン9.17以前にのみ適用されます 。ZTS は、PHP バージョン 9.18 以降では利用できません。
コマンドラインでのnewrelic-installスクリプトの使用（推奨）
これらのオプションを使用して、New Relicを正しいディレクトリに誘導します。
そのディレクトリから
newrelic-installスクリプトを呼び出します。サーバーとパスによっては、インストールスクリプトがシステム上で他のバージョンのPHPを検出する場合があります。リストから特定のバージョンを選択します。
詳細については、 PHP インストールスクリプト を参照してください。
New Relicを手動でインストールする
インストールスクリプトを使用したくない場合は、完全に手動でインストールできます。PHPのインストールに関する情報を必ず収集してください。phpinfo()から適切な値を確認して取得できます。次に、ファイルを作成してリンクするか、ファイルを手動で所定の位置にコピーします。
phpinfo()からインストールパラメータを取得
このプロセスがうまくいかない場合は、 phpinfo()から正しい情報を取得し、適切な設定を環境変数としてシステムに渡すことができます。
phpinfo() | メモ |
|---|---|
| これは、 |
| これは、
|
| これは、PHPコアセクションで |
| ZTSオプションは、 PHPエージェントバージョン9.19.0.309以前にのみ適用されます。ZTSは、PHPエージェントバージョン9.20.0.310以降では使用できません。 ZTSがコンパイルされているかどうかを判断するには、
|
| これは、NewRelicエージェントのインストールディレクトリのベースディレクトリです。たとえば、 |
この情報をもとに、以下のコマンドを実行して、PHPモジュールをインストールしてください。サンプルの値を実際の設定に合わせるようにしてください。
$NRBASEDIR=/usr/lib/newrelic-php5; export NRBASEDIR$ MODULEDIR=/usr/lib/php/modules; export MODULEDIR$ ARCH=x64; export ARCH$ PHPAPI=20090626; export PHPAPI$ PHPZTS="-zts"; export PHPZTS$ rm -f $MODULEDIR/newrelic.so$ ln -s $NRBASEDIR/agent/$ARCH/newrelic-${PHPAPI}${PHPZTS}.so \> $MODULEDIR/newrelic.soマニュアル設定
次のステップはコンフィギュレーションです。
PHPインストールが追加の構成ファイルを読み取るディレクトリに
$NRBASEDIR/scripts/newrelic.ini.templateをコピーし、名前をnewrelic.iniに変更します。宛先を決定するには、
Scan this dir for additional .ini filesと呼ばれるアイテムのphpinfo()出力を確認します。リストされているディレクトリが(none)の場合、このファイルからリストされているPHP構成ファイル（通常はphp.ini）に設定を追加します。newrelic.iniファイル内のライセンスキー設定をに置き換えます。 必要に応じて他のセッションも変更します (例:newrelic.appname)。$NRBASEDIR/daemon/newrelic-daemon.$architectureを/usr/bin/newrelic-daemonにコピーします。システムによって、$architecture は x86 または x64 になります。
ディスパッチャー/ウェブサーバーを再起動してください。
サイトが正しく機能していることを確認します。そうでない場合は、作成した
newrelic.iniまたはnewrelic.soを削除し、ディスパッチャ/ Webサーバーを再起動して、古い操作を復元します。Webサーバー/ディスパッチャーのログファイル（
newrelicではない）を調べて、問題の特定に役立ててください。それでもサポートが必要な場合は、 support.newrelic.comでサポートを受けてください。
インストールの確認
newrelicセクションのphpinfo()ページを調べて、再起動後にエージェントがインストールされていることを確認します。エージェントが正常にインストールされたように見える場合は、システムをチェックして、2つのnewrelic-daemonプロセスが実行されていることを確認します。
RedHatベースのシステムの場合。
bash$ps -aef | grep newrelic-daemonDebianベースのシステムの場合。
bash$ps aux | grep newrelic-daemon
アプリでトラフィックを生成し、結果がAPM Summaryページに表示されるまで 3 ～ 5 分待ちます。