setCurrentRouteName (SPA API)

構文

newrelic.setCurrentRouteName(string $name)

SPA ルートにデフォルトの名前よりも正確な名前をつける。デフォルトのグループ化ではなく、特定のルートを監視します。

要件

• ブラウザ Pro+SPA エージェント (v998 以降)

• npm を使用してブラウザ エージェントをインストールしている場合は、 BrowserAgentクラスをインスタンス化するときにspa機能を有効にする必要があります。features配列に以下を追加します。

  import { Spa } from '@newrelic/browser-agent/features/spa';
  
  const options = {
    info: { ... },
    loader_config: { ... },
    init: { ... },
    features: [
      Spa
    ]
  }

  コピー

  詳細については、 npm ブラウザのインストールに関するドキュメントを参照してください。

説明

このメソッドは、現在のルートに名前を付けます。これは次のような場合に便利です。

• ルートにデフォルトよりも正確な名前をつける。
• デフォルトでは他のルートとグループ化されている可能性のあるルートを監視します。

現在、このメソッドは SPA BrowserInteractionイベントにのみ適用されます。この API を使用すると、以前のルートとターゲット ルートを追跡する 2 つの新しいカスタム属性が作成されます。

• previousRouteName
• targetRouteName

この API を使用する場合、 browserInteractionName属性はtargetRouteName値を取ります。setNameを使用してブラウザー インタラクション名を設定すると、それが優先されます。

setCurrentRouteName() API はBrowserInteractionイベントの名前属性を決定するため、ルートが変更されるたびにこの API を呼び出す必要があります。これにより、 BrowserInteractionイベントが正しい属性を持つことが保証されます。

パラメーター

例

router.onChange(function(route) {
  newrelic.setCurrentRouteName(route.name);
});