Sintaxis
newrelic_add_custom_span_parameter(string $key, scalar $value)Adjunta un atributo personalizado (par principal de valor) al intervalo actual.
Requisitos
Versión del agente 9.12.0.268 o superior.
Descripción
Agregue un atributo personalizado (un par de datos de clave y valor) al intervalo actual. (El nombre de la llamada es newrelic_add_custom_span_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 intervalo. También puedes consultar el Span para tu atributo personalizado.
Importante
En intervalos, el atributo agregado con newrelic_add_custom_span_parameter tendrá prioridad sobre el atributo agregado con newrelic_add_custom_parameter.
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_span_parameter ('user_email', $user_email);}