構文
newrelic_name_transaction(string $name)現在のトランザクションのカスタム名を設定します。
要件
すべてのAgentバージョンに対応しています。
説明
トランザクションの名前を、指定された名前に設定します。これは、独自のディスパッチ方式を実装していて、目的に応じてトランザクションに名前を付けたい場合に便利です。この関数は、できるだけ早い段階で呼び出してください。
重要
トランザクション名の末尾に角かっこ[suffix]を使用しないでください。 New Relicは、名前から角かっこを自動的に削除します。代わりに、必要に応じて括弧(suffix)またはその他の記号を使用してください。
URL、ページ タイトル、16 進値、セッション ID、および一意に識別可能な値などの一意の値は、トランザクションの名前付けに使用しないでください。代わりに、そのデータをnewrelic_add_custom_parameter()呼び出しでカスタム パラメータとしてトランザクションに追加してください。
重要
1000以上のユニークなトランザクション名を作成しないでください（例えば、可能な限りURLでの命名は避けてください）。これはチャートの使い勝手を悪くしますし、New Relic が設定しているアカウントごとのユニークなトランザクション名の数の制限に抵触する可能性があります。また、アプリケーションのパフォーマンスが低下する可能性があります。
パラメーター
パラメータ | 説明 |
|---|---|
ストリング | 必須項目です。トランザクションの名前。 |
戻り値
トランザクション名が正常に変更された場合、 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()呼び出しを使用し、コントローラ/アクション形式でトランザクションに名前を付けることをお勧めします。