Sintaxis
newrelic_add_custom_parameter(string $key, scalar $value)Adjunta un atributo personalizado (par de valor principal) a la transacción actual y al intervalo actual (si está habilitado).
Requisitos
Versión del agente 4.4.5.35 o superior.
Descripción
Agregue un atributo personalizado (un par de datos clave y de valor) a la transacción web actual. (El nombre de la llamada es newrelic_add_custom_parameter porque "atributo personalizado" anteriormente se llamaba "parámetro personalizado"). Por ejemplo, puede agregar el nombre completo de un cliente desde su base de datos de clientes. Este atributo aparece en cualquier traza de la transacción que resulte de esta transacción. También puedes consultar el evento de transacción para tu atributo personalizado.
Importante
Recomendación de seguridad: revise la configuración de su atributo Transaction. Cualquier atributo que incluya o excluya configuraciones específicas del evento Transaction debe aplicarse a su configuración de atributo Span o a su configuración de Atributos Globales.
Importante
Si desea utilizar su atributo personalizado, evite utilizar cualquiera de los términos reservados utilizados por NRQL.
Parámetros
Parámetro | Descripción |
|---|---|
cadena | Requerido. El nombre del atributo personalizado. Sólo se conservan los primeros 255 caracteres. |
escalar | Requerido. El valor que se asociará con este atributo personalizado. Si el valor dado es un float con un valor de NaN, Infinito, denorm o cero negativo, el comportamiento de esta función no está definido. Para otros valores de punto flotante, el agente puede descartar 1 o más bits de precisión (ULP) del valor dado. |
Valores de retorno
Devuelve verdadero si el parámetro se agregó correctamente.
Ejemplos
Informar una variable como valor
if (extension_loaded('newrelic')) { // Ensure PHP agent is available // Record custom data about this web transaction newrelic_add_custom_parameter('user_email', $user_email);}Varias llamadas
Si llama newrelic_add_custom_parameter varias veces con el mismo valor para el parámetro $key en la misma transacción web, el $value de la última llamada tiene prioridad. El valor de la última llamada se registra como atributo personalizado en la transacción web.
Por ejemplo, si el código se ve así:
if (extension_loaded('newrelic')) { // Ensure PHP agent is available // Record custom data about this web transaction newrelic_add_custom_parameter('user_email', billy@newrelic.com); newrelic_add_custom_parameter('user_email', samantha@newrelic.com);}El valor samantha@newrelic.com se registra como el atributo personalizado user_email en la transacción web y se sobrescribe billy@newrelic.com de la llamada anterior.