setCustomAttribute(ブラウザエージェントAPI)

構文

newrelic.setCustomAttribute(string $name, string OR number $value)

ユーザー定義の属性名と値を、ページ上の後続のイベントに追加します。

要件

エージェントのバージョン nr-593 以上。

説明

ユーザー定義の属性名と値を、ページの後続イベントに追加します。属性を PageView イベントに含めるために、ウィンドウロードイベントが発生する前(データが送信されるとき)にこの呼び出しを行います。一度属性が設定されると、New Relic One は、ページが再読み込みされるか、手動で属性が解除されるまで、すべての PageAction イベントとともに記録します。

SPA モニタリング と互換性のあるエージェントのバージョンを使用している場合、このコールで設定された属性は、 newrelic.interaction events にも含まれます。ただし、SPA API を使用して設定された属性は、これらの属性よりも優先されます。

カスタム属性のエラーは、 「JS Errors」ページ のイベントに含まれます。API を通じてカスタム属性のエラーを表示または記録するには、ブラウザ API の noticeError コールを使用します。

パラメータ

例

HTML要素のJavaScript/jQueryの取得

この例では、JavaScript/jQueryを使用して、Drupalで生成されたページの以下のHTML要素の値を取得します。

• <link rel="shortlink" href="/node/111" /...>
• <h1>Using NRQL</h1>

New Relic はそれらをカスタム属性として報告します。これは、New Relic One で PageView や PageAction イベントを照会する際に便利です。

var node_id = '';
node_id= jQuery("link[rel='shortlink']").attr("href");
var node_title = '';
node_title= jQuery('h1').text();

if (typeof newrelic == 'object') {
  newrelic.setCustomAttribute('nodeId', node_id);
  newrelic.setCustomAttribute('title', node_title);
}