Syntaxe
newrelic.agent.profile_trace(name=None, group=None, label=None, params=None, depth=3)Ajoute un attribut supplémentaire aux noms trace de fonction.
Description
profile_trace est utilisé pour ajouter plus de détails à votre trace de transaction sous forme de segments supplémentaires. Tous les appels signalés avec profile_trace apparaîtront sur la page de base de donnéesAPM . profile_trace renvoie une partie de ProfileTraceWrapper qui peut être utilisée comme décorateur pour une fonction afin de chronométrer les appels à votre profileur.
Si vous ne pouvez pas utiliser le décorateur dans votre application, vous pouvez utiliser le format d'appel suivant : Le format wrapper est ProfileTraceWrapper. Il peut être utilisé pour renvoyer une fonction encapsulée sans l'utilisation d'un décorateur.
Pour une explication des utilisations de ces différents formats d’appel, voir Différents formats d’appel. Voir Exemples pour des exemples d'appel.
Important
Les fonctions ne sont instrumentées que dans le cadre de l'appel de fonction spécifié. Si une fonction function_a est trace et qu'elle appelle function_b, elle ne sera instrumentée que dans le cadre de function_a et nulle part ailleurs où function_b est appelé mais pas trace.
Paramètres
paramètre pour le décorateur
newrelic.agent.profile_trace(name=None, group=None, label=None, params=None, depth=3)Cet appel inclut ces paramètres :
paramètres | Description |
|---|---|
chaîne | Facultatif. Le nom de la fonction. Si non défini, la valeur par défaut est le nom capturé de la fonction. |
chaîne | Facultatif. Le Si ce paramètre n'est pas fourni, le groupe sera défini par défaut sur |
chaîne | Facultatif. Ajoute un indicateur de style légende au segment dans une trace de transaction. La valeur par défaut est |
dict | Facultatif. Paramètre personnalisé à ajouter au segment dans la trace de transaction. |
dict | Facultatif. paramètre pour la profondeur maximale trace de fonction. La valeur par défaut est 3. |
Paramètres de l'enveloppe
newrelic.agent.ProfileTraceWrapper(wrapped, name=None, group=None, label=None, params=None, depth=3)Le paramètre du wrapper inclut tous les paramètres de profile_trace et un paramètre wrapped :
paramètres | Description |
|---|---|
fonction | Requis. La fonction en cours d'encapsulation. |
Exemples
profile_trace
Un exemple d'utilisation du décorateur profile_trace :
import newrelic.agent
@newrelic.agent.profile_trace()def some_function(): ...Exemple d'enveloppe
Un exemple d'utilisation du ProfileTraceWrapper:
import newrelic.agent
def another_function(): wrapped_function = newrelic.agent.ProfileTraceWrapper(some_function) ... wrapped_function() ...