• EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

newrelic_add_custom_parameter (API del agente PHP)

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

$key

cadena

Requerido. El nombre del atributo personalizado. Sólo se conservan los primeros 255 caracteres.

$value

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.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.