New Relic data dictionary

This data dictionary defines some of our default-reported data stored in NRDB and queryable via NRQL. This includes events like Transaction, MobileRequest, and BrowserInteraction, and our Metric, Log, and Span data types. These definitions are also available from our query builder UI by mousing over applicable data type and attribute names.

This dictionary doesn't contain:

  • Data from our infrastructure integrations (for that, see docs for a specific integration)
  • Custom data
  • Detailed integration-specific attributes for Metric data

DistributedTraceSummary

This event contains summary data about a distributed trace and provides an aggregated view of distributed tracing data. DistributedTraceSummary events are generated by New Relic and are triggered by distributed tracing data from agents or the Trace API. This event only appears in the parent account.

Attribute nameDefinitionData types
accountIds

A comma delimited list of newrelic accountIds that took part in this trace.

backend.duration.ms
milliseconds (ms)

The total elapsed time in milliseconds of all backend services in this trace.

backend.timestamp
milliseconds (ms)

The timestamp of the first span in this trace from a backend entity. In distributed tracing, any events that are not from client-side applications contributed to the backend duration.

duration.ms

The duration of the entire distributed trace, including both backend and client-side entities. the earliest span to the latest.

entityCount
count

The number of unique entities that took part in this trace.

entityGuids

A comma delimited list of entity GUIDs for entities that participated in this trace. These GUIDs are assigned by New Relic for the New Relic-monitored entity (host, application, etc.). Each GUID is stored as a Base64 encoded value.

errorCount
count

The number of events in this distributed trace that were identified as errors.

newRelic.traceFilter.type

The name of the trace filter used by the Infinite Tracing trace observer to select this trace.

root.entity.accountId

The New Relic account ID that the root entity of this trace reports data to.

root.entity.guid

The entity GUID associated with the root entity of this trace.

root.entity.name

The name of the root entity of this trace.

root.span.duration.ms
milliseconds (ms)

The elapsed time in milliseconds of the root span of this trace. The root of a distributed trace is the first span, and will have a null value for parent.id.

root.span.id

The unique identifier of the root span of this trace. The root of a distributed trace is the first span, and it has a null value for parent.id.

root.span.name

The name of the root span of this trace.

root.span.timestamp
milliseconds (ms)

The timestamp of the root span of this trace. The root of a distributed trace is the first span, and will have a null value for parent.id.

spanCount
count

The number of events in this distributed trace. Events in a distributed trace can have several event types, including Span, Transaction, and TransactionError.

timestamp
milliseconds (ms)

The timestamp of the root span in this distributed trace.

trace.id
ID

The unique ID (a randomly generated string) used to identify a single request as it crosses inter- and intra- process boundaries. This ID allows the linking of spans in a distributed trace. Included when distributed tracing is enabled.