• ログイン今すぐ開始

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

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呼び出しを使用します。

パラメーター

パラメータ

説明

$name

ストリング

必須。属性の名前。 PageViewイベントの列として表示されます。使用している場合は、 PageActionイベントの列としても表示されます。

予約済みのNRQLワード を属性/値の名前をつけるときに使わないようにしましょう。

$value

文字列 OR 整数

必須。属性の値。 PageViewイベントの名前付き属性列に値として表示されます。使用している場合は、 PageActionイベントの列として表示されます。カスタム属性値を複雑なオブジェクトにすることはできません。文字列や整数などの単純なタイプのみにすることができます。

予約済みのNRQLワード を属性/値の名前をつけるときに使わないようにしましょう。

HTML要素のJavaScript/jQueryの取得

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

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

New Relic はそれらをカスタム属性として報告します。これは、 PageViewおよびPageActionイベントのクエリに役立ちます。

var node_id = jQuery("link[rel='shortlink']").attr("href");
var node_title = jQuery('h1').text();
if (typeof newrelic == 'object') {
newrelic.setCustomAttribute('nodeId', node_id);
newrelic.setCustomAttribute('title', node_title);
}
Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.