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 ou fonction | Facultatif. Le nom de la transaction. Il pourrait s’agir d’une fonction qui accepte un paramètre callable_name. La valeur par défaut est |
chaîne ou fonction | Facultatif. Le S'il n'est pas fourni, le groupe prend par défaut la valeur |
chaîne ou fonction | Facultatif. La partie schéma de l'URL de la requête. Peut être une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
chaîne ou fonction | Facultatif. La partie hôte de l'URL de la requête. Peut être une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
entier ou fonction | Facultatif. La partie port de l'URL de la requête. Il peut s'agir d'une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
chaîne ou fonction | Facultatif. La méthode de requête HTTP, telle que GET ou POST. Peut être une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
chaîne ou fonction | Facultatif. Le reste du chemin de l'URL de la requête. Il peut s'agir d'une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
chaîne ou fonction | Facultatif. La partie de l'URL de la requête qui suit le point d'interrogation. Peut être une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
itérable ou dict ou fonction | Facultatif. Les en-têtes de requête HTTP Un itérable d’itérables à deux éléments [name, value] 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. |
chaîne ou fonction | Facultatif. Le nom de la transaction. Il pourrait s’agir d’une fonction qui accepte un paramètre callable_name. La valeur par défaut est |
chaîne ou fonction | Facultatif. Le S'il n'est pas fourni, le groupe prend par défaut la valeur |
chaîne ou fonction | Facultatif. La partie schéma de l'URL de la requête. Peut être une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
chaîne ou fonction | Facultatif. La partie hôte de l'URL de la requête. Peut être une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
entier ou fonction | Facultatif. La partie port de l'URL de la requête. Il peut s'agir d'une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
chaîne ou fonction | Facultatif. La méthode de requête HTTP, telle que GET ou POST. Peut être une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
chaîne ou fonction | Facultatif. Le reste du chemin de l'URL de la requête. Il peut s'agir d'une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
chaîne ou fonction | Facultatif. La partie de l'URL de la requête qui suit le point d'interrogation. Peut être une fonction qui accepte les mêmes paramètres que la fonction encapsulée. |
itérable ou dict ou fonction | Facultatif. Les en-têtes de requête HTTP Un itérable d’itérables à deux éléments [name, value] ou dict de |
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)