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

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

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

ユーザーのために

New Relic 、ウェブトランザクション名と、 New Relicの ブラウザ監視の JavaScript ヘッダーとフッターを挿入する場所を識別できます。 ただし、エンドユーザーのエクスペリエンスを向上させ、パフォーマンスを高め、コードのメンテナンスを容易にするために、フレームワーク開発者が自らこの作業を行う必要があります。

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

用語解説

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

名前トランザクション

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

Examples:

ブログ スタイルのフレームワークがある場合は、ユーザー アクティビティに基づいてさまざまなトランザクションに名前を付けます ( display、 edit、 loginなど)。

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

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

Controller and action (MVC を使用する場合):

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

Action only (MVC を使用しない):

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

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

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

• Recommendation:

  フレームワークにすべてのページ ヘッダーとフッターを生成する中心的な機能がある場合は、ここに 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();
} ?>