addToTrace

構文

newrelic.addToTrace(JavaScript object $custom_object)

カスタム名、開始時刻などのJavaScriptオブジェクトを進行中のセッショントレースに追加します。

要件

• Browser Pro または Pro+SPA エージェント (v593 以降)

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

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

  コピー

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

説明

ブラウザセッショントレース内のカスタムイベントは、トレース内の他のユーザーアクション、エラー、およびデフォルトイベントのコンテキストを提供できます。このイベントは、ブラウザセッショントレースの詳細に表示されます。

• セッショントレースが現在進行中の場合、これにより、ユーザー定義の名前、開始時刻、およびその他のオプションのフィールドを持つオブジェクトが追加されます。
• この呼び出しを行い、セッショントレースがまだ進行中でない場合、これによってブラウザがトレースをキャプチャすることはありません。

この方法で共有されるイベントの数は、ブラウザ エージェントの収集サイクルによって制限されることに注意してください。これがその制限に関する最後の更新です。

パラメーター

例

var obj = {
  // REQUIRED
  name: 'Event Name',
  start: 1417044274239, // Time in ms since epoch

  // OPTIONAL
  end: 1417044274252,
  // Time in ms since epoch. Defaults to same as start resulting in trace object with a duration of zero.
  origin: 'Origin of event',
  // Defaults to empty string
  type: 'What type of event was this'
  // Defaults to empty string
};