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

Transaction

Data source:

A transaction is a logical unit of work in a software application, such as HTTP requests, SQL queries, background processes, message queue activity, etc. The Transaction event includes information about the app, database calls, the duration of the transaction, and any errors that may occur.

Attribute nameDefinitionData types
accountId
ID

The unique ID of the account associated with the service/application where the Transaction was created.

appId
ID

The unique numeric identifier assigned by New Relic for the service/app that generated the transaction.

appName

The application name set in the New Relic agent configuration.

databaseCallCount
count

The number of database calls made by this transaction.

databaseDuration
seconds (s)

The database response time in seconds.

duration
seconds (s)

The total server-side response time for the transaction, in seconds. Does not include request queueing time.

error
Boolean

Indicates whether an error was noticed during execution.

errorMessage

(.NET and PHP agents only) This will be server and platform specific. The message contained within an error for the transaction. If an error occurs during a transaction, the error may skew the duration of the event.

errorType

This will be server and platform specific. The class or classification of the error. If multiple errors occur, only the first will be shown. If an error occurs during a transaction, the error may skew the duration of the event.

eventLoopTime
seconds (s)

The time the transaction spent running the event loop. (Python agent only)

eventLoopWait
seconds (s)

Total time the transaction was running while blocked by an event loop process, subject to the threshold. (Python agent only)

externalCallCount
count

The number of external calls made by this transaction.

externalDuration
seconds (s)

The total response time of all external (out-of-process) services, in seconds.

gcCumulative
seconds (s)

(Ruby and Java agents only) The total time spent in garbage collection during this transaction, in seconds.

guid
ID

The identifier for the transaction.

host

The name of the application host that processed this request.

http.statusCode
enum

The HTTP status code associated with the transaction. Some agents use httpResponseCode, which is equivalent.

http.statusText
enum

The response status message for a web request.

httpResponseCode
enum

The HTTP response code associated with the transaction. Some agents use http.statusCode, which is equivalent.

memcacheDuration
seconds (s)

The memcache response time, in seconds.

name

The name of the transaction associated with this data. Ex: Controller/customers/show.

parent.account
ID

If a distributed tracing payload is received, this is the account identifier for the transaction's upstream caller.

parent.app
ID

If a distributed tracing payload is received, this is the application identifier. APM agents retrieve this value in the connect response under the key primary_application_id.

parent.transportDuration

When distributed tracing is enabled and a payload is received, the difference in time between the timestamp given for when the payload was sent and the moment it was processed.

parent.transportType

When a distributed tracing payload is received, the method of transport for the payload. Example values: Unknown, HTTP, HTTPS, Kafka, JMS, IronMQ, AMQP, Queue, or Other.

parent.type

If a distributed trace payload was received, the parent's data source type. Example values: App, Browser, Mobile.

parentId
ID

If a distributed trace payload was received, the guid of this parent transaction.

priority

Likelihood this event will be saved.

queueDuration
seconds (s)

The total time the requester waits for a service to initiate, in seconds.

realAgentId
ID

The ID of the New Relic agent that reported the data.

request.headers.accept

The types as read from the HTTP Accept request header.

request.headers.contentLength
bytes (B)

Incoming request size in bytes as read from the Content-Length HTTP request header.

request.headers.contentType

Incoming request content-type as read from the HTTP request header Content-Type. Example value: application/octet-stream.

request.headers.host

The name from the HTTP host request header.

request.headers.referer

The incoming request referer as read from the Referer request header.

request.headers.userAgent

The contents of the User-Agent HTTP header.

request.method

The HTTP request method used. Example values: POST, GET.

request.uri

The incoming request path of the transaction. This does not include the protocol, host, port, or any query parameters. This is hardcoded into the JSON for transaction traces and, formerly, the error blobs.

response.headers.contentLength
bytes (B)

The outgoing response size in bytes as read from the Content-Length response header.

response.headers.contentType

For an HTTP response, the data type of the returned response. Example values: text/html, application/json.

response.status
enum

The HTTP response code associated with the transaction.

sampled

Indicates whether this event was sampled for inclusion in a distributed trace. Only present when distributed tracing is enabled.

totalTime
seconds (s)

The sum of all async components' duration, in seconds. An async component is a method or function where there is no instrumented encapsulating method or function.

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.

transactionSubType

Provides a more specific level of detail about the transaction than transactionType. Example: Controller or Custom.

transactionType

The type of the transaction. For example: Web or Background (non-web).

tripId
ID

A unique ID (a randomly-generated string) used to identify a single request as it crosses application boundaries. If distributed tracing is enabled, this will be reported as traceId.

webDuration

The duration of the transaction, equivalent to duration.