構文
newrelic.setPageViewName(string $name[, string $host])
ページビューをグループ化して、URLの構造を助けたり、URLのルーティング情報を取得したりします。
要件
ブラウザ Lite、Pro、または Pro+SPA エージェント (v593 以降)
npm を使用してブラウザ エージェントをインストールしている場合は、
BrowserAgent
クラスをインスタンス化するときに少なくとも 1 つの機能を有効にする必要があります。たとえば、次をfeatures
配列に追加します。import { Metrics } from '@newrelic/browser-agent/features/metrics'const options = {info: { ... },loader_config: { ... },init: { ... },features: [Metrics]}詳細については、 npm ブラウザのインストールに関するドキュメントを参照してください。
説明
URL 構造で有用なグループ化が提供されない場合、またはブラウザ エージェントがルーティング情報が保存されている URL の部分をキャプチャしない場合、カスタマイズされたページ名を使用すると、ページ ビューをより効果的にグループ化することができます。PageView
イベントをクエリすると、カスタム名がbrowserTransactionName
属性として公開されます。カスタム名は UI。
ページ URL の代わりにカスタマイズされたページ ビュー名を使用するには、名前をスラッシュで区切られた文字列としてフォーマットします。正しく表示するには、 window load
イベントが発生する前にこの呼び出しを行ってください。
ヒント
この API 呼び出しは、ブラウザの標準ページ ビューとPageView
イベントのデータに適用されます。SPA ページ ビューとBrowserInteraction
イベントのカスタム名を設定するには、 SPA: setNameを参照してください。両方の呼び出しを一緒に使用することをお勧めします。
パラメーター
パラメータ | 説明 |
---|---|
ストリング | 必須項目です。使用するページ名です。半角英数字で入力してください。 |
ストリング | オプション。デフォルトは これらのカスタム トランザクションをさらにグループ化するには、カスタム |
例
newrelic.setPageViewName('/login')// Ornewrelic.setPageViewName('/login', 'https://www.myapp.com')