ブラウザ API の使用

ブラウザー API を使用すると、ブラウザーの監視をカスタマイズおよび拡張できます。API の使用を開始するには、監視するすべてのページにブラウザエージェントが存在することを確認します。

以下は、各ブラウザ API メソッドの使用例です。

トレースとイベント

トレースやイベントを監視するには、次のような方法があります。

あなたがしたい場合は...	この API を使用する
New Relic が自動的に追跡しないアクションを追跡する	`newrelic.addPageAction()`
進行中のセッショントレースにオブジェクトを追加する。	`newrelic.addToTrace()`
独自の基準でページが終了した時点を記録する	`newrelic.finished()`
ページ上の後続のイベントに属性名と値を追加する	`newrelic.setCustomAttribute()`
ページ上の後続のイベントにアプリケーションのバージョン情報を追加します。	`newrelic.setApplicationVersion()`
ページ名を設定してページビューをグループ化	`newrelic.setPageViewName()`
ページ上の後続のイベントにユーザー ID 情報を追加します。	`newrelic.setUserId()`

アプリケーションのエラーを報告するには、以下の方法があります。

あなたがしたい場合は...	この API を使用する
アプリのバージョン情報でタグエラー	`newrelic.addRelease()`
アプリの動作を停止させることなく、キャッチしたエラーや処理したエラーを記録する	`newrelic.noticeError()`
既知のエラーを選択的に無視する	`newrelic.setErrorHandler()`

シングルページアプリケーションをトラッキングするには、以下のSPA APIメソッドを使用します。

あなたがしたい場合は...	この API を使用する
SPA インタラクションの`actionText` (クリックされた HTML 要素のテキスト) を設定します。	`newrelic.interaction().actionText()`
SPAのサブコンポーネントのトレースインタラクション個別に	`newrelic.interaction().createTracer()`
SPA インタラクションの終了	`newrelic.interaction().end()`
現在のインタラクションに関連する集計データ	`newrelic.interaction().getContext()`
インタラクションを無視する	`newrelic.interaction().ignore()`
現在ののインタラクションにバインドされた新しい API オブジェクトを返します。	`newrelic.interaction()`
インタラクションが記録される前に、名前や無視された属性などの属性を調整する。	`newrelic.interaction().onEnd()`
ブラウザインタラクションが終了したときに確実に保存されるようにする。	`newrelic.interaction().save()`
現在のインタラクションにカスタム属性を追加する	`newrelic.interaction().setAttribute()`
SPAルートにデフォルトの名前よりも正確な名前をつける	`newrelic.interaction().setCurrentRouteName`

エージェントの収集動作を制御するには、次の API メソッドを使用します。

あなたがしたい場合は...	この API を使用する
手動でトリガーされるまで機能が収集されないようにします	`newrelic.start()`