• ログイン今すぐ開始

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

newrelic_name_transaction (PHP エージェント API)

構文

newrelic_name_transaction(string $name)

現在のトランザクションのカスタム名を設定します。

要件

すべてのAgentバージョンに対応しています。

トランザクションの中で呼び出す必要があります

説明

トランザクションの名前を、指定された名前に設定します。これは、独自のディスパッチ方式を実装していて、目的に応じてトランザクションに名前を付けたい場合に便利です。この関数は、できるだけ早い段階で呼び出してください。

重要

トランザクション名の末尾に角かっこ[suffix]を使用しないでください。 New Relicは、名前から角かっこを自動的に削除します。代わりに、必要に応じて括弧(suffix)またはその他の記号を使用してください。

URL、ページ タイトル、16 進値、セッション ID、および一意に識別可能な値などの一意の値は、トランザクションの名前付けに使用しないでください。代わりに、そのデータをnewrelic_add_custom_parameter()呼び出しでカスタム パラメータとしてトランザクションに追加してください。

重要

1000以上のユニークなトランザクション名を作成しないでください(例えば、可能な限りURLでの命名は避けてください)。これはチャートの使い勝手を悪くしますし、New Relic が設定しているアカウントごとのユニークなトランザクション名の数の制限に抵触する可能性があります。また、アプリケーションのパフォーマンスが低下する可能性があります。

パラメーター

パラメータ

説明

$name

ストリング

必須項目です。トランザクションの名前。

戻り値

トランザクション名が正常に変更された場合、 trueを返します。falseが返された場合は、エージェント ログで詳細を確認してください。

一般的なトランザクションのネーミング

/product/123/product/234があります。それぞれに個別のトランザクション名を生成すると、New Relic はこれら 2 つのトランザクション名の個別の情報を保存します。代わりに、トランザクションを/product/*として保存するか、 /Product/viewなど、コード自体に関する重要な名前を使用してトランザクションに名前を付けます。

function example() {
if (extension_loaded('newrelic')) { // Ensure PHP agent is available
newrelic_name_transaction("/Product/view/");
}
...
}

MVCフレームワークのネーミング

MVC フレームワークでは、リクエストがルーティングされる場所でnewrelic_name_transaction()呼び出しを使用し、コントローラ/アクション形式でトランザクションに名前を付けることをお勧めします。

Copyright © 2023 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.