Rastreo distribuido para tus servicios PHP

Rastreo distribuido te permite ver el recorrido completo de tus solicitudes a lo largo de un sistema distribuido. El agente PHP instrumentado automáticamente con rastreo distribuyó una serie de funciones PHP nativas, así como algunos clientes HTTP de terceros:

• Función PHP file_get_contents
• Funciones PHP curl_exec y curl_multi_exec
• Trago 4, Trago 5, Trago 6
• Drupal drupal_http_request function
• Trabajos en cola de Laravel

Para el agente PHP, ofrecemos dos tipos de rastreo distribuido (para más detalles, consulte Cómo funciona el muestreo de intervalo):

• Estándar (muestreo head-based): Antes de que llegue cualquier traza, determinamos un porcentaje determinado de traza para aceptar y analizar. Esto le brinda un punto de partida sólido para ver cómo el rastreo puede ayudarlo. Está activado de forma predeterminada en agente PHP 9.21.0 y superior.

• Rastreo infinito (ejemplificación al final): Nuestro servicio basado en la nube acepta todos sus trazos y luego los clasifica para encontrar los más importantes. Infinite tracing analiza todos tus trazos y te brinda opciones de configuración para tomar muestra de los trazos que más te interesan.

Ya sea que simplemente desee probar el rastreo distribuido estándar (ejemplificación al inicio) o también desee configurar el rastreo infinito (ejemplificación al final), debe comenzar configurando el rastreo estándar.

Rastreo estándar distribuido

Este es el mejor enfoque para configurar el rastreo distribuido estándar si aún no instaló ningún agente APM para sus servicios.

Identificar servicios

Averigüe qué servicios se relacionan con su solicitud para que pueda instrumentar cada uno de ellos para enviar datos de traza a New Relic.

Instrumentar cada servicio con un agente APM

Para cada servicio involucrado en sus transacciones, deberá realizar una instalación separada del agente. Si algunos de sus servicios emplean otros idiomas, simplemente repita los pasos de instalación para esos idiomas.

Para iniciar la rutina de instalación, haga clic en el mosaico a continuación. Cuando haya terminado de instalar cada agente, regrese aquí para ver consejos para ver su traza.

Start installation

Ver traza

Después de instrumentar cada uno de sus servicios con el agente APM, genere algo de tráfico en su aplicación para que podamos capturar alguna traza. A continuación se muestran algunas formas de ver su traza en la UI:

Ver trazas que incluyen un servicio específico

A continuación se muestra una forma de ver la traza de un servicio en particular:

1. Vaya a one.newrelic.com > All capabilities > APM & services.
2. Haga clic en su entidad (servicio).
3. En la sección Monitor del panel izquierdo, haga clic en Distributed tracing.
4. Para más detalles, haga clic en una traza individual. Si Group similar traces está activado en el menú superior, haga clic en un grupo de trazas y luego haga clic en una traza individual.
5. Si no ves la traza que quieres, puedes filtrar por el trace.id.

Ver traza entre cuentas

Para ver traza que cruza cuentas:

1. Vaya a one.newrelic.com > All capabilities > Traces.
2. Seleccione su entidad (servicio) en el panel izquierdo.
3. Para más detalles, haga clic en una traza individual. Si Group similar traces está activado en el menú superior, haga clic en un grupo de trazas y luego haga clic en una traza individual.
4. Si no ves la traza que quieres, puedes filtrar por el trace.id.

Examinar el log relacionado con la traza.

Puede reunir su log y los detalles de seguimiento para que la resolución de problemas sea más fácil y rápida. Con logs en el contexto, puede ver el mensaje de inicio de sesión junto con la traza en la UI de New Relic.

Luego de haber localizado una traza interesante siguiendo los pasos en Ver traza que incluye un servicio específico o Ver traza entre cuentas, haga lo siguiente:

1. Si ha habilitado logs en el contexto, haga clic en la pestaña Logs (al lado de Trace details).
2. Para ver detalles relacionados con un log individual, haga clic directamente en el mensaje.

Para obtener más ayuda para encontrar su traza en la UI:

• Comprender y utilizar la UI de rastreo distribuido
• Consulta rastreo datos distribuidos

Rastreo infinito

El rastreo estándar distribuido por el agente APM captura hasta 10 rastreos por minuto, pero si desea que analicemos todos sus datos y encontremos los rastreos más relevantes, puede configurar el Rastreo Infinito.

Antes de comenzar, cerciorar primero de cumplir con los requisitos.

Establecer nivel de detalle de la traza

El soporte de rastreo distribuido depende del rastreador de transacciones del agente PHP. Cuando el rastreo distribuido está habilitado, se crea un tramo para cada segmento visto por el rastreador de transacciones.

A medida que se muestrean los intervalos, el agente PHP dará prioridad a los intervalos relacionados con llamadas externas por encima de otros intervalos, que luego se registran en orden descendente de duración.

Si descubre que se informan demasiados intervalos sin importancia para las llamadas a funciones PHP, puede reducir el detalle del rastreador de transacciones configurando newrelic.transaction_tracer.detail en 0. Luego puede usar la configuración newrelic.transaction_tracer.custom o el método API newrelic_add_custom_tracer para agregar segmentos y tramos de traza para la función PHP específica o los métodos que desea agregar a su traza.

Aplicación y servicios de instrumento manual con API de agente PHP

newrelic_create_distributed_trace_payload()
newrelic_accept_distributed_trace_payload($payload)

newrelic_insert_distributed_trace_headers($outbound_headers)
newrelic_accept_distributed_trace_headers($inbound_headers)

Si está utilizando una biblioteca no compatible o tiene un componente de sistemas distribuidos no basado en HTTP (como cola de mensajes), puede usar la API del agente PHP para identificar manualmente las transacciones que se incluirán en un rastreo distribuido. Este es un proceso de dos pasos:

1. Modifica tu servicio o aplicación a create o insert los datos del rastreo distribuido
2. Modifique su servicio o aplicación a accept datos de rastreo distribuido creados por otras transacciones o solicitudes.

El siguiente ejemplo utiliza una cola genérica de mensajes/trabajos. Si bien los detalles reales variarán según el tipo de sistema que intente agregar a un rastreo distribuido, los conceptos básicos son los mismos. Además, aunque hemos utilizado una cola de trabajos como ejemplo, puedes utilizar estos métodos con el componente any sistemas distribuidos.

Para obtener más información sobre el uso de instrumentación manual para obtener más detalles o ver conexiones entre servicios, consulte la documentación sobre las API de rastreo distribuida.

API de encabezado

// create a job object
$job = new \Generic\Queue\Job;

// set the information needed to run the queue job
$job->setData('info', $info);

// save the job
$job->save();

$outbound_headers = array();
if (newrelic_insert_distributed_trace_headers($outbound_headers)) {

    // create a job object
    $job = new \Generic\Queue\Job;

    // set the information needed to run the queue job
    $job->setData('info', $info);

    // add the headers to the job data
    $job->setData('nr_dt_headers', $outbound_headers);

    // save the job
    $job->save();
} else {
    echo "Unable to obtain distributed tracing headers";
}

// create the job runner
$jobRunner = \Generic\Queue\Runner;

// grab jobs until there aren't any
while($job = $jobRunner->next()) {
    // run the job
    $job->run();
}

// create the job runner
$jobRunner = \Generic\Queue\Runner;

while($job = $jobRunner->next()) {
    $inbound_headers = $job->getData('nr_dt_headers');
    if($inbound_headers) {
        newrelic_accept_distributed_trace_headers($inbound_headers);
    }
    $job->run();
}

API de carga útil (obsoleta)

// create a job object
$job = new \Generic\Queue\Job;

// set the information needed to run the queue job
$job->setData('info', $info);

// save the job
$job->save();

$payload = newrelic_create_distributed_trace_payload();

// create a job object
$job = new \Generic\Queue\Job;

// set the information needed to run the queue job
$job->setData('info', $info);

// add the payload data to the job data as a text json string
$job->setData('dt_payload', $payload->Text());

// save the job
$job->save();

// create the job runner
$jobRunner = \Generic\Queue\Runner;

// grab jobs until there aren't any
while($job = $jobRunner->next()) {
    // run the job
    $job->run();
}

// create the job runner
$jobRunner = \Generic\Queue\Runner;

while($job = $jobRunner->next()) {
    $payload = $job->getData('dt_payload');
    if($payload) {
        newrelic_accept_distributed_trace_payload($payload);
    }
    $job->run();
}

// create the HTTP safe payload string 
$payload = newrelic_create_distributed_trace_payload();
$httpSafePayload = $payload->httpSafe();

// ...

// accept the HTTP safe payload string
newrelic_accept_distributed_trace_payload_httpsafe($httpSafePayload);

Programas PHP de línea de comando

Los programas PHP ejecutados desde la línea de comando PHP siempre son muestreados por el rastreador distribuido del agente. Dependiendo de los programas que ejecutes, estos procesos podrían tener una sobrerrepresentación en tu colección de rastreo distribuido. En estas situaciones, puede optar por desactivar la instrumentación de línea de comando utilizando la configuración per-directory newrelic.enabled en su newrelic.ini files.