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など)。

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();
} ?>