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
};