Sintaxis
newrelic.agent.profile_trace(name=None, group=None, label=None, params=None, depth=3)Agrega un atributo adicional a la función de nombres de trazas.
Descripción
profile_trace se utiliza para agregar más detalles a su traza de la transacción en forma de segmentos adicionales. Cualquier llamada reportada con profile_trace aparecerá en la página de base de datos de APM. profile_trace devuelve una parte de ProfileTraceWrapper que se puede usar como decorador para que una función programe las llamadas a su generador de perfiles.
Si no puede utilizar el decorador en su aplicación, puede utilizar el siguiente formato de llamada: El formulario contenedor es ProfileTraceWrapper. Se puede utilizar para devolver una función envuelta sin el uso de un decorador.
Para obtener una explicación de los usos de estos diferentes formatos de llamadas, consulte Diferentes formatos de llamadas. Consulte Ejemplos para ver ejemplos de llamadas.
Importante
Las funciones solo se instrumentan en el alcance de la llamada de función especificada. Si una función function_a es traza y llama a function_b esto solo será instrumentado dentro del alcance de function_a y no en ningún otro lugar donde se llame a function_b pero no a traza.
Parámetros
Parámetro para decorador
newrelic.agent.profile_trace(name=None, group=None, label=None, params=None, depth=3)Esta convocatoria incluye estos parámetros:
Parámetro | Descripción |
|---|---|
cadena | Opcional. El nombre de la función. Si no se establece, el valor predeterminado es el nombre capturado de la función. |
cadena | Opcional. El Si no se proporciona, el grupo tomará de forma predeterminada |
cadena | Opcional. Agrega una bandera de estilo rótulo al segmento en una traza de la transacción. El valor predeterminado es |
dict | Opcional. Parámetro personalizado para agregar al segmento en la traza de la transacción. |
dict | Opcional. parámetro para la función máxima profundidad de traza. El valor predeterminado es 3. |
Parámetro de envoltura
newrelic.agent.ProfileTraceWrapper(wrapped, name=None, group=None, label=None, params=None, depth=3)Los parámetros para el contenedor incluyen todos los parámetros para profile_trace y un parámetro wrapped :
Parámetro | Descripción |
|---|---|
función | Requerido. La función que se está envolviendo. |
Ejemplos
profile_trace ejemplo
Un ejemplo de uso del decorador profile_trace :
import newrelic.agent
@newrelic.agent.profile_trace()def some_function(): ...Ejemplo de contenedor
Un ejemplo de uso de ProfileTraceWrapper:
import newrelic.agent
def another_function(): wrapped_function = newrelic.agent.ProfileTraceWrapper(some_function) ... wrapped_function() ...