構文
newrelic_set_user_attributes(string $user_value, string $account_value, string $product_value)
ユーザー関連のカスタム属性を作成します。newrelic_add_custom_parameterの方が柔軟性があります。
要件
エージェントのバージョン 3.1.5.111 以上。
説明
ヒント
このコールでは、既存のキーに値を割り当てることしかできません。より柔軟にキーと値のペアを作成するには、 newrelic_add_custom_parameter
をご利用ください。
リリース4.4以降、 newrelic_set_user_attributes("a","b","c");
を呼び出すことは、 newrelic_add_custom_parameter("user","a"); newrelic_add_custom_parameter("account","b"); newrelic_add_custom_parameter("product","c");
3つのパラメータはすべて必須ですが、空の文字列でもかまいません。
パラメータ
パラメーター | 説明 |
---|---|
文字列 | 必須(空の文字列でも可)。このページビューに関連付ける名前またはユーザー名を指定します。この値は、 |
文字列 | 必須(空の文字列でも可)。このページビューに関連付けるユーザーアカウントの名前を指定します。この値は、 |
文字列 | 必須(空の文字列でも可)。このページビューに関連付ける製品の名前を指定します。この値は、 |
戻り値
この関数は、属性の追加に成功した場合、 true
を返します。
例
3つのユーザー属性を記録
function example() { if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_set_user_attributes("MyUserName", "MyAccountName", "MyProductName"); }}
2つのユーザー属性と1つの空の属性を記録
function example() { if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_set_user_attributes("MyUserName", "", "MyProductName"); }}