PHPフレームワーク。New Relic のサポートを統合しました。

このドキュメントは、PHP フレームワークの開発者やメンテナを対象としています。New Relic のサポートを追加してフレームワークを拡張する方法を提案します。

PHPエージェントは、フレームワークをサポートするために、 フレームワークのコードのどこにWebトランザクションが適切な名前を つけられるかを把握し、クラスや関数の呼び出しなどの情報に基づいて Webトランザクションを命名します。このソリューションは脆弱で、開発者がコードを変更した場合に影響を受けます。New Relic は、フレームワークの開発者に対して、自分が保守しているフレームワークのアウトオブボックスのユーザーエクスペリエンスを向上させるために必要ないくつかのコールを行うことを推奨しています。

ユーザーのために

New Relic は、New Relic のブラウザモニタリングのために、ウェブトランザクション名と、JavaScript のヘッダーとフッターを挿入する場所を特定することができます。しかし、エンドユーザーの体験を向上させ、パフォーマンスを向上させ、コードのメンテナンスを容易にするためには、フレームワークの開発者が自らこの作業を行うべきである。

New Relic のネイティブサポートを追加してユーザーを支援するかどうかは、さまざまなフレームワークの開発者に委ねられています。ほとんどの場合、New Relicのサポートを追加するには、フレームワークのコードのどこかに3つのAPIコールを挿入する必要があります。

用語解説

New Relic のサポートを追加する最善の方法を理解するためには、相互作用の重要なポイントを理解することが役立ちます。

名義変更

ウェブ取引にどのように名前を付けるかは、ユーザー体験の質に影響します。

例：

ブログ形式のフレームワークであれば、ユーザーの活動に応じて様々なトランザクションに名前を付けます。 display, edit, login, etc.

MVCアーキテクチャを使用する場合、適切な命名規則はcontroller/actionです。トランザクション名にリクエスト固有のデータを含めないでください。たとえば、実際のリクエストURLを使用すると、メトリックのグループ化の問題が発生します。

コードを特定のコントローラとアクション（MVCを使用している場合）、またはアクション（MVCを使用していない場合）にルーティングしたいポイントで、以下のようなコードを挿入します。

コントローラーとアクション （MVCを使用している場合）。

if (extension_loaded ('newrelic')) {
  newrelic_name_transaction ($controller . '/' . $action);
}

アクションのみ （MVCを使用していない）。

if (extension_loaded ('newrelic')) {
  newrelic_name_transaction ($action);
}

JavaScriptのヘッダーとフッターの挿入

ページのロードタイミング（リアルユーザーモニタリング（RUM）と呼ばれることもあります）については、JavaScriptのヘッダとフッタを挿入します。これにより、生成されたページに対するエンドユーザーの体験をモニターすることができます。

• 推奨： フレームワークにすべてのページのヘッダーとフッターを生成する中央機能がある場合は、ここにJavaScriptのコードをインストールします。
• テンプレート駆動型のフレームワークでは、ヘッダーやフッターのテンプレートに挿入します。

if (extension_loaded ('newrelic')) {
  echo newrelic_get_browser_timing_header();
}

if (extension_loaded ('newrelic')) {
    echo newrelic_get_browser_timing_footer();
}

<?php if (extension_loaded ('newrelic')) {
  echo newrelic_get_browser_timing_header();
} ?>

<?php if (extension_loaded ('newrelic')) {
  echo newrelic_get_browser_timing_footer();
} ?>