重要
この API を使用するには、ブラウザ エージェントの Browser Pro または Pro+SPA エディションが必要です。
構文
newrelic.addToTrace(JavaScript object $custom_object)
カスタム名、開始時刻などのJavaScriptオブジェクトを進行中のセッショントレースに追加します。
要件
エージェントバージョンnr-593以降。
説明
ブラウザセッショントレース内のカスタムイベントは、トレース内の他のユーザーアクション、エラー、およびデフォルトイベントのコンテキストを提供できます。このイベントは、ブラウザセッショントレースの詳細に表示されます。
- セッショントレースが現在進行中の場合、これにより、ユーザー定義の名前、開始時刻、およびその他のオプションのフィールドを持つオブジェクトが追加されます。
- この呼び出しを行い、セッショントレースがまだ進行中でない場合、これによってブラウザがトレースをキャプチャすることはありません。
この方法で共有されるイベントの数は、ブラウザエージェントのハーベストサイクルによって制限されることに注意してください。 これがその制限に関する最後の更新です。
パラメーター
パラメータ | 説明 |
---|---|
JavaScriptオブジェクト | 必須。これらの必須およびオプションの名前/値ペアをJavaScriptオブジェクトに提供します。
|
例
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};