重要
この API を使用するには、ブラウザ エージェントの Browser Pro+SPA エディションが必要です。
構文
newrelic.setCurrentRouteName(string $name)
SPA ルートにデフォルトの名前よりも正確な名前をつける。デフォルトのグループ化ではなく、特定のルートを監視します。
要件
エージェントのバージョン nr-998 以上。
説明
このメソッドは、現在のルートに名前を付けます。これは次のような場合に便利です。
- ルートにデフォルトよりも正確な名前をつける。
- デフォルトでは他のルートとグループ化されている可能性のあるルートを監視します。
現在、このメソッドは SPA BrowserInteraction
イベントにのみ適用されます。この API を使用すると、以前のルートとターゲット ルートを追跡する 2 つの新しいカスタム属性が作成されます。
previousRouteName
targetRouteName
この API を使用する場合、 browserInteractionName
属性はtargetRouteName
値を取ります。setName
を使用してブラウザー インタラクション名を設定すると、それが優先されます。
setCurrentRouteName()
API はBrowserInteraction
イベントの名前属性を決定するため、ルートが変更されるたびにこの API を呼び出す必要があります。これにより、 BrowserInteraction
イベントが正しい属性を持つことが保証されます。
ヒント
ルートではなくブラウザ インタラクションの名前を設定するsetName()
と比較してください。
パラメーター
パラメータ | 説明 |
---|---|
ストリング | 必須項目です。ページの現在のルート名。
|
例
router.onChange(function(route) { newrelic.setCurrentRouteName(route.name);});