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

構文

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

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

要件

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

説明

ページ上の後続のイベントにユーザー定義の属性名と値を追加します。属性をPageViewイベントに含めるために、ウィンドウロードイベントが発生する前（そのデータが送信されるとき）にこの呼び出しを行います。属性が設定されると、New Relicプラットフォームは、ページがリロードされるか、属性が手動で設定解除されるまで、すべてのPageActionイベントとともに属性を記録します。

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

カスタム属性のエラーは、 JSエラーページのイベントに含まれます。 APIを介してカスタム属性のエラーを表示またはログに記録するには、ブラウザAPIのnoticeError呼び出しを使用します。

パラメーター

例

HTML要素のJavaScript/jQueryの取得

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

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

New Relicは、それらをカスタム属性として報告します。これは、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);
}