newrelic_add_custom_tracer (API del agente PHP)

Sintaxis

newrelic_add_custom_tracer(string $function_name)

Especifique funciones o métodos para que el agente interprete con instrumentación personalizada.

Requisitos

Compatible con todas las versiones de agente.

Descripción

Especifique funciones o métodos para que el agente apunte a instrumentación personalizada. Esta es la API equivalente a la configuración newrelic.transaction_tracer.custom .

No puede aplicar seguimiento personalizado a funciones PHP internas.

Parámetros

Parámetro	Descripción
`$function_name` cadena	Requerido. El nombre puede tener el formato `function_name` para funciones de procedimiento o `"ClassName::method"` para métodos. Tanto los métodos estáticos como los de instancia se instrumentarán si se utiliza la sintaxis del método y el nombre de la clase debe estar completamente calificado: debe incluir el namespace completo si la clase se definió dentro de un namespace.

Parámetro

Descripción

$function_name

cadena

Requerido. El nombre puede tener el formato function_name para funciones de procedimiento o "ClassName::method" para métodos. Tanto los métodos estáticos como los de instancia se instrumentarán si se utiliza la sintaxis del método y el nombre de la clase debe estar completamente calificado: debe incluir el namespace completo si la clase se definió dentro de un namespace.

Valores de retorno

Devuelve true si el rastreador se agregó correctamente.

Ejemplos

Instrumento una función

function example_function() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_add_custom_tracer("example_function");
    }
}

Instrumento un método dentro de una clase

class ExampleClass {
    function example_method() {
        if (extension_loaded('newrelic')) { // Ensure PHP agent is available
            newrelic_add_custom_tracer("ExampleClass::example_method");
        }
    }
}

Instrumento un método dentro de una clase con espacio de nombres

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");
        }
    }
}

Alternativamente, en PHP 5.5 o posterior, se puede usar la sintaxis ::class :

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");
    }
}

Te ofrecemos esta traducción automática para facilitar la lectura.

newrelic_add_custom_tracer (API del agente PHP)

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

Requisitos

Descripción

Parámetros

Valores de retorno

Ejemplos

Instrumento una función

Instrumento un método dentro de una clase

Instrumento un método dentro de una clase con espacio de nombres

Sintaxis