PHPエージェントをインストールする前に、お使いのシステムがバージョン要件を満たしていることを確認します。
PHPエージェントの互換性
PHPバージョン | エージェントバージョン | 現在のサポート状況 |
|---|---|---|
8.5 | 以降 | はい |
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
PHPメジャーバージョンの準備
New Relicは、新しいPHPマイナーバージョンへの迅速な対応に取り組んでいます。私たちの目標は、60日以内に最新リリースのGAをサポートすることです。緊急のセキュリティニーズに対応するために開発の優先順位が変更される可能性がありますが、私たちはこのギャップを縮め、当社のエージェントが最新のPHPアプリケーションを監視する最も信頼性の高い方法であり続けるよう全力を尽くしています。
Zend Thread Safety
Zend Thread Safety（ZTS）でコンパイルされたPHPビルドはサポートされていません。
ジャストインタイムコンパイル（JIT）
ジャストインタイムコンパイルは、エージェントリリース10.18.0.8以降でサポートされています。PHPは、PHPエージェントの以前のバージョンのJITを自動的に無効にします。
ファイバー
ファイバーはバージョン12.10以降でサポートされています。ファイバーの計装を無効にするには、設定ファイルにnewrelic.fibers.disabled = trueを追加してください。
アクセス権限
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、10 | x86_64 | |
CentOS Stream | 9、10 | aarch64 | |
RedHat Enterprise Linux | 8、9、10 | x86_64 | |
RedHat Enterprise Linux | 8、9、10 | aarch64 | |
Debian | 11、12、13 | x86_64 | |
Debian | 11、12、13 | 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、9.x、10.x、11.0、11.1、11.2 | Drupal固有機能 |
Joomla | 3.7以下 | エージェントバージョン 以下 |
Laminas | 3.x | |
Laravel | 11.x、12.x、13.x | |
Magento | 2.x（CEおよびEE） | |
Slim | 2.x、4.x | |
Symfony | 5.x、6.x、7.x、8.x | |
Wordpress | 6.0+ | |
Yii | 1.1、2.0 |
その他の一般的なPHPフレームワークのサポートを提案する場合は、サポートフォーラムを閲覧し、Feature Ideaを作成してください。詳細については、PHPフレームワーク：New Relicのサポートのインテグレーションを参照してください。
データベースおよびライブラリ
サポートされているデータベースとライブラリは次のとおりです。
Amazon DynamoDB（AWS -sdk-php 3ライブラリのみ） | Oracle |
Firebird（PDOドライバのみ） | PDOドライバ |
Postgres | |
Informix | |
Kinesis Data Streams（aws-sdk-php 3ライブラリのみ） | RabbitMQ（php-amqplib 3.7ライブラリのみ） |
Memcached | Redis（Redis Clusterを含む） |
Microsoft SQL Server（PDOドライバのみ） | SQLite |
MongoDB | SQS（AWS -sdk-php 3ライブラリのみ） |
MySQL | Sybase（PDOドライバのみ） |
ODBC（PDOドライバのみ） |
その他のサードパーティ監視ソフトウェア
アプリケーションが追加の監視ソフトウェアを使用している場合、エージェントが正しく動作することを保証できないため、技術サポートは提供できません。詳細については、その他の監視ソフトウェアを使用中のエラーを参照してください。
インスタンスの詳細
New Relicは様々なデータベースとデータベースドライバのインスタンス詳細を収集します。サポートされているデータベースと拡張機能は次のとおりです。
ホスト情報の収集を無効にするには、newrelic.iniファイルで次のいずれかを設定します。
- インスタンスのレポートを無効にする
newrelic.datastore_tracer.instance_reporting.enabled = false - データベース名を省略する
newrelic.datastore_tracer.database_name_reporting.enabled = false
現在PHPエージェントにリストされてないデータストアからインスタンスレベルの情報をリクエストするには、support.newrelic.comまでお問い合わせください。
メッセージキューイング
以下はメッセージキューイングをサポートしています。
セキュリティ要件
標準的な データ収集のセキュリティ対策として、アプリサーバーは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トランザクションに接続します。 |