• EnglishEspañol日本語한국어Português
  • Log inStart now

NerdGraph tutorial: Viewing distributed trace details

You can use New Relic's NerdGraph GraphiQL explorer to query your distributed tracing data. This document explains:

  • Trace metadata that's only available with NerdGraph
  • Example queries of trace data

Trace metadata

In addition to span event and transaction event data, we calculate additional metadata about the trace and its span relationships. To query this metadata, go to the NerdGraph GraphiQL explorer at api.newrelic.com/graphiql.

Additional trace-level data:

Trace-level metadata



The duration of this trace in milliseconds.


All entities that are part of this trace.


The number of entities that are part of this trace.


Parent/child IDs that represent all of the span relationships within this trace.


The trace's start time in milliseconds since the Unix epoch](https://currentmillis.com/).

Additional span-level data:

Span-level metadata



For a client span, this indicates the type of entity called: DATASTORE or EXTERNAL.


The New Relic identifier for the entity that sent the span.


The position of a span with respect to the boundaries between processes: ENTRY, EXIT, or IN_PROCESS.


Anomalies detected for a span, compared to similar spans that occurred over the previous hours before this span occurred. Anomalous spans appear in the trace UI.

For more about trace structure and span relationships, see Trace structure.

Trace data query examples

Here are example NerdGraph queries of distributed tracing data:

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.