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

Span

Span events are created when New Relic agents, or other tracing instrumentation tools, instrument operations that are part of a distributed trace. The operations that a span can represent include datastore queries, calls to other services, and method-level timing. For example, in an HTTP service, a span is created at the beginning of an HTTP request and completed when the HTTP server returns a response. Span attributes contain important information about the operation that the span represents (such as duration, host data, etc.), including trace state details (such as traceId, guid) that allow New Relic to connect spans together in a trace.

Attribute nameDefinitionData types
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.

asn

Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user.

asn.latitude

The latitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's latitude.

asn.longitude

The longitude of the geographic center of the postal code where the Autonomous System Network is registered. This is not the end user's longitude.

asn.organization

The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution.

browserApp.name

The name of the browser application monitored by New Relic.

browserInteraction.id
ID

A unique value generated for each browser interaction captured by the New Relic agent.

browserInteraction.name

The name of the interaction. This is either the targetGroupedUrl or the custom name set via the API.

bytes.received
bytes (B)

Optional: If the application received a response from the request.url, this is the size of that response in bytes.

bytes.sent
bytes (B)

Optional: If the application sent a request to the request.url, this is the size of that request in bytes.

category

The type of span. Values include: generic, datastore, and http (external). The category type dictates UI display options (available charts, for example) and the collection of specific attributes.

code.filepath

The absolute path to the source code file where the span's instrumented function is defined. Supports the New Relic CodeStream code-level metrics integration.

code.function

The name of the instrumented function or method associated with the span. Supports the New Relic CodeStream code-level metrics integration.

code.lineno

The line number where the span's instrumented function is defined. Supports the New Relic CodeStream code-level metrics integration.

code.namespace

The namespace (class/ module name) in which the span's instrumented function is defined. Supports the New Relic CodeStream code-level metrics integration.

component

For 'datastore' category spans: the database vendor or driver, such as Redis and MySql. For 'external' category spans: the framework used to make the connection. For example: OkHttp and Net::HTTP.

connection.type

The type of connection which the device was using, such as 2G or 3G.

containerId
ID

The container ID. The New Relic APM agent collects this when running in a containerized context.

db.instance

The database name. For example, the name of the database for a given JDBC database connection URL in Java. Reported when the category is 'datastore.' Example value: dbc.url="jdbc:mysql://mysql-db.servers.net:3306/accounts".

db.statement

The database statement in the format most permissive by configuration. Reported when 'category' is 'datastore.' For a span with a 'component' of 'MySql', an example value would be: SELECT * FROM accounts.

device.size

The display size of the device: small, normal, large, xlarge.

device.type

The type of device that loaded the page: mobile, tablet, or desktop.

duration
seconds (s)

The span's elapsed time in seconds.

duration.ms
milliseconds (ms)

The span's elapsed time in milliseconds.

entity.guid
ID

The GUID, assigned by New Relic, for the New Relic-monitored entity (host, application, etc.). This value is stored as a Base64 encoded value.

entity.name

The name of the entity (for example, an app name, host name, or workload name).

error

Makes a span as having an error.

error.class

The full class name for the span's error.

error.message

The message for the span's error.

error.statusCode

HTTP error response code. Only present when code represents either a client error or server error.

error.type

Either HTTPError or NetworkFailure, depending on whether the error is a result of a failed request to a host or a failure on the cellular network.

geo.city

The city in which the span occurred.

geo.countryCode

The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2.

geo.regionCode

The specific administrative division within a country where the event occurred. In the United States, regions correspond to state codes, such as WA or NY. Outside the United States, a country's regions correspond to numeric codes.

In the United States, regions correspond to state codes ; for example, WA or NY. Outside the United States, a country's regions correspond to numerical codes .

groupedPageUrl

The grouped URL of the view that made the AJAX request. For example: myapp.com/acct/*/dash.

groupedRequestUrl

The grouped URL of the AJAX request. For example: myapp.com/acct/\*/ajax.

guid
ID

The unique identifier for the segment. This is equivalent to spanID in OpenTracing semantics.

host

The name of the application host that processed this request, as identified by the reporting agent. Examples: ip-10-1-34-88, ede2fff1efbe, apphost.domain.com.

http.method

The HTTP method or language method/function used for the call. Reported when the category is http. Examples: GET, POST.

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.

http.url

External URI for the call. Reported when 'category' is 'http.' It MUST NOT contain user, password, or query parameters. It MUST be set as an agent attribute and not as an intrinsic so that attribute filtering can be applied.

httpResponseCode
enum

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

jsDuration.ms
milliseconds (ms)

The total duration, in milliseconds, spent on JavaScript execution. (This attribute doesn't exist for initial page load events.)

mobileApp.name

The name of the mobile application that created this span.

name

The span name that best represents the operation.

networkError

The error message associated with the iOS NSURL Error code. See networkError.code for more information.

networkError.code

If the error is a network error, this is the iOS network error code. For Android applications, this is the mapped value.

newRelic.ingestPoint

Where the data point entered the platform (such as browser.spans, or api.traces).

newRelic.traceFilter.type

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

pageUrl

The URL of the page that was loaded for the PageView, for example: http://www.newrelic.com. This URL does not include query parameters.

parentId
ID

The span parent's GUID (may not be present for the root span).

peer.address

The address of the datastore, including the host name and the port, path, or ID. Reported when 'category' is 'datastore.' Example: mysql-db.servers.net:3306.

peer.hostname

The hostname of the database. Reported when 'category' is 'datastore.' Example: mysql-db.servers.net.

port
enum

The request port.

priority

A priority ranking that dictates whether the trace will be reported in situations where the sampling reservoir has exceeded capacity. This is a float value set by the first New Relic agent that’s part of the request.

realAgentId
ID

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

request.bodySize
bytes (B)

The payload size of the request body, in bytes.

request.domain

The fully qualified domain name (FQDN) of the request URL.

request.method

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

request.path

The path that the application attempted to access when the request or error occurred.

request.url

The URL of the AJAX request. For example: myapp.com/acct/1/ajax.

response.body

Optional: The response that is sent from the requestDomain for the HTTP error (up to 4096 bytes).

response.bodySize
bytes (B)

The payload size of the response body, in bytes.

response.statusCode
enum

The HTTP response code. Example: 200.

sampled

Whether the request route was chosen to be sampled for tracing.

service.name

The name of the instrumented service that created this span.

session

A unique identifier for a single session. The session is tracked in browser storage using the Web Storage API, subject to each browser's implementation and handling. The session will automatically reset or refresh after a set period of inactivity or a pre-defined duration limit, whichever is less.

span.kind

Spans that represent a call to another service or to a datastore have the value client.

timeSinceBrowserInteractionStart.ms
milliseconds (ms)

The time in milliseconds between the start of the BrowserInteraction and the start of the request.

timestamp

The time (date, hour, minute, second) at which the interaction occurred.

timeToLastCallbackEnd.ms
milliseconds (ms)

The duration, in milliseconds, from the start of the request (timestamp) to the end of the last callback. This is not just an additive function; the callback time can overlap with the wait time.

timeToLoadEventStart.ms
milliseconds (ms)

The time, in milliseconds, from the start of the interaction to the loadEventStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

timeToSettle.ms
milliseconds (ms)

The time, in milliseconds, from the start of the request to when all resulting callbacks (including callbacks of subsequent AJAX requests) are complete.

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.

traceId
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.

transaction.name

The name of the New Relic transaction associated with the span.

transactionId
ID

The GUID of the New Relic transaction associated with the span.

userAgent.name

The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request.

userAgent.os

The browser’s reported operating system, such as Windows or Linux, that it is running on. This is obtained from the User-Agent header of an HTTP request.

userAgent.version

The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request.