Syntaxe
newrelic.agent.set_background_task(flag=True)Marque une transaction comme une « tâche d'arrière-plan ».
Description
Cet appel classe une transaction comme une « tâche d'arrière-plan ». Les transactions marquées comme tâches d'arrière-plan sont visibles dans l' UI en tant que transactions non Web. Vous pouvez également utiliser cet appel pour reclasser une tâche d'arrière-plan du moniteur en tant que Web de transaction, en passant le paramètre False .
Cette API reclasse une transaction existante en tant que transaction de tâche en arrière-plan. S'il n'y a pas de transaction existante, cet appel ne fonctionnera pas.
La désignation « tâche d'arrière-plan » est généralement utilisée pour les transactions non Web (par exemple : processus de travail, système basé sur des tâches ou script autonome), mais vous pouvez également désigner une transaction Web comme « tâche d'arrière-plan » pour la séparer de vos autres transactions application . Par exemple, vous avez un réseau de transactions de longue durée qui fausse votre score Apdex ou votre temps de réponse moyen.
L' agent identifie une transaction du monitoring comme une transaction Web ou une tâche d'arrière-plan au début de la transaction, en fonction du type de wrapper de point d'entrée qui a lancé la monitoring. Pour créer initialement une tâche en arrière-plan (au lieu de marquer un site Web de transaction comme tâche en arrière-plan), vous utiliseriez background_task. Pour un didacticiel sur la création de tâches en arrière-plan, consultez Monitorer les tâches non Web, les scripts et les fonctions.
Conseil
Vous pouvez également marquer un site Web de transaction comme tâche d'arrière-plan dans le dictionnaire d'environnement WSGI . Pour ce faire, définissez la clé newrelic.set_background_task pour la demande spécifique dans le dictionnaire d’environnement WSGI transmis par le serveur WSGI dans votre application WSGI cible.
Paramètres
paramètres | Description |
|---|---|
booléen | Facultatif. La valeur par défaut est |
Valeurs de retour
Aucun.
Exemples
Définition d'une requête Web sur une tâche en arrière-plan
Exemple de définition d'une transaction Web sur une tâche d'arrière-plan non Web :
def wsgi_app(environ, start_response): newrelic.agent.set_background_task()Reclassification d'une tâche d'arrière-plan en tant que tâche Web de transaction
Parfois, vous souhaiterez peut-être plutôt classer une tâche d'arrière-plan comme un Web de transactions, afin de pouvoir la voir avec votre autre Web de transactions d' application . Pour ce faire, ajoutez cet appel où une tâche d’arrière-plan du moniteur s’exécute :
import newrelic.agentnewrelic.agent.set_background_task(False)