Syntax
newrelic_get_trace_metadata()
Returns an associative array containing the identifiers of the current trace and the parent span.
Requirements
Requires PHP agent version 9.3 or higher.
Must be called inside a transaction.
Description
Returns an associative array containing the identifiers of the current trace and the parent span. This information is useful for integrating with third party distributed tracing tools, such as Zipkin.
Return values
An associative array containing the keys:
trace.id
: the currently executing trace identifier. An empty value will be returned if the transaction does not support this functionality or distributed tracing is disabled.Returns:span.id
: the currently executing span identifier. An empty value will be returned if the transaction does not support this functionality or distributed tracing is disabled.
Examples
Populate B3 Headers for use with Zipkin
Adds necessary distributed tracing metadata to the HTTP headers being sent to a Zipkin consumer:
function make_http_request($url) { $metadata = newrelic_get_trace_metadata(); $sampled = newrelic_is_sampled();
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array( 'X-B3-TraceId: ' . $metadata['trace_id'], 'X-B3-SpanId: ' . substr(uniqid() . uniqid(), 0, 16), 'X-B3-ParentSpanId: ' . $metadata['span_id'], 'X-B3-Sampled: ' . $sampled));
return curl_exec($ch);}
$status = make_http_request("zipkin-consumer.example");
For more help
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's and and documentation.