PHPのNew Relicをインストールする前に、システムが適用要件を満たしていることを確認します。
New Relicアカウントをまだお持ちでない場合は、New Relicアカウントを新たに作成します。永久無料です。
PHPのリリース
New Relicは、PHPのバージョン7.0、7.1、7.2、7.3、7.4、8.0、8.1、8.2をサポートしています。
重要
互換性メモ：PHP 8.0、8.1または8.2が、New Relicエージェントなどのオブザーバビリティ拡張機能を検出すると、PHPがジャストインタイムコンパイルを無効にします。
PHP 8.1+のサポートにはファイバーは含まれません。
PHPバージョン7.0および7.1のサポートは、2023年12月にサポート終了（EOL）になります。
- 当社は、PHPのサポートされているリリースの使用を推奨しています。
- リリース9.19は、ZTSビルドをサポートする最終リリースです。
重要
サポートされていないPHPバージョンまたはプラットフォーム（例：32ビットOS、FreeBSD、ZTS）を使用するインストレーションでは、PHPエージェントパッケージの自動更新メカニズムを無効にすることを強くお勧めします。これは、パッケージアップグレードの除外リストにPHPエージェントパッケージを追加することで行うことができます。または、PHPエージェントパッケージを、サポートされていない古い機能をサポートするエージェントバージョンにピン留めすることもできます（複数可）。アップグレードの防止に失敗すると、新しいエージェントリリースがインストールされ、必要な、サポートされていない機能のサポートが削除されます。これにより、APMデータ収集が中断されます。影響を受けるPHPエージェントパッケージは次のとおりです。
- newrelic-php5
- newrelic-php5-common
- newrelic-daemon
アクセス権限
ライセンスキー
インストレーションの際には、New Relicのが必要です。ライセンスキーは40文字の16進数の文字列で構成され、サインアップ時にNew Relicから提供されます。詳細については、PHPインストールスクリプトとPHP INIファイルのライセンスキー設定を参照してください。
プロセッサタイプ
- Intel（および互換）プラットフォーム
- ARM64
オペレーティングシステム
New RelicのPHPエージェントは、Ubuntu、Debian、Amazon Linux、Alpine、RHEL、CentOSオペレーティングシステム（OS）に対応しています。ベンダーがサポート終了（Ubuntuの標準サポート、DebianのEOL LTS、RHELのメンテナンスサポート、CentOSのメンテナンスアップデートなど）を発表した場合、New Relicではこれらの最新バージョンのサポートを1年間継続します。1年が経過すると、New Relicはこれらのバージョンのサポートを終了します。使用しているPHPのバージョンがOSで正式に利用できなくなった場合、1年未満でサポートが終了する可能性があります。ベンダーによる正式サポートの最新バージョンのOSを使用することを強くお勧めします。エージェントの最新バージョンは、サポート終了を過ぎたOSバージョンで動作する可能性がありますが、New RelicのPHPエージェントによるテストや公式サポートは終了しています。
オペレーティングシステム | New RelicのPHPエージェントによりサポートされています |
|---|---|
Linux（x86_64） |
|
Linux（ARM64） |
|
ウェブサーバー
- 次を介してApache 2.2または2.4：
mod_php - PHP-FPMを使用してFastCGIをサポ―トしている任意のウェブサーバー
フレームワーク
サポートされているPHPフレームワークは、以下のとおりです。
フレームワーク | |
|---|---|
CakePHP 2.x | Magento 1.xおよび2.x、CEおよびEE |
CodeIgniter 2.x | MediaWiki |
Slim 2.x、3.xおよび4.x | |
Joomla 3.x | Symfony 3.x、4.x、5.x |
Laminas 3.x | |
Laravel 6.x、7.x、8.x、9.xおよび10.x | Lumen 6.x、7.x、8.x、9.xおよび10.x |
Zend Framework 1.x、2.xおよび3.x | Yii 1.x |
重要
PHP 8.xでは、Joomla 3.xはサポートされていません。
PHPエージェントのフレームワークリストは増え続けています。使用中のフレームワークがこのリストにない場合でも、PHPエージェントはアプリについて役立つ情報を提供できる場合があります。
詳細については、PHPフレームワーク：New Relicのサポートのインテグレーションを参照してください。その他の一般的なPHPフレームワークのサポートを提案する場合は、サポートフォーラムを閲覧し、Feature Ideaを作成してください。
データベースおよびライブラリ
サポートされているデータベースおよびライブラリ：
データベースおよびライブラリ | |
|---|---|
Firebird（PDOドライバのみ） | Oracle |
Informix | PDOドライバ |
Memcached | Postgres |
MongoDB | |
Microsoft SQL Server（PDOドライバのみ） | Redis |
MySQL | SQLite |
ODBC（PDOドライバのみ） | Sybase（PDOドライバのみ） |
その他のAPMソフトウェア
アプリケーションが当社のエージェント以外に他社のアプリケーションパフォーマンスモニタリング (APM)ソフトウェアを使用している場合は、エージェントが正しく動作することを保証できないため、技術サポートは提供できません。詳細については、その他のモニタリングソフトウェアを使用中のエラーを参照してください。
インスタンスの詳細
New Relicは様々なデータベースとデータベースドライバのインスタンス詳細を収集します。APMで特定のインスタンスとデータベース情報のタイプを表示する機能は、次の場合に利用できます。
データベース | 拡張子 |
|---|---|
ホスト情報の収集を無効にするには、以下のいずれかのオプションを使用します。
newrelic.iniでnewrelic.datastore_tracer.instance_reporting.enabledをfalseに設定します。newrelic.datastore_tracer.database_name_reporting.enabled = falseでデータベース名を省略します。
現在、New Relicエージェントにリストされてないデータストアからインスタンスレベルの情報をリクエストするには、support.newrelic.comまでお問い合わせください。
CodeStream/コードレベルのメトリクス
PHPエージェントは、PHPリリース7.0、7.1、7.2、7.3、7.4、8.0、8.1および8.2のコードレベルのメトリクスをサポートしています。
Logs in Context
PHPエージェントは、次のライブラリのAPM Logs in contextをサポートします。
- Monolog 2および3
メッセージキューイング
- HTTP
- Laravelのキューイング
セキュリティ要件
標準的な データ収集のセキュリティ対策として、アプリサーバーは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エージェントは、アプリケーションのコードレベルのメトリクス（リリース10.4.0以降）をレポートします。これにより、コードがメソッドレベルでどのように機能しているかを詳細に把握できます。 | |
インフラストラクチャとAPMエージェントを同じホストにインストールすると、それらは自動的にお互いを検出します。その後、APM UIにホストのリストを表示し、Infrastructure UIのAPMアプリ別にホストをフィルタリングできます。詳細については、インフラストラクチャモニターにおけるAPMデータを参照してください。 | |
PHPエージェントは、NRQLクエリを実行するため、デフォルトのイベントと属性を送信します。高度な分析のために、カスタムイベントを記録することもできます。 | |
合成トランザクショントレースは、合成モニターからのリクエストを基盤となるAPMトランザクションに接続します。 |