PHPエージェントをインストールする前に、お使いのシステムがバージョン要件を満たしていることを確認します。
PHPエージェントの互換性
PHPバージョン | エージェントバージョン | 現在のサポート状況 |
|---|---|---|
8.4 | ≥ | はい |
8.3 | ≥ | はい |
8.2 | サポートされている全バージョンのエージェント | はい |
8.1 | サポートされている全バージョンのエージェント | はい |
8.0 | サポートされている全バージョンのエージェント | はい |
7.4 | サポートされている全バージョンのエージェント | はい |
7.3 | サポートされている全バージョンのエージェント | はい |
7.2 | サポートされている全バージョンのエージェント | はい |
7.1 | ≤ | いいえ |
7.0 | ≤ | いいえ |
最新のPHPエージェントリリースについては、PHPエージェントリリースノートを参照してください。
現在サポートされているすべてのPHPエージェントリリースの最新リストについては、PHPエージェントのEOLポリシーを参照してください。
サポートされていないPHPバージョンまたはプラットフォーム（32ビットOS、FreeBSD、ZTSビルドなど）を使用している場合は、PHPエージェントパッケージの自動更新メカニズムを無効にすることをお勧めします。自動更新を阻止しないと、新しいエージェントバージョンが誤ってインストールされることがあります。新しいバージョンでは、APMデータ収集に不可欠な重要な機能がサポートされなくなり、監視機能が中断される可能性があります。
自動更新を無効にするには、次の2つのオプションがあります。
パッケージアップグレードの除外リストにPHPエージェントパッケージを追加するか、または
PHPエージェントパッケージを、サポートされていない古い機能をサポートするエージェントバージョンにピン留めすることもできます（複数可）。影響を受けるPHPエージェントパッケージは次のとおりです
newrelic-php5newrelic-php5-commonnewrelic-daemon
Zend Thread Safety
Zend Thread Safety（ZTS）でコンパイルされたPHPビルドはサポートされていません。
ジャストインタイムコンパイル（JIT）
ジャストインタイムコンパイルは、エージェントリリース10.18.0.8以降でサポートされています。PHPは、PHPエージェントの以前のバージョンのJITを自動的に無効にします。
ファイバー
ファイバーはサポートされていません。
アクセス権限
PHPエージェントをインストールするには、以下に対するルートアクセスがrequiresです。
- PHP拡張ディレクトリへの読み取り/書き込みアクセス
- PHP設定ディレクトリ（推奨）または
php.iniのPHP設定データへの読み取り/書き込みアクセス - ウェブサーバーまたはPHPプロセスプールを再起動します
エージェントの実行にはルートアクセスはdoes not require。エージェントには、次のファイルへの読み取り/書き込みアクセスが必要です（これらのファイルの場所はPHPエージェント設定でカスタマイズできます）。
ライセンスキー
New Relic は40文字の16進数の文字列で構成され、サインアップ時にNew Relicから提供されます。詳細については、PHPインストールスクリプトまたはPHP iniファイルのライセンスキー設定を参照してください。
プロセッサ
次のプロセッサアーキテクチャーがサポートされています。
- x86_64（amd64とも呼ばれる）
- aarch64（ARM64とも呼ばれる）
重要
aarch64（ARM64）のサポートはPHP 8.0以降のみとなります。
オペレーティングシステム
ベンダーがサポート終了（Ubuntuの標準サポート終了ページなど）を発表した場合、当社ではこれらの最新バージョンのサポートをベンダーサポート終了日から1年間継続します。ただし、使用しているPHPバージョンが正式にサポートされなくなった場合は、1年未満でサポートが終了する可能性があります。
このため、ベンダーによる正式サポートの最新バージョンのOSを常に使用することをお勧めします。エージェントの最新バージョンは、サポート終了を過ぎたOSバージョンでも動作する可能性がありますが、古いバージョンのPHPエージェントはより長期間にわたってテストまたは正式にサポートされます。
上記のPHPエージェントの情報に基づいて、以下の表に示すインストール方法でOSにインストールできます。
オペレーティングシステム | リリース | CPUアーキテクチャ | インストール方法 |
|---|---|---|---|
Alpine Linux | 3.17、3.18、3.19、3.20、3.21、3.22 | x86_64、aarch64 | |
Amazon Linux | 2 | x86_64 | |
Amazon Linux | 2 | aarch64 | |
Amazon Linux | 2023 | x86_64、aarch64 | |
CentOS Stream | 9 | x86_64 | |
CentOS Stream | 9 | aarch64 | |
RedHat Enterprise Linux | 8、9 | x86_64 | |
RedHat Enterprise Linux | 8、9 | aarch64 | |
Debian | 11、12 | x86_64 | |
Debian | 11、12 | aarch64 | |
Ubuntu | 20、22、24 | x86_64 | |
Ubuntu | 20、22、24 | aarch64 | |
以下の条件を満たすLinuxディストリビューション | 該当なし | x86_64、aarch64 |
ウェブサーバー
サポートされているウェブサーバーは次のとおりです。
- 次を介してApache 2.2または2.4：
mod_php - PHP-FPMを使用してFastCGIをサポ―トしている任意のウェブサーバー
フレームワーク
サポートされているフレームワークは次のとおりです。
フレームワーク | バージョン | 考慮事項 |
|---|---|---|
CakePHP | 4.x、5.x | |
Drupal | 7.x、8.x、9.x、10.x、11.0 | |
Joomla | 3.7以下 | エージェントバージョン 以下 |
Laminas | 3.x | |
Laravel | 6.x、7.x、8.x、9.x、10.x、11.x | Laravel Horizonはサポートされていません。 |
Lumen | 6.x、7.x、8.x、9.x、10.x | |
Magento | 2.x（CEおよびEE） | |
MediaWiki | 1.31以上 | |
Slim | 2.x、3.x、4.x | |
Symfony | 4.x、5.x、6.x、7.x | |
Wordpress | 5.9以上 | |
Yii | 1.1、2.0 | |
Zend Framework | 3.x |
その他の一般的なPHPフレームワークのサポートを提案する場合は、サポートフォーラムを閲覧し、Feature Ideaを作成してください。詳細については、PHPフレームワーク：New Relicのサポートのインテグレーションを参照してください。
データベースおよびライブラリ
サポートされているデータベースとライブラリは次のとおりです。
Amazon DynamoDB（AWS -sdk-php 3ライブラリのみ） | |
Firebird（PDOドライバのみ） | PDOドライバ |
Postgres | |
Informix | |
Memcached | RabbitMQ（php-amqplib 3.7ライブラリのみ） |
MongoDB | Redis |
Microsoft SQL Server（PDOドライバのみ） | SQLite |
MySQL | SQS（AWS -sdk-php 3ライブラリのみ） |
ODBC（PDOドライバのみ） | Sybase（PDOドライバのみ） |
Oracle |
その他のサードパーティ監視ソフトウェア
アプリケーションが追加の監視ソフトウェアを使用している場合、エージェントが正しく動作することを保証できないため、技術サポートは提供できません。詳細については、その他の監視ソフトウェアを使用中のエラーを参照してください。
インスタンスの詳細
New Relicは様々なデータベースとデータベースドライバのインスタンス詳細を収集します。サポートされているデータベースと拡張機能は次のとおりです。
ホスト情報の収集を無効にするには、newrelic.iniファイルで次のいずれかを設定します。
- インスタンスのレポートを無効にする
newrelic.datastore_tracer.instance_reporting.enabled = false - データベース名を省略する
newrelic.datastore_tracer.database_name_reporting.enabled = false
現在PHPエージェントにリストされてないデータストアからインスタンスレベルの情報をリクエストするには、support.newrelic.comまでお問い合わせください。
メッセージキューイング
以下はメッセージキューイングをサポートしています。
- HTTP
- Laravelのキューイング
重要
Laravel Horizonはサポートされていません。
セキュリティ要件
標準的な データ収集のセキュリティ対策として、アプリサーバーはSHA-2（256ビット）をサポートしている必要があります。SHA-1はサポートされていません。
New Relic機能のサポート
PHPエージェントは他のNew Relic機能と統合して、エンドツーエンドの可視性を提供します。
製品 | インテグレーション |
|---|---|
自動インストゥルメンテーションを有効化すると、PHPエージェントは自動的にBrowserエージェントのJSコードを投入します。Browserインジェクションを有効化すると、APMの概要ページでBrowserデータを表示、特定のアプリに対してAPMとBrowserデータ間を素早く切り替えできます。設定オプションと手動インストゥルメンテーションについては、BrowserモニタリングおよびPHPエージェントを参照してください。 | |
New Relic CodeStreamはIDEにオブザーバビリティをもたらし、本番環境でコードがメソッドレベルでどのように機能しているかを表示します。 PHPバージョン7.0～7.4および8.0～8.3では、コードレベルのメトリクスをレポートします（リリース10.4.0以降）。 | |
インフラストラクチャとAPMエージェントを同じホストにインストールすると、それらは自動的にお互いを検出します。その後、APM UIにホストのリストを表示し、Infrastructure UIのAPMアプリ別にホストをフィルタリングできます。詳細については、インフラストラクチャモニターにおけるAPMデータを参照してください。 | |
PHPエージェントは、Monolog 2および3のライブラリのLogs in context機能をサポートしています。 | |
PHPエージェントは、NRQLクエリを実行するため、デフォルトのイベントと属性を送信します。高度な分析のために、カスタムイベントを記録することもできます。 | |
合成トランザクショントレースは、合成モニターからのリクエストを基盤となるAPMトランザクションに接続します。 |