• ログイン無料アカウント

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

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

問題を作成する

newrelic_add_custom_parameter (PHP エージェント API)

構文

newrelic_add_custom_parameter(string $key, scalar $value)

カスタム属性(キーと値のペア)を現在のトランザクションと現在のスパン(有効な場合)に付けます。

要件

エージェントのバージョン 4.4.5.35 以上。

説明

現在のウェブトランザクションに カスタム属性 (キーと値のデータペア)を追加します。(コールネームは newrelic_add_custom_parameter です。これは"カスタム属性" が以前は"カスタムパラメータと呼ばれていたためです。") 例えば、顧客データベースから顧客のフルネームを追加することができます。この属性は、このトランザクションに起因するすべてのトランザクショントレースに表示されます。また、カスタム属性を Transaction イベントに照会することもできます。

重要

セキュリティに関する推奨事項:Transaction属性の設定を確認してください。トランザクション・イベントに特化した属性の包含・除外設定は、Span属性設定またはGlobal属性設定に適用する必要があります。

重要

カスタム属性を使用したい場合は、NRQLで使用されている 予約語の使用を避けてください

パラメータ

パラメーター

説明

キー

文字列

必須項目です。カスタム属性の名前です。最初の255文字のみが保持されます。

$value

スカラー

必須。このカスタム属性に関連付ける値です。

与えられた値が float で、値が NaN、Infinity、denorm、または負のゼロの場合、この関数の動作は不定です。その他の浮動小数点値の場合、エージェントは与えられた値から1ビット以上の精度(ULP)を捨てることができます。

戻り値

パラメータの追加に成功した場合はtrueを返します。

変数の値を報告する

...
if (extension_loaded('newrelic')) { // Ensure PHP agent is available
// Record custom data about this web transaction
newrelic_add_custom_parameter ('user_email', $user_email);
}
...

-->

Copyright © 2022 New Relic Inc.