newrelic_create_distributed_trace_payload (API del agente PHP)

Sintaxis

newrelic_create_distributed_trace_payload()

Crea una carga útil rastreo distribuida.

Requisitos

Requiere la versión 8.4 o superior del agente PHP.

Descripción

rastreo distribuido permite ver el camino que sigue una solicitud a medida que viaja a través de un sistema distribuido.

Importante

Con la versión 9.10 o superior del agente PHP, las siguientes funciones JSON ahora se consideran obsoletas y se eliminarán en una versión futura:

newrelic_create_distributed_trace_payload()
newrelic_accept_distributed_trace_payload($payload)
newrelic_accept_distributed_trace_payload_httpsafe($payload)

En su lugar, utilice la API que sea compatible con la compatibilidad con W3C Trace Context, agregada en la versión 9.8 del agente. Con esto, la API para aplicaciones instrumentadas manualmente ha cambiado de las funciones relacionadas con la carga útil JSON a las siguientes formas de matriz de encabezado:

newrelic_insert_distributed_trace_headers($outbound_headers)
newrelic_accept_distributed_trace_headers($inbound_headers)

Valores de retorno

Este método devuelve un objeto de tipo newrelic\DistributedTracePayload.Este objeto tiene dos métodos que representarán una carga útil distribuida de rastreo como texto.

$payload = newrelic_create_distributed_trace_payload(); // renders the payload as a JSON string
$jsonText = $payload->text(); // renders the payload as an string suitable for transport via HTTP (query string, POST param, HTTP headers, etc.)
$httpSafeString = $payload->httpSafe();

Ejemplos

Para ver ejemplos de cómo y cuándo utilizar este método API, consulte la documentación para instrumentar aplicaciones y servicios manualmente.

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