Syntaxe
newrelic_add_custom_tracer(string $function_name)Spécifiez les fonctions ou méthodes que l' agent doit instrumenter avec instrumentation personnalisée.
Exigences
Compatible avec toutes les versions d'agent.
Description
Spécifiez les fonctions ou méthodes que l' agent doit cibler pour instrumentation personnalisée. Il s'agit de l'équivalent API du paramètre newrelic.transaction_tracer.custom .
Vous ne pouvez pas appliquer de traçage personnalisé aux fonctions PHP internes.
Paramètres
paramètres | Description |
|---|---|
chaîne | Requis. Le nom peut être formaté soit comme |
Valeurs de retour
Renvoie true si le traceur a été ajouté avec succès.
Exemples
Instrumenter une fonction
function example_function() { if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_add_custom_tracer("example_function"); }}Instrumenter une méthode dans une classe
class ExampleClass { function example_method() { if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_add_custom_tracer("ExampleClass::example_method"); } }}Instrumenter une méthode dans une classe avec espace de noms
namespace Foo\Bar;
class ExampleClass { function example_method() { if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_add_custom_tracer("Foo\\Bar\\ExampleClass::example_method"); } }}Alternativement, sur PHP 5.5 ou version ultérieure, la syntaxe ::class peut être utilisée à la place :
namespace Foo\Bar { class ExampleClass { function example_method() { // ... } }}
namespace { use Foo\Bar;
if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_add_custom_tracer(Bar::class . "::example_method"); }}