set_transaction_name (Python API d'agent)

Syntaxe

newrelic.agent.set_transaction_name(name, group=None, priority=None)

Définit le nom de la transaction en cours.

Description

Cet appel définit le nom de la transaction en cours.

Voici un exemple montrant une manière d'implémenter les paramètres name et group :

name = '%s/%s' % (controller, function)
group = 'Python/WebFramework/Controller'
newrelic.agent.set_transaction_name(name, group)

Le paramètre de priorité peut généralement être ignoré, sauf si vous implémentez une instrumentation personnalisée pour un framework Web où il peut y avoir plusieurs points où vous souhaitez définir le nom (tels que des intergiciels, des gestionnaires de vues ou des gestionnaires d'erreurs).

Paramètres

paramètres	Description
`name` chaîne	Requis. Nom souhaité pour la transaction en cours. Voir la description pour un exemple de définition du nom.
`group` chaîne	Facultatif. Le `group` représente la structure de nommage du paramètre `name`, qui est utilisé pour définir le type de transaction dans l' UI. Voir la description pour un exemple de configuration du groupe. Si ce paramètre n'est pas fourni, le groupe utilisera par défaut le nom `Function` dans l'hypothèse où le nom sera de la forme `module:class.function` ou `module:function` et représentera le nom de la fonction en cours d'exécution. Si vous créez un groupe personnalisé, nous vous recommandons de le préfixer avec `Python/`. La structure de dénomination utilisée pour nommer la transaction. Étant donné que cette valeur est rendue dans le cadre d’une URL, le codage non ASCII doit être évité. La valeur par défaut est `Function`. Voir la description pour plus d'informations sur son utilisation.
`priority` int	Facultatif. La valeur de priorité est utilisée pour déterminer le nom donné à une transaction. Les nombres plus élevés remplacent les nombres plus bas. La valeur par défaut est `None`, ce qui signifie que le nom de la transaction remplace toute valeur existante. Si la priorité est laissée à `None`, le nouveau nom remplace toujours toute valeur existante. Voici un exemple de fonctionnement de la priorité : newrelic.agent.set_transaction_name('first', 'Python/CustomGroup') # transaction name becomes 'first'. newrelic.agent.set_transaction_name('second', 'Python/CustomGroup', priority=10) # transaction name becomes 'second'. The priority becomes 10. newrelic.agent.set_transaction_name('third', 'Python/CustomGroup', priority=5) # transaction name is still 'second' because 5 < 10. newrelic.agent.set_transaction_name('fourth', 'Python/CustomGroup', priority=15) # transaction name becomes 'fourth' because 15 > 10. The priority becomes 15. newrelic.agent.set_transaction_name('fifth', 'Python/CustomGroup') # transaction name becomes 'fifth'. The priority remains 15.

paramètres

Description

name

chaîne

Requis. Nom souhaité pour la transaction en cours. Voir la description pour un exemple de définition du nom.

group

chaîne

Facultatif. Le group représente la structure de nommage du paramètre name, qui est utilisé pour définir le type de transaction dans l' UI. Voir la description pour un exemple de configuration du groupe.

Si ce paramètre n'est pas fourni, le groupe utilisera par défaut le nom Function dans l'hypothèse où le nom sera de la forme module:class.function ou module:function et représentera le nom de la fonction en cours d'exécution. Si vous créez un groupe personnalisé, nous vous recommandons de le préfixer avec Python/.

La structure de dénomination utilisée pour nommer la transaction. Étant donné que cette valeur est rendue dans le cadre d’une URL, le codage non ASCII doit être évité. La valeur par défaut est Function. Voir la description pour plus d'informations sur son utilisation.

priority

int

Facultatif. La valeur de priorité est utilisée pour déterminer le nom donné à une transaction. Les nombres plus élevés remplacent les nombres plus bas. La valeur par défaut est None, ce qui signifie que le nom de la transaction remplace toute valeur existante. Si la priorité est laissée à None, le nouveau nom remplace toujours toute valeur existante. Voici un exemple de fonctionnement de la priorité :

newrelic.agent.set_transaction_name('first', 'Python/CustomGroup')
# transaction name becomes 'first'.

newrelic.agent.set_transaction_name('second', 'Python/CustomGroup', priority=10)
# transaction name becomes 'second'. The priority becomes 10.

newrelic.agent.set_transaction_name('third', 'Python/CustomGroup', priority=5)
# transaction name is still 'second' because 5 < 10.

newrelic.agent.set_transaction_name('fourth', 'Python/CustomGroup', priority=15)
# transaction name becomes 'fourth' because 15 > 10. The priority becomes 15.

newrelic.agent.set_transaction_name('fifth', 'Python/CustomGroup')
# transaction name becomes 'fifth'. The priority remains 15.

Valeurs de retour

Aucun.

Exemples

Utilisation du nom et du paramètre de groupe

Un exemple montrant une manière d'implémenter les paramètres name et group :

name = '%s/%s' % (controller, function) 
group = 'Python/WebFramework/Controller'

newrelic.agent.set_transaction_name(name, group)

Nom du paramètre à l'aide de current_transaction

Un exemple d'utilisation de current_transaction pour définir le nom de la transaction en cours :

transaction = newrelic.agent.current_transaction()
new_transaction_name = transaction.name
newrelic.agent.set_transaction_name(new_transaction_name)

Cette traduction automatique est fournie pour votre commodité.

set_transaction_name (Python API d'agent)

Syntaxe.css-21sua1{background:none;border:none;width:0;padding:0;}

Description

Paramètres

Valeurs de retour

Exemples

Utilisation du nom et du paramètre de groupe

Nom du paramètre à l'aide de current_transaction

Syntaxe