Syntaxe
newrelic.agent.web_transaction(application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)Utilisé pour instrumenter un Web de transactions.
Exigences
Version de l'agent 4.16.0.116 ou supérieure
Description
Ce décorateur Python peut être utilisé pour instrumenter les transactions Web. Les transactions marquées avec ce décorateur sont affichées dans l'UI APM sous la transaction Web et sont distinctes des transactions non Web.
Si vous ne pouvez pas utiliser le décorateur, l’un de ces formats d’appel peut être plus utile :
- The wrapper:Si vous savez à l'avance où se trouvent les fonctions spécifiques que vous souhaitez suivre, vous pouvez utiliser le décorateur
web_transaction. Mais si vous ne connaissez pas toutes les fonctions qui doivent être tracées (par exemple, si elles sont recherchées dynamiquement dans le cadre d'un système de routage), vous devez alors utiliserWebTransactionWrapperpour encapsuler la fonction au moment de l'enregistrement ou au moment de l'appel. - The path-based wrapper: La forme wrapper basée sur le chemin est
wrap_web_transaction.
Pour en savoir plus sur les différences et les utilisations de ces formes de fonctions, consultez Formats d'appel de variables.
Paramètres
Paramètre du décorateur
newrelic.agent.web_transaction(application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)paramètre pour ces appels :
paramètres | Description |
|---|---|
instanced'application | Facultatif. L'application sous laquelle les données seront signalées. Si aucune valeur n'est définie, l'application spécifiée dans la configuration de l'agent (fichier de configuration ou variable d'environnement) sera utilisée. Pour en savoir plus sur la génération d’un objet d’application, consultez la méthode |
chaîne | Facultatif. Le nom de la transaction. Par défaut, le nom sera le nom de la fonction à laquelle le décorateur a été appliqué, mais vous pouvez le remplacer en fournissant ce nom. |
chaîne | Facultatif. Le Si ce paramètre n'est pas fourni, le groupe prend par défaut la valeur |
chaîne | Facultatif. La partie schéma de l'URL de la demande |
chaîne | Facultatif. La partie hôte de l'URL de la demande |
entier | Facultatif. La partie port de l'URL de la requête |
chaîne | Facultatif. La méthode de requête HTTP, telle que GET ou POST |
chaîne | Facultatif. Le reste du chemin de l'URL de la requête |
chaîne | Facultatif. La partie de l'URL de la demande qui suit le point d'interrogation |
itérable ou dict | Facultatif. Les en-têtes de requête HTTP Un itérable de [name, value] à deux éléments itérables ou dict de |
Paramètre de l'enveloppe :
newrelic.agent.WebTransactionWrapper(wrapped, application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)WebTransactionWrapper prend le même paramètre que le décorateur web_transaction et ce paramètre wrapped supplémentaire :
paramètres | Description |
|---|---|
méthode | Requis. La méthode à tracer. |
Paramètre basé sur le chemin :
newrelic.agent.wrap_web_transaction(module, object_path, application=None, name=None, group=None, scheme=None, host=None, port=None, request_method=None, request_path=None, query_string=None, headers=None)wrap_web_transaction prend le même paramètre que le décorateur web_transaction plus ces paramètres supplémentaires :
paramètres | Description |
|---|---|
module ou chaîne | Requis. Le module contenant la fonction/activité web pour laquelle vous êtes instrumenté. |
chaîne | Requis. Le chemin vers le module. |
Exemples
web_transaction
Voici un exemple d'utilisation du décorateur web_transaction :
@newrelic.agent.web_transaction()def get(): ...WebTransactionWrapper
Un exemple d'utilisation du WebTransactionWrapper:
task = newrelic.agent.WebTransactionWrapper(get_next_task())result = task(*args, **kwargs)