9.0の新機能

ディストリビューティッド（分散）トレーシングを有効にした場合、詳細なトランザクショントレースが利用可能になりました。

このリリースには、エージェントがディストリビューティッド（分散）トレーシングの代わりにトランザクショントレースに使用されるセグメントをソートし、異なる優先順位を適用できるようにするためのセグメントストレージのリファクタリングが含まれています。PHPエージェント8.4のリリースには、ディストリビューティッド（分散）トレーシングの限定的なサポートが含まれていましたが、これにより、ディストリビューティッド（分散）トレーシングが有効になっている場合、個々のPHPサービスの詳細なトランザクショントレースが失われる結果となりました。

この新しいリリースでのリファクタリングにより、PHPサービスを含むディストリビューティッド（分散）トレーシングについて、表示したいセグメント（スパン）をエージェントが送信できるようになりました。また、個々のPHPサービスのトランザクショントレースを調査する際に、可能な限り詳細なセグメント情報を個別に提供します。

メモ：

• このリリースでは、ディストリビューティッド（分散）トレーシングを有効にする手順に変更はありません。
• ディストリビューティッド（分散）トレーシングがオンの場合、newrelic.transaction_tracer.detailの動作が変更されました。8.4～8.7のPHPエージェントリリースでは、ディストリビューティッド（分散）トレーシングが有効になっている場合、newrelic.transaction_tracer.detailは無効になっていました。現在はそうではありません。詳細については、ディストリビューティッド（分散）トレーシングを使用する際のトレースレベルの詳細の設定のドキュメントをご覧ください。
• ディストリビューティッド（分散）トレーシングのサポート向上を有効にするため、9.0ではPHPエージェントのメモリ割り当て戦略が変更されました。トランザクションの開始時にPHPエージェントはより積極的にメモリを割り当てます。また、OSカーネルおよびCライブラリの設定によっては、システムアロケータがそのメモリをすぐにOSに解放しない場合があります。その結果、PHPプロセスのメモリ使用量が、以前のバージョンのPHPエージェントよりも高くなる場合があります。

9.0のアップグレードに関する注意事項

これらのディストリビューティッド（分散）トレーシングの強化に伴い、閾値を確認してください。

• 8.4～8.7のPHPエージェントのリリースでは、軽量なPHPサービスがトレースの一部である場合でも、エージェントが完全なディストリビューティッド（分散）トレーシングを報告するように、顧客にnewrelic.transaction_tracer.threshold = 0を設定することを推奨していました。これは不要になりました。
• 9.0リリースにアップグレードする際は、newrelic.transaction_tracer.thresholdの設定を確認し、この値をデフォルト値、またはアプリケーションにとって適切なより高い値に戻すことをお勧めします。

起動時にルート証明書バンドルが見つからない場合、デーモンは警告を出すようになりました。

• デーモンには独自の証明書が含まれており、引き続き動作しますが、PHPエージェントの将来のバージョンでは組み込みの証明書が削除されます。その時点で、PHPエージェントはNew Relicのサーバーと通信できなくなります。
• 推奨：PHPエージェントを使用する前に、ホストまたはコンテナにルート証明書バンドルがインストールされていることを確認してください。これは通常、ほとんどのLinuxディストリビューションでca-certificatesパッケージとして利用できます。FreeBSDでは、portsのsecurity/ca_root_nssパッケージを介してバンドルを利用できます。

デーモンは、--tlsフラグを使用して呼び出すことができなくなりました。

• PHPエージェントバージョン8.0.0の時点で、セキュリティ向上のためnewrelic.daemon.ssl ini設定は削除されていましたが、引き続きコマンドラインから--tls trueを使用してデーモンを呼び出すことができました。--tlsフラグを使用したコマンドラインからのデーモンの呼び出しは失敗します。
• 8.0.0以降のすべてのPHPエージェントバージョンと同様に、New Relicサーバーとの通信には常にTLSが使用されます。

バグ修正

• PHP 7.3でdrupal_http_requestを使用した場合の潜在的なセグメンテーションフォールトが修正されました。
• 場合によっては、リクエスト中に（newrelic_start_transactionまたはnewrelic_set_appnameを介して）新しいトランザクションを開始すると、フレームワークおよびユーザー関数の計装が不完全な状態になる可能性があります。
• SQLを難読化する際、SQL自体を損なうことなくコメントが削除されます。
• クラスター化された接続で同期executeCommand()コードパス（たとえば、HSET）を使用するPredis 0.8コマンドは、メトリクスを生成しませんでした。これは修正されました。

既知の問題と回避策

長時間実行されるトランザクションによる潜在的なメモリ枯渇

PHPエージェント9.xは、トランザクション中の関数呼び出しやセグメントの追跡に使用されるメモリの解放に消極的であるため、以前のバージョンよりも多くのメモリを使用します：通常の場合、メモリは各トランザクションの終了時にのみ解放されます。

これは主に、メッセージキューを処理するバックグラウンドジョブ、データの変換やレポート作成、電子メールの送信など、実行時間の長いトランザクションを持つユーザーに現れる傾向があります。

この問題によりご不便をおかけして申し訳ありません。現在、修正に向けて積極的に取り組んでいます。短期的には、この問題を軽減するための4つの可能な回避策があります。

回避策：

• 1. トランザクションを手動で開始/停止します。影響を受けるトランザクションが、メッセージキューの消費者など、一連の反復プロセスを実行するものである場合、各反復を個別のトランザクションとして手動で計装できます。これにより、プロセスがどのように動作しているかについて、よりきめ細かいデータが得られます。これを行うことで、使用されたメモリは各トランザクションの後に解放されます。これを実装するには、newrelic_end_transaction(true)による最初の自動トランザクションを無視し、newrelic_start_transaction()とnewrelic_end_transaction()を使用して各トランザクションを順番に計装します。
• 2. トランザクショントレースの詳細を減らす。PHP 7.4、またはPHPエージェント9.xリリースで追加された機能がすぐに必要であり、データストアと外部呼び出しに関する情報のみを含むトレースで十分な場合は、次の設定を変更することで、PHPエージェントがキャプチャする詳細レベルを下げることができます：newrelic.transaction_tracer.detail = 0。この設定により、トレースにはPHP関数呼び出しが含まれなくなります。注：数十万回のデータストアまたは外部呼び出しを行うトランザクションは、依然としてメモリの問題の影響を受ける可能性があります。
• 3. PHPエージェント8.7にダウングレードします。すぐにPHP 7.4を使用する予定がない場合、これが最も簡単で最速の解決策になる可能性があります。ダウングレードするには、https://download.newrelic.com/php_agent/archive/8.7.0.242/のtarボールからインストールするか、パッケージマネージャでバージョン8.7.0.242にダウングレードしてそのバージョンを固定します。PHPエージェント8.7でディストリビューティッド（分散）トレーシングが有効になっている場合、トランザクショントレーサーの詳細は（次のオプションに従って）自動的に削減されることにご注意ください。
• 4. 作成される関数セグメントの数を制限します（PHPエージェント9.xを維持します）。これは「トランザクショントレースの詳細を減らす」オプションに似ていますが、キャプチャされる関数の数に見合ったメモリ使用量の増加を犠牲にして、限られた数のPHP関数呼び出しをトレースすることもできます。（大まかな経験則として、各セグメントには約320～400バイトのヒープが必要です。）最初の5,000回の関数呼び出しをキャプチャするには、この設定を追加します：newrelic.transaction_tracer.max_segments = 5000。この設定により、設定された関数呼び出し回数以降のPHP関数は無視されます。注：数十万回のデータストアまたは外部呼び出しを行うトランザクションは、依然としてメモリの問題の影響を受ける可能性があります。

**注：これらのオプションの詳細な説明については、Explorer's Hubの投稿をご覧ください。