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
Distributed Tracing
Span
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. |