Syntaxe
newrelic_name_transaction(string $name)Définir un nom personnalisé pour la transaction en cours.
Exigences
Compatible avec toutes les versions d'agent.
Doit être appelé à l'intérieur d'une transaction.
Description
Définit le nom de la transaction sur le nom spécifié. Cela peut être utile si vous avez implémenté votre propre schéma de répartition et que vous souhaitez nommer les transactions en fonction de leur objectif. Appelez cette fonction le plus tôt possible.
Important
N'utilisez pas de crochets [suffix] à la fin du nom de votre transaction. New Relic supprime automatiquement les crochets du nom. Utilisez plutôt des parenthèses (suffix) ou d’autres symboles si nécessaire.
Les valeurs uniques telles que les URL, les titres de page, les valeurs hexadécimales, les identifiants de session et les valeurs identifiables de manière unique ne doivent pas être utilisées pour nommer vos transactions. Ajoutez plutôt ces données à la transaction en tant que paramètre personnalisé avec l’appel newrelic_add_custom_parameter() .
Important
Ne créez pas plus de 1 000 noms de transaction uniques (par exemple, évitez de nommer par URL si possible). Cela rendra vos graphiques moins utiles et vous risquez de rencontrer les limites fixées par New Relic sur le nombre de noms de transaction uniques par compte. Cela peut également ralentir les performances de votre application.
Paramètres
paramètres | Description |
|---|---|
chaîne | Requis. Nom de la transaction. |
Valeurs de retour
Renvoie true si le nom de la transaction a été modifié avec succès. Si false est renvoyé, vérifiez le agent log pour plus d'informations.
Exemples
Dénomination générale des transactions
Vous avez /product/123 et /product/234. Si vous générez un nom de transaction distinct pour chacun, New Relic stockera des informations distinctes pour ces deux noms de transaction. Au lieu de cela, stockez la transaction sous le nom /product/* ou utilisez quelque chose de significatif dans le code lui-même pour nommer la transaction, comme /Product/view:
function example() { if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_name_transaction("/Product/view/"); } // ...}Nommage du framework MVC
Dans le framework MVC, une bonne option consiste à utiliser l'appel newrelic_name_transaction() vers lequel votre demande est acheminée et à nommer votre transaction avec un format Contrôleur/Action.