• English日本語한국어
  • ログイン今すぐ開始

この機械翻訳は参考用に提供されます。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、 を参照してください。

問題を作成する

setCustomAttribute

重要

この API は、どのブラウザー エディション (Browser Lite、Pro、または Pro+SPA) でも機能します。

構文

newrelic.setCustomAttribute(name: string, value: string|number|null[, persist: boolean])

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

要件

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

persist パラメータまたは null 値のサポートには、エージェント バージョン 1.230.0 以降が必要です。

説明

属性が PageView イベントに含まれるようにするには、ウィンドウ ロード イベントが発生する前 (そのデータが送信されるとき) にこの呼び出しを行います。属性が設定されると、New Relic プラットフォームは、ページがリロードされるか属性が手動で設定解除されるまで、すべてのイベントとともにそれを記録します。

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

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

persist フラグを使用すると、属性をブラウザに保存することもできます。これにより、 セッション スパン内の 同じ オリジンの後続のページ アクセスがイベントで保持されます。この機能は、エンドユーザーのブラウザーのプライバシー設定によって変動する可能性があることに注意してください。この関数が value = nullで呼び出された場合、 persist フラグに 関係なく 、現在のページのイベントとストレージの 両方 から属性が削除されます。

重要

永続化された属性は、同じ名前の info.jsAttributes キーよりも優先されることに注意してください!たとえば、 somedomain.com/pageA に設定された永続属性 someNamesomedomain.com/pageBの情報ブロックに静的に設定された someName をオーバーライドします。これらは同じ (セッション) ストレージを共有すると仮定します。

パラメーター

パラメータ

説明

name

ストリング

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

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

value

文字列 OR 整数 OR null

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

null 値を渡すと、同じ名前の既存の属性が設定解除されます。

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

persist

ブール値

オプション。 trueに設定すると、名前と値のペアもブラウザのストレージ API に設定されます。次に、同じセッション内でロードされる次のインストルメント化されたページで、ペアがカスタム属性として再適用されます。

デフォルトは falseです。

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 © 2023 New Relic Inc.

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