New Relic data dictionary

This data dictionary lists and defines the attributes attached to New Relic events and other data objects (like Metric and Span data).

This dictionary does not contain data reported by Infrastructure integrations. To learn about that data, see the integration documentation.

Displaying 1 - 67 of 67 results found

Types

Distributed Tracing

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.

Total attributes in this event: 67
Attribute name Summary
appId The unique numeric identifier assigned by New Relic for the service/application where the transaction was created.
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 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.
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.
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.
containerId 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.type The type of device that loaded the page: mobile, tablet, or desktop.
duration The span's elapsed time in seconds.
duration.ms The span's elapsed time in milliseconds.
entity.guid 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 monitored by New Relic.
entityGuid The GUID, assigned by New Relic, for the New Relic-monitored entity (host, application, etc.). This value is stored as a Base64 encoded value. When querying logs, use entity.guids instead, which is a pipe-separated list of GUIDs.
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.
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. Read more.
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 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.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.
jsDuration.ms The total duration, in milliseconds, spent on JavaScript execution. (This attribute doesn't exist for initial page load events.)
name The span name that best represents the operation.
newRelic.ingestPoint Where the data point entered the platform (such as `browser.spans`, or `api.traces`).
newRelic.traceFiler.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 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 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 The ID of the New Relic agent that reported the data.
request.bodySize 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.url The URL of the AJAX request. For example: myapp.com/acct/1/ajax.
response.bodySize The payload size of the response body, in bytes.
response.statusCode 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 cookie expires when the user closes the browser (for example, they fully exit Chrome.) A new session identifier will be assigned when the user opens up a new instance of the browser.
span.kind Entry spans have value 'client'. In-process spans have no value. Exit, datastore, and external spans have value 'exit'.
timeSinceBrowserInteractionStart.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.
timestamp Unix timestamp in milliseconds indicating when the span started.
timeToLastCallbackEnd.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 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 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 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 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 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.