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

NerdGraph tutorial: View 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

Description

durationMs

The duration of this trace in milliseconds.

entities

All entities that are part of this trace.

entityCount

The number of entities that are part of this trace.

spanConnections

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

timestamp

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

Additional span-level data:

Span-level metadata

Description

clientType

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

entityGuid

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

processBoundary

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

spanAnomalies

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.