構文
newrelic_add_custom_span_parameter(string $key, scalar $value)カスタム属性（キーと値のペア）を現在のスパンに付加します。
要件
エージェントのバージョン 9.12.0.268 以上。
説明
カスタム属性 (キーと値のデータ ペア) を現在のスパンに追加します。(「カスタム属性」は以前は「カスタム パラメータ」と呼ばれていたため、呼び出し名は newrelic_add_custom_span_parameter です。)たとえば、顧客データベースから顧客のフルネームを追加できます。この属性はどのスパンにも表示されます。カスタム属性の スパンを クエリすることもできます。
重要
スパンでは、 newrelic_add_custom_span_parameter で追加された属性は、 newrelic_add_custom_parameterで追加された属性より優先されます。
重要
カスタム属性を使用したい場合は、NRQLで使用されている 予約語の使用を避けてください 。
パラメーター
パラメータ | 説明 |
|---|---|
ストリング | 必須項目です。カスタム属性の名前です。最初の255文字のみが保持されます。 |
スカラー | 必須。このカスタム属性に関連付ける値です。 指定された値が NaN、Infinity、非正規化数、または負のゼロの値を持つfloatである場合、この関数の動作は未定義になります。 その他の浮動小数点値の場合、エージェントは指定された値から 1 ビット以上の精度 (ULP) を破棄する場合があります。 |
戻り値
パラメータの追加に成功した場合はtrueを返します。
例
変数の値を報告する
if (extension_loaded('newrelic')) { // Ensure PHP agent is available // Record custom data about this web transaction newrelic_add_custom_span_parameter ('user_email', $user_email);}