Syntaxe
newrelic_create_distributed_trace_payload()Crée une tracedes charges distribuées.
Exigences
Nécessite l'agent PHP version 8.4 ou supérieure.
Description
Le tracing distribué vous permet de voir le chemin emprunté par une requête lorsqu'elle parcourt un système distribué.
Important
Avec agent PHP version 9.10 ou supérieure, les fonctions JSON suivantes sont désormais considérées comme obsolètes et seront supprimées dans une future sortie :
newrelic_create_distributed_trace_payload()newrelic_accept_distributed_trace_payload($payload)newrelic_accept_distributed_trace_payload_httpsafe($payload)Utilisez plutôt l’ API compatible avec la prise en charge W3C Trace Context, ajoutée dans la version 9.8 agent . Avec cela, l' API pour l'application instrumentée manuellement est passée des fonctions liées aux charges JSON aux formes d'éventail d'en-têtes suivantes :
newrelic_insert_distributed_trace_headers($outbound_headers)newrelic_accept_distributed_trace_headers($inbound_headers)Valeurs de retour
Cette méthode renvoie un objet de type newrelic\DistributedTracePayload.Cet objet possède deux méthodes qui rendront une traces distribuée chargée sous forme de texte.
$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();Exemples
Pour obtenir des exemples sur la manière et le moment d'utiliser cette méthode API, consultez la documentation pour instrumenter manuellement les applications et les services.