構文
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)})