AjaxRequest
events occur for any Ajax
request, including during a BrowserInteraction
event. The event attribute tracks geographic and browser info. Use browser app settings to block specific requests.
Attribute name | Definition | Data types |
---|---|---|
actionText | The text of the HTML element that was clicked when a browser interaction started. Added to | |
appId ID | The ID of your application, as recorded by New Relic. | |
appName | The name of the application that handled the request as shown in browser monitoring. | |
asn | Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user. | |
asnLatitude | 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. | |
asnLongitude | 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. | |
asnOrganization | The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution. | |
browserInteractionId ID | A unique value generated for each browser interaction captured by the New Relic agent. | |
browserInteractionName | The name of the interaction. This is either the | |
city | The city in which the event occurred, such as Portland or Seattle. | |
countryCode | The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2. | |
deviceType | The type of device that loaded the page: mobile, tablet, or desktop. | |
eventId ID | A value that you can link to multiple | |
groupedPageURL | The grouped URL of the view that made the AJAX request. For example: | |
groupedRequestUrl | The grouped URL of the AJAX request. For example: | |
hostname | The fully qualified domain name (FQDN) of the request URL. | |
httpMethod enum | The HTTP method of the AJAX request. Example: | |
httpResponseCode enum | The HTTP response code. Example: | |
jsDuration seconds (s) | The total duration, in seconds, spent on JavaScript execution. This attribute is only seen in | |
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. | |
parentEventId ID | A unique value generated for each interaction with the page. You can use this value to group interactions together. | |
port enum | The request port. | |
priority | Likelihood this event will be saved. | |
regionCode | The specific administrative division within a country where the In the United States, regions correspond to state codes ; for example, | |
requestBodySize bytes (B) | The payload size of the request body, in bytes. | |
requestUrl | The URL of the AJAX request. For example: | |
responseBodySize bytes (B) | The payload size of the response body, in bytes. | |
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. | |
timeSinceBrowserInteractionStart seconds (s) | The time in seconds between the start of the | |
timeToLastCallbackEnd seconds (s) | The duration, in seconds, 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. This attribute is only seen in | |
timeToLoadEventStart seconds (s) | The time, in seconds, from the start of the AJAX request to the start of its load event. This value represents the duration of the AJAX request with single page app (SPA) monitoring. For more information, see the Mozilla developer documentation about | |
timeToSettle seconds (s) | The time, in seconds, from the start of the request to when all resulting callbacks (including callbacks of subsequent AJAX requests) are complete. This attribute is only seen in | |
timestamp | The time (date, hour, minute, second) at which the interaction occurred. | |
userAgentName | The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request. | |
userAgentOS | 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. | |
userAgentVersion | The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request. |
This event is reported by New Relic monitoring for AWS Lambda. This event captures overall function timing and associated metadata. A single AwsLambdaInvocation
event is generated for each invocation.
Attribute name | Definition | Data types |
---|---|---|
aws.lambda.arn | The Amazon Resource Name (ARN) of the instrumented Lambda function. | |
aws.lambda.coldStart | A boolean indicating if the AWS Lambda invocation is a cold start. | |
aws.lambda.eventSource.arn | The Amazon Resource Name (ARN) of the entity that invoked the instrumented Lambda function. | |
aws.requestId ID | AWS identifier of the invocation. | |
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 invocation time for the transaction, in seconds. (Data source: AWS Lambda) | |
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. | |
newRelic.ingestPoint | Where the data point entered the platform (such as | |
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.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. | |
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 | |
request.headers.contentType | Incoming request content-type as read from the HTTP request header | |
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. | |
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 bytes (B) | The response code for an HTTP request | |
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. | |
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. | |
type | The New Relic event type. Example values: |
This event is reported by New Relic monitoring for AWS Lambda. It's generated when an error occurs during a Lambda function invocation.
Attribute name | Definition | Data types |
---|---|---|
aws.lambda.arn | The Amazon Resource Name (ARN) of the instrumented Lambda function. | |
aws.lambda.coldStart | A boolean indicating if the AWS Lambda invocation is a cold start. | |
aws.lambda.eventSource.arn | The Amazon Resource Name (ARN) of the entity that invoked the instrumented Lambda function. | |
aws.requestId ID | AWS identifier of the invocation. | |
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 invocation time for the transaction, in seconds. (Data source: AWS Lambda) | |
error.class | The class name or type for the error. This will be server and platform specific. | |
error.message | The error message for the transaction. This will be server and platform specific. | |
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. | |
newRelic.ingestPoint | Where the data point entered the platform (such as | |
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.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. | |
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 | |
request.headers.contentType | Incoming request content-type as read from the HTTP request header | |
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. | |
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. | |
stackTrace | The error stack trace. The format will be different depending on the agent language. | |
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. | |
transactionName | Name of the transaction in which the error occurred. Example value: Controller/customers/show. Value may be 'Unknown' if an error occurs outside of a transaction. | |
type | The New Relic event type. Example values: |
A BrowserInteraction
represents a unit of work in a browser session, triggered by a user interacting with the webpage. It captures information about the session, AJAX calls and custom JavaScript timing that occurred as a result of the interaction. Initial load and route changes are captured as special types of browser interactions, and are used for SPA monitoring.
Attribute name | Definition | Data types |
---|---|---|
actionText | The text of the HTML element that was clicked when a browser interaction started. Added to | |
ajaxCount count | A count of all XHRs included in the timing of a SPA interaction. | |
appId ID | The ID of your application, as recorded by New Relic. | |
appName | The name of the application that handled the request as shown in browser monitoring. | |
asn | Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user. | |
asnLatitude | 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. | |
asnLongitude | 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. | |
asnOrganization | The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution. | |
backendTransactionName | The name of the backend transaction that served the initial page load. | |
browserInteractionId ID | A unique value generated for each browser interaction captured by the New Relic agent. | |
browserInteractionName | The name of the interaction. This is either the | |
category | The type of interaction; either initial page load, route change, or custom. | |
city | The city in which the event occurred, such as Portland or Seattle. | |
countryCode | The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2. | |
deviceType | The type of device that loaded the page: mobile, tablet, or desktop. | |
domain | The domain portion of the request URL. | |
duration seconds (s) | The total time elapsed of the interaction event | |
eventId ID | A value that you can link to multiple | |
firstContentfulPaint |
Google's User-centric Performance Metrics contains detailed information about its See Compatibility and requirements for New Relic Browser for additional information about | |
firstPaint |
Google's User-centric Performance Metrics contains detailed information about its See Compatibility and requirements for New Relic Browser for additional information about | |
jsDuration seconds (s) | The total duration, in seconds, spent on JavaScript execution. This attribute is only seen in | |
monitorAccountId | The synthetic monitoring account from which you are running the monitor. | |
monitorId ID | A unique number identifying a particular monitor. | |
monitorJobId ID | The ID of a single synthetic monitor run, which began at a specific time and originated from a specific location. | |
parentEventId ID | A unique value generated for each interaction with the page. You can use this value to group interactions together. | |
previousGroupedUrl | The grouped version of the URL in the browser at the start of the interaction. | |
previousRouteName | The route name of the page at the start of the interaction. This is the last value passed by | |
previousURL | The ungrouped URL in the browser at the start of the interaction. | |
regionCode | The specific administrative division within a country where the In the United States, regions correspond to state codes ; for example, | |
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. | |
targetGroupedUrl | The grouped version of the URL in the browser at the end of the interaction. | |
targetRouteName | The route name for the page at the end of the interaction. The last value passed by | |
targetUrl | The ungrouped URL in the browser at the end of the interaction. | |
timeToConnectEnd seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToConnectStart seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToDomComplete seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToDomContentLoadedEventEnd seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToDomContentLoadedEventStart seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToDomInteractive seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToDomLoading seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToDomainLookupEnd seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToDomainLookupStart seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToFetchStart seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToLastCallbackEnd seconds (s) | The duration, in seconds, 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. This attribute is only seen in | |
timeToLoadEventEnd seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToLoadEventStart seconds (s) | The time, in seconds, from the start of the interaction to the For more information, see our documentation about instrumentation for the Navigation Timing API. | |
timeToRedirectEnd seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToRedirectStart seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToRequestStart seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToResponseEnd seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToResponseStart seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToSecureConnectionStart seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToUnloadEventEnd seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timeToUnloadEventStart seconds (s) | The time, in seconds, from the start of the interaction to the For more information about the Navigation Timing API, see Instrumentation for Browser monitoring. | |
timestamp | The time (date, hour, minute, second) at which the interaction occurred. | |
trigger | The cause of the route change or page load. The default values are | |
userAgentName | The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request. | |
userAgentOS | 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. | |
userAgentVersion | The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request. |
BrowserTiming
is a custom event that captures SPA timing data for browser interactions started using the custom createTracer
SPA API method. BrowserTiming
contains many of the same attributes used by other events, especially AjaxRequest
.
Attribute name | Definition | Data types |
---|---|---|
actionText | The text of the HTML element that was clicked when a browser interaction started. Added to | |
appId ID | The ID of your application, as recorded by New Relic. | |
appName | The name of the application that handled the request as shown in browser monitoring. | |
asn | Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user. | |
asnLatitude | 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. | |
asnLongitude | 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. | |
asnOrganization | The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution. | |
browserInteractionId ID | A unique value generated for each browser interaction captured by the New Relic agent. | |
browserInteractionName | The name of the interaction. This is either the | |
browserTimingName | The name of the event. This is taken from the | |
city | The city in which the event occurred, such as Portland or Seattle. | |
countryCode | The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2. | |
deviceType | The type of device that loaded the page: mobile, tablet, or desktop. | |
eventId ID | A value that you can link to multiple | |
groupedPageURL | The grouped URL of the view that made the AJAX request. For example: | |
jsDuration seconds (s) | The total duration, in seconds, spent on JavaScript execution. This attribute is only seen in | |
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. | |
parentEventId ID | A unique value generated for each interaction with the page. You can use this value to group interactions together. | |
regionCode | The specific administrative division within a country where the In the United States, regions correspond to state codes ; for example, | |
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. | |
timeSinceBrowserInteractionStart seconds (s) | The time in seconds between the start of the | |
timeToLastCallbackEnd seconds (s) | The duration, in seconds, 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. This attribute is only seen in | |
timeToSettle seconds (s) | The time, in seconds, from the start of the request to when all resulting callbacks (including callbacks of subsequent AJAX requests) are complete. This attribute is only seen in | |
timeToTracedCallbackStart seconds (s) | The time in seconds from the start of the custom tracer until the start of the traced callback. This attribute is unique to the | |
timestamp | The time (date, hour, minute, second) at which the interaction occurred. | |
tracedCallbackDuration seconds (s) | The duration in seconds of the traced callback. This attribute is unique to the | |
userAgentName | The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request. | |
userAgentOS | 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. | |
userAgentVersion | The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request. |
This event is reported by the New Relic Infrastructure agent. It collects data from all the Docker containers on the host (which may or may not be running). It includes the container's ID, name, image, image name, and metrics about CPU, memory and networking. We take a snapshot of this data every 15 seconds for each container and package it into this event, which is then sent to New Relic. This data appears on the Containers UI page.
Attribute name | Definition | Data types |
---|---|---|
StorageDataAvailableBytes bytes (B) | Data space available in the Storage Driver. Only Device Mapper driver is supported. | |
StorageDataTotalBytes bytes (B) | Total Data space in the Storage Driver. Only Device Mapper driver is supported. | |
StorageDataUsagePercent percentage (%) | Percent of Data space used in the Storage Driver. Only Device Mapper driver is supported. | |
StorageDataUsedBytes bytes (B) | Data space used by the Storage Driver. Only Device Mapper driver is supported. | |
StorageMetadataAvailableBytes bytes (B) | Metadata space available in the Storage Driver. Only Device Mapper driver is supported. | |
StorageMetadataTotalBytes bytes (B) | Total Metadata space in the Storage Driver. Only Device Mapper driver is supported. | |
StorageMetadataUsagePercent percentage (%) | Percent of Metadata space used in the Storage Driver. Only Device Mapper driver is supported. | |
StorageMetadataUsedBytes bytes (B) | Metadata space used by the Storage Driver. Only Device Mapper driver is supported. | |
commandLine | The command line used in the container. | |
containerId ID | The unique Docker container ID. | |
cpuKernelPercent percentage (%) | CPU time percentage used in kernel space. | |
cpuLimitCores count | How much of the available CPU resources a container can use. | |
cpuPercent percentage (%) | CPU usage percentage used. | |
cpuShares count | Number of CPU shares assigned to the container; increase or reduce the container's weight and give access to greater or lesser host machine CPU cycles. Weight may differ between cgroups v1 and cgroups v2. | |
cpuThrottlePeriods count | Total number of periods throttled. | |
cpuThrottleTimeMs milliseconds (ms) | Total throttling time in milliseconds. | |
cpuUsedCores percentage (%) | CPU usage per core. | |
cpuUsedCoresPercent percentage (%) | CPU usage percentage per core. | |
cpuUserPercent percentage (%) | CPU time percentage used in user space. | |
criticalViolationCount count | The number of times that alert conditions violated critical thresholds, causing critical violations and opening incidents. If this attribute does not exist on the sample, it has zero violations. | |
image ID | The Docker image ID for the image the container is based on. | |
imageName | The Docker image name for the container. | |
label_KEY | Docker labels associated with this container (where KEY represents a custom label's key value). | |
memoryCacheBytes count | The amount of memory used by the container that can be associated precisely with a block on a block device. | |
memoryKernelUsageBytes bytes (B) | The amount of current kernel memory allocation. | |
memoryResidentSizeBytes bytes (B) | The amount of memory that doesn't correspond to anything on disk: stacks, heaps, and anonymous memory maps. | |
memorySizeLimitBytes bytes (B) | The total amount of memory the container is allowed to use. | |
memorySoftLimitBytes bytes (B) | The soft limit of memory usage equivalent to the memory reservation of the container. | |
memorySwapLimitBytes bytes (B) | The total amount of memory the container is using, including swap. | |
memorySwapLimitUsagePercent percentage (%) | This metric is calculated as the percentage of | |
memorySwapOnlyUsageBytes bytes (B) | The amount of swap memory the container is using. This memory doesn't include non-swap memory. | |
memorySwapUsageBytes bytes (B) | The amount of memory swap the container is using, including swap. | |
memoryUsageBytes bytes (B) | This metric doesn't account for swap usage. | |
memoryUsageLimitPercent percentage (%) | This metric is calculated as the | |
name | The Docker container name. | |
networkRxBytes bytes (B) | Total number of received bytes. | |
networkRxBytesPerSecond rate | Number of received bytes per second. | |
networkRxDropped count | Total number of received packets dropped. | |
networkRxDroppedPerSecond rate | Number of received packets dropped per second. | |
networkRxError count | Total number of received packets with error. | |
networkRxErrorsPerSecond rate | Number of received packets with error per second. | |
networkRxPackets count | Total number of received packets. | |
networkRxPacketsPerSecond rate | Number of received packets with error per second. | |
networkTxBytesPerSecond rate | Number of transmitted bytes per second. | |
networkTxDropped count | Total number of transmitted packets dropped. | |
networkTxDroppedPerSecond rate | Number of transmitted packets dropped per second. | |
networkTxErrors count | Total number of transmitted packets with error. | |
networkTxErrorsPerSecond rate | Number of transmitted packets with error per second. | |
networkTxPackets count | Total number of transmitted packets. | |
networkTxPacketsPerSecond rate | Number of transmitted packets per second. | |
networksTxBytes count | Total number of bytes transmitted. | |
restartCount count | The number of times the container was restarted. | |
state | It can be: created, restarting, running, removing, paused, exited, or dead. | |
status | Holds the current container state. | |
warningViolationCount count | The number of times that alert conditions violated warning thresholds, causing warning violations. |
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.
Attribute name | Definition | Data 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. |
InfrastructureEvent describes changes (deltas) that occur in a system's live state. When an inventory or system state is added, removed, or changed, Infrastructure will produce an InfrastructureEvent that logs that activity.
Attribute name | Definition | Data types |
---|---|---|
category | A New Relic category used to organize events in the UI. For example: automation, notification, and service. | |
changeType | A simple classification of the type of change made to the entity: added, modified, or removed. | |
changedPath | The fully specified name of the item that changed. This is constructed by taking the source and adding one or more additional path elements that uniquely identify the item that changed. | |
deltaId | Delta refers to a recorded change in the system. The deltaId is a number used by New Relic to organize incoming inventory change data. | |
eventId | The unique ID of the event, generated by New Relic. | |
format | The type of infrastructure event. Each format type includes attributes that may be used to render the event in the UI. | |
newStatus | The new agent status: disconnected or connected. | |
newValue | If a change is made to the entity, this attribute contains the new value of the inventory that was changed. This will have no value if no change has been made. The value will display approximately 4K bytes of data. | |
oldValue | If a change is made to the entity, this attribute contains the old value of the inventory that was changed. This will be blank if no change has been made. | |
provider | For integrations that use generic event types (like the DatastoreSample event), the provider value specifies the source of the data (the service, or a sub-category of data from that service). Some events are generic and are used by several integrations. For example, the When a provider value is present for a generic event, that event will have additional integration-specific attributes attached to it. Here’s an example of a NRQL query that returns the attributes present for a SELECT * from DatastoreSample where provider = 'RdsDbCluster' | |
source | The fully specified origin of this inventory item. This is typically in the form category/plugin, where plugin is the generic word used for the tool that gathered this data. | |
summary | A summary of the change that happened. Uses a human-friendly string, such as Agent disconnected. | |
violationUpdateType | The type of change to the violation: For example: open or closed. |
As JavaScript errors are triggered, we capture details as events. The JavaScriptError event contains information to help you segment errors to understand how they impact performance.
Attribute name | Definition | Data types |
---|---|---|
actionText | The text of the HTML element that was clicked when a browser interaction started. Added to | |
appId ID | The identification number for the reporting browser agent. | |
appName | The name of the application that handled the request as shown in browser monitoring. | |
asn | Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user. | |
asnLatitude | 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. | |
asnLongitude | 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. | |
asnOrganization | The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution. | |
browserInteractionId ID | A unique value generated for each browser interaction captured by the New Relic agent. | |
browserStackHash ID | An unique identifier generated for a stack trace. The browserStackHash for a stack trace is different across different browsers. An identical stack trace will generate the same identifier. | |
city | The city in which the event occurred, such as Portland or Seattle. | |
countryCode | The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2. | |
deviceType | The type of device that loaded the page: mobile, tablet, or desktop. | |
domain | The domain portion of the request URL. | |
entityGuid | The unique identifier of the monitor referenced in New Relic One. | |
errorClass | The error type of the JavaScript Error object. Examples: ReferenceError, SyntaxError, and UncaughtException. | |
errorMessage | The error message that was delivered. | |
firstErrorInSession | A value to indicate whether or not this was the first JS error in the session. Example: true. | |
monitorAccountId | The synthetic monitoring account from which you are running the monitor. | |
monitorId ID | A unique number identifying a particular monitor. | |
monitorJobId ID | The ID of a single synthetic monitor run, which began at a specific time and originated from a specific location. | |
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. | |
parentEventId ID | A unique value generated for each interaction with the page. You can use this value to group interactions together. | |
regionCode | The specific administrative division within a country where the In the United States, regions correspond to state codes ; for example, | |
releaseIds ID | The releases in which the app was updated. Example: {\"jQuery\":\"v3.1.1\",\"multiverse\":\"96e9ac7\"}. | |
requestUri | The URI of the requested resource. | |
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. | |
stackHash ID | A unique identifier generated by the Browser agent for a stack trace. The stackHash for a stack trace is the same across different browsers. An identical stack trace will generate the same identifier. | |
stackTrace | A collection of the active stack frames when the error occurred. | |
stackTraceGzip | A compressed version of the stackTrace attribute. | |
timestamp | The time that the error occurred, in Unix time. | |
transactionName | The full metric name of the transaction in which the error occurred, or Unknown if the error occurs outside of a transaction. | |
userAgentName | The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request. | |
userAgentOS | 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. | |
userAgentVersion | The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request. |
Represents a metric data point (a measurement over a range of time, or a sample at a specific point in time) with multiple attributes attached, which allow for in-depth analysis and querying. This metric data comes from our Metric API, our Telemetry SDKs, network performance monitoring, and some of our open-source exporters/integrations.
Attribute name | Definition | Data types |
---|---|---|
endTimestamp milliseconds (ms) | The end of the time range associated with the metric, in Unix time, in milliseconds. This is calculated by adding the metric interval to the timestamp of the metric (timestamp + interval.ms). | |
interval.ms milliseconds (ms) | The length of the time window. | |
metricName | Name of the metric. | |
newrelic.source | The source of this data. For example: metricAPI. | |
timestamp milliseconds (ms) | The start time for the metric, in Unix time. |
A Mobile event is created when a crash occurs, when an interaction ends or has run for 1 second, or if a session completes after the app is closed, backgrounded, or has run for 10 minutes. Mobile events were once the only event type and were generated for every event, but now there are several specialized event types. Recommendation: Upgrade to the most recent mobile monitoring agent version to take full advantage of the new event types.
Attribute name | Definition | Data types |
---|---|---|
carrier | The network over which the app transferred data, such as Wi-Fi, Verizon, or Sprint. | |
category | The type of data: session, crash, or interaction. | |
city | The city in which the event occurred, such as Portland or Seattle. | |
countryCode | The country from which the device ran the application. For a list of country codes, see ISO 3166-1 alpha-2. | |
device | The specific type of the device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceGroup | The category of the device, such as iPhone or Tablet. | |
deviceManufacturer | The manufacturer of the device, such as Motorola or HTC. | |
deviceModel | The model number of the device, such as XT1039 or SM-G900F. | |
deviceName | The device's name. | |
deviceType | The specific type of device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceUuid ID | A unique identifier assigned at the time of app installation by New Relic. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Duplicate of | |
interactionDuration | For interaction category events only. This is the total time for the interaction to render on the device. In addition to render time, this usually includes all external calls associated with the interaction. Currently, this attribute is measured in seconds for Android devices and in milliseconds for iOS devices. | |
lastInteraction | The last interaction before a crash or harvest event, if one is present. | |
name | For interaction category events only. This is the label of the interaction associated with the event. It is by default assigned by New Relic. For example: ApplicationsListFragment or Display iOS_Example.MasterViewController. | |
osBuild | For Android only. The specific build of the Android OS. | |
regionCode | The specific region within a country where the monitored app is located. In the United States, regions are states. The regionCode is based on IP address and may not always match your region. | |
reportedTimestampMs milliseconds(ms) | The UTC based timestamp for when the event was sent to New Relic. This is different from the attribute ‘timestamp’, which is when the event began. | |
timeSinceLoad seconds (s) | The time, in seconds, from the beginning of the mobile session to the time the event occurred. | |
timestamp | The UTC epoch time at which an event began. |
The MobileCrash event is created when an app crashes. MobileCrash includes attributes such as crash line number, class, and crash message.
Attribute name | Definition | Data types |
---|---|---|
appBuild ID | Indicates the technical build number of the app binary. As a developer, you can use this attribute to identify specific builds of your app. | |
appId ID | A unique identifier for a monitored app, based on the app token. For example: 35091. | |
appName | The name of the monitored app. For example: My Mobile App - iOS. | |
appVersion | The version number of the monitored app. For example: 2.2.9. | |
appVersionId ID | An identifier for the specific version of the app. For example: 1713477. | |
architecture | The processor architecture of the device. For example: armv7 or arm64. | |
asnOwner | The telecom owner of the ASN. | |
bundleId ID | The unique string used to identify the application. | |
carrier | The network over which the app transferred data, such as Wi-Fi, Verizon, or Sprint. | |
category | The type of data: session, crash, or interaction. | |
city | The city in which the event occurred, such as Portland or Seattle. | |
countryCode | The country from which the device ran the application. For a list of country codes, see ISO 3166-1 alpha-2. | |
crashException | The exception associated with the crash, if one is present. For example: java.lang.NullPointerException. Native crashes exceptions are associated with com.newrelic.agent.android.ndk.NativeException classes. | |
crashFingerprint ID | The New Relic-generated fingerprint used to uniquely identify the crash and other crashes identical to this one. | |
crashLocationClass | The class name in which the crash occurred. Requires symbolication. | |
crashLocationFile | The file in which the crash occurred. | |
crashLocationLineNumber | The line number in which the crash occurred. Requires symbolication. | |
crashLocationMethod | The method name in which the crash occurred. Requires symbolication. | |
crashMessage | The message associated with the crash, if one is present. | |
device | The specific type of the device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceGroup | The category of the device, such as iPhone or Tablet. | |
deviceManufacturer | The manufacturer of the device, such as Motorola or HTC. | |
deviceModel | The model number of the device, such as XT1039 or SM-G900F. | |
deviceName | The device's name. | |
deviceType | The specific type of device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceUuid ID | A unique identifier assigned at the time of app installation by New Relic. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Duplicate of | |
diskAvailable bytes (B) | Space available on the device, in bytes. | |
interactionHistory | The client interactions with the application that led to the crash. | |
isFirstOccurrence | A boolean value indicating whether or not this was the first occurrence of the crash. | |
lastInteraction | The last interaction before a crash or harvest event, if one is present. | |
memUsageMb megabytes (MB) | The total amount of memory, in MB, used by the application. Updated every 60 seconds. | |
memoryUsage megabytes (MB) | The total amount of memory, in MB, used by the application. Updated every 60 seconds. | |
modelNumber | The model of the device. This is the same as the session-level deviceModel attribute. | |
networkStatus | The type of network that the device was on at the time of crash, such as wifi or LTE. | |
newRelicVersion | The version number of the agent running on the application. For example: 4.232.0. Duplicate of | |
occurrenceId ID | The ID for this instance of the crash. | |
orientation | The orientation of the device, such as landscape or portrait. | |
osBuild | For Android only. The specific build of the Android OS. | |
osMajorVersion | The simplified version number of the app's host operating system, such as iOS 11, as compared to iOS 11.0.4. | |
osName | The name of the app's host operating system, for example, iOS or Android. | |
osVersion | The exact version number of the app's host operating system, such as iOS 11.0.4, as compared to iOS 11. | |
parentProcess | The parent process that launched the crashing process. | |
parentProcessId ID | The parent identification number (PID) of the parent process. | |
platform | The platform type of the mobile monitoring agent, such as native or Cordova. | |
processId ID | The PID of the previously running process on the device. | |
processName | The name of the previously running process. | |
processPath | The path to the binary. | |
regionCode | The specific region within a country where the monitored app is located. In the United States, regions are states. The regionCode is based on IP address and may not always match your region. | |
reportedTimestampMs milliseconds(ms) | The UTC based timestamp for when the event was sent to New Relic. This is different from the attribute ‘timestamp’, which is when the event began. | |
reportedTimestampMs milliseconds(ms) | The UTC based timestamp for when the event was sent to New Relic. This is different from the attribute ‘timestamp’, which is when the event began. | |
runTime | For Android only. The Android Runtime version where the exception/crash was generated. | |
screenResolution | The size of the screen for the device, grouped into three categories: normal, large, xlarge. | |
sessionCrashed | A boolean value indicating whether or not that session crashed. | |
sessionId ID | A unique identifier for a single user session. A new sessionId is created each time the app is brought into the foreground. | |
symbolicated | A boolean value indicating whether or not the crash was properly symbolicated. | |
timeSinceLastInteraction milliseconds (ms) | The time, in milliseconds, since the interaction before a crash event. | |
timestamp | The UTC epoch time at which an event began. | |
userImageUuids ID | The array of build UUIDs for applications and libraries. | |
uuid ID | A unique identifier assigned by New Relic for a specific app on a particular device. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Dupliate of |
MobileHandledException is sent when an exception is caught and is used for non-fatal exceptions reported to New Relic using the recordHandledException API for Android or iOS.
Attribute name | Definition | Data types |
---|---|---|
appBuild ID | Indicates the technical build number of the app binary. As a developer, you can use this attribute to identify specific builds of your app. | |
appId ID | A unique identifier for a monitored app, based on the app token. For example: 35091. | |
appName | The name of the monitored app. For example: My Mobile App - iOS. | |
appVersion | The version number of the monitored app. For example: 2.2.9. | |
appVersionId ID | An identifier for the specific version of the app. For example: 1713477. | |
asn | Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user. | |
asnOwner | The telecom owner of the ASN. | |
carrier | The network over which the app transferred data, such as Wi-Fi, Verizon, or Sprint. | |
city | The city in which the event occurred, such as Portland or Seattle. | |
countryCode | The country from which the device ran the application. For a list of country codes, see ISO 3166-1 alpha-2. | |
device | The specific type of the device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceGroup | The category of the device, such as iPhone or Tablet. | |
deviceManufacturer | The manufacturer of the device, such as Motorola or HTC. | |
deviceModel | The model number of the device, such as XT1039 or SM-G900F. | |
deviceName | The device's name. | |
deviceType | The specific type of device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceUuid ID | A unique identifier assigned at the time of app installation by New Relic. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Duplicate of | |
exceptionAppBuildUuid ID | The build uuid of the application binary in which the exception was caught. | |
exceptionCause | The unsymbolicated, platform-specific cause of the exception. | |
exceptionLocation | New Relic defined location of an exception. Contains a combination of exception file name, class, line number, and method. | |
exceptionLocationClass | The class that generated the exception. Only present if symbolication succeeded. | |
exceptionLocationFile | The class that generated the exception. Only present if symbolication succeeded. | |
exceptionLocationLibraryOffset | For XCFramework agent only. The library offset of the library that generated the exception. Only present if symbolication succeeded. | |
exceptionLocationLine | Comes from the exception: The line number where the exception was generated. Only present if symbolication succeeded. | |
exceptionLocationMethod | The method that generated the exception. Only present if symbolication succeeded. | |
exceptionMessage | The unsymbolicated message from the exception. It can be user-generated or a generic system message. For Android, this is the Throwable message. | |
exceptionName | The unsymbolicated exception type. | |
fingerprint ID | The New Relic-generated identifier used to group like exceptions. | |
handledExceptionUuid ID | The unique ID of the exception event. | |
lastInteraction | The last interaction before a crash or harvest event, if one is present. | |
libraryName | For XCFramework agent only. The library name where the exception was generated. | |
libraryStartAddr | For XCFramework agent only. The library start address where the exception was generated. | |
memUsageMb megabytes (MB) | The total amount of memory, in MB, used by the application. Updated every 60 seconds. | |
newRelicVersion | The version number of the agent running on the application. For example: 4.232.0. Duplicate of | |
occurrenceTimestamp | Agent-reported epoch timestamp of the handled exception. | |
osBuild | For Android only. The specific build of the Android OS. | |
osMajorVersion | The simplified version number of the app's host operating system, such as iOS 11, as compared to iOS 11.0.4. | |
osName | The name of the app's host operating system, for example, iOS or Android. | |
osVersion | The exact version number of the app's host operating system, such as iOS 11.0.4, as compared to iOS 11. | |
platform | The platform type of the mobile monitoring agent, such as native or Cordova. | |
regionCode | The specific region within a country where the monitored app is located. In the United States, regions are states. The regionCode is based on IP address and may not always match your region. | |
runTime | For Android only. The Android Runtime version where the exception/crash was generated. | |
sessionId ID | A unique identifier for a single user session. A new sessionId is created each time the app is brought into the foreground. | |
timeSinceLoad seconds (s) | The time, in seconds, from the beginning of the mobile session to the time the event occurred. | |
timestamp | The UTC epoch time at which an event began. | |
timestamp | The UTC epoch time at which an event began. | |
uuid ID | A unique identifier assigned by New Relic for a specific app on a particular device. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Dupliate of |
A MobileRequest event is created when an HTTP request successfully completes, resulting in a response code below 400.
Attribute name | Definition | Data types |
---|---|---|
appBuild ID | Indicates the technical build number of the app binary. As a developer, you can use this attribute to identify specific builds of your app. | |
appId ID | A unique identifier for a monitored app, based on the app token. For example: 35091. | |
appName | The name of the monitored app. For example: My Mobile App - iOS. | |
appVersion | The version number of the monitored app. For example: 2.2.9. | |
appVersionId ID | An identifier for the specific version of the app. For example: 1713477. | |
asn | Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user. | |
asnOwner | The telecom owner of the ASN. | |
bytesReceived bytes (B) | Optional: If the application received a response from the requestUrl, the size of that response in bytes. | |
bytesSent bytes (B) | Optional: If the application sent a request to the requestUrl, the size of that request in bytes. | |
carrier | The network over which the app transferred data, such as Wi-Fi, Verizon, or Sprint. | |
city | The city in which the event occurred, such as Portland or Seattle. | |
connectionType | The type of connection which the device was using, such as 2G or 3G. | |
countryCode | The country from which the device ran the application. For a list of country codes, see ISO 3166-1 alpha-2. | |
device | The specific type of the device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceGroup | The category of the device, such as iPhone or Tablet. | |
deviceManufacturer | The manufacturer of the device, such as Motorola or HTC. | |
deviceModel | The model number of the device, such as XT1039 or SM-G900F. | |
deviceName | The device's name. | |
deviceSize | The display size of the device: Small, normal, large, xlarge. | |
deviceType | The specific type of device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceUuid ID | A unique identifier assigned at the time of app installation by New Relic. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Duplicate of | |
duration seconds (s) | Optional: The time to complete the request, measured in fractional seconds. | |
guid ID | The unique identifier for the segment. This is equivalent to spanID in OpenTracing semantics. | |
lastInteraction | The last interaction before a crash or harvest event, if one is present. | |
memUsageMb megabytes (MB) | The total amount of memory, in MB, used by the application. Updated every 60 seconds. | |
newRelicVersion | The version number of the agent running on the application. For example: 4.232.0. Duplicate of | |
osMajorVersion | The simplified version number of the app's host operating system, such as iOS 11, as compared to iOS 11.0.4. | |
osName | The name of the app's host operating system, for example, iOS or Android. | |
osVersion | The exact version number of the app's host operating system, such as iOS 11.0.4, as compared to iOS 11. | |
platform | The platform type of the mobile monitoring agent, such as native or Cordova. | |
regionCode | The specific region within a country where the monitored app is located. In the United States, regions are states. The regionCode is based on IP address and may not always match your region. | |
requestDomain | The domain that the application attempted to access when the event occurred. | |
requestFingerprint ID | The New Relic-generated identifier used to group like request events. | |
requestMethod | The REST method (GET, PUT, POST, etc.) that the application attempted when the event occurred. | |
requestPath | The path that the application attempted to access when the event occurred. | |
requestUrl | The URL that the application attempted to access when the event occurred. | |
requestUuid ID | A unique identifer for the request event. | |
responseTime seconds (s) | The time between the request and the response in fractional seconds. | |
sessionId ID | A unique identifier for a single user session. A new sessionId is created each time the app is brought into the foreground. | |
statusCode | Optional: The HTTP status code for the HTTP event. | |
timeSinceLoad seconds (s) | The time, in seconds, from the beginning of the mobile session to the time the event occurred. | |
timestamp | The UTC epoch time at which an event began. | |
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. | |
uuid ID | A unique identifier assigned by New Relic for a specific app on a particular device. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Dupliate of |
A MobileRequestError is used for HTTP errors or network failures. HTTP errors are HTTP requests that have a status code greater than 400. A network failure is a HTTP request that results in no response. The event is sent when the HTTP request completes.
Attribute name | Definition | Data types |
---|---|---|
appBuild ID | Indicates the technical build number of the app binary. As a developer, you can use this attribute to identify specific builds of your app. | |
appId ID | A unique identifier for a monitored app, based on the app token. For example: 35091. | |
appName | The name of the monitored app. For example: My Mobile App - iOS. | |
appVersion | The version number of the monitored app. For example: 2.2.9. | |
appVersionId ID | An identifier for the specific version of the app. For example: 1713477. | |
asn | Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user. | |
asnOwner | The telecom owner of the ASN. | |
bytesReceived bytes (B) | Optional: If the application received a response from the requestUrl, the size of that response in bytes. | |
bytesSent bytes (B) | Optional: If the application sent a request to the requestUrl, the size of that request in bytes. | |
carrier | The network over which the app transferred data, such as Wi-Fi, Verizon, or Sprint. | |
city | The city in which the event occurred, such as Portland or Seattle. | |
connectionType | The type of connection which the device was using, such as 2G or 3G. | |
countryCode | The country from which the device ran the application. For a list of country codes, see ISO 3166-1 alpha-2. | |
device | The specific type of the device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceGroup | The category of the device, such as iPhone or Tablet. | |
deviceManufacturer | The manufacturer of the device, such as Motorola or HTC. | |
deviceModel | The model number of the device, such as XT1039 or SM-G900F. | |
deviceName | The device's name. | |
deviceSize | The display size of the device: Small, normal, large, xlarge. | |
deviceType | The specific type of device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceUuid ID | A unique identifier assigned at the time of app installation by New Relic. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Duplicate of | |
duration seconds (s) | Optional: The time to complete the request, measured in fractional seconds. | |
errorType | 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. | |
guid ID | The unique identifier for the segment. This is equivalent to spanID in OpenTracing semantics. | |
lastInteraction | The last interaction before a crash or harvest event, if one is present. | |
memUsageMb megabytes (MB) | The total amount of memory, in MB, used by the application. Updated every 60 seconds. | |
networkError | The error message associated with the iOS NSURL Error code. See networkErrorCode for more information. | |
networkErrorCode | If the error is a network error, this is the iOS network error code. For Android applications, this is the mapped value. | |
newRelicVersion | The version number of the agent running on the application. For example: 4.232.0. Duplicate of | |
osMajorVersion | The simplified version number of the app's host operating system, such as iOS 11, as compared to iOS 11.0.4. | |
osName | The name of the app's host operating system, for example, iOS or Android. | |
osVersion | The exact version number of the app's host operating system, such as iOS 11.0.4, as compared to iOS 11. | |
platform | The platform type of the mobile monitoring agent, such as native or Cordova. | |
regionCode | The specific region within a country where the monitored app is located. In the United States, regions are states. The regionCode is based on IP address and may not always match your region. | |
requestDomain | The domain that the application attempted to access when the event occurred. | |
requestErrorFingerprint ID | The New Relic-generated identifier used to group like request error events. | |
requestMethod | The REST method (GET, PUT, POST, etc.) that the application attempted when the event occurred. | |
requestPath | The path that the application attempted to access when the event occurred. | |
requestUrl | The URL that the application attempted to access when the event occurred. | |
requestUuid ID | A unique identifer for the request event. | |
responseBody | Optional: The response that is sent from the requestDomain for the HTTP error, up to 4096 bytes. | |
responseTime seconds (s) | The time between the request and the response in fractional seconds. | |
sessionId ID | A unique identifier for a single user session. A new sessionId is created each time the app is brought into the foreground. | |
statusCode | Optional: The HTTP status code for the HTTP event. | |
timeSinceLoad seconds (s) | The time, in seconds, from the beginning of the mobile session to the time the event occurred. | |
timestamp | The UTC epoch time at which an event began. | |
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. | |
uuid ID | A unique identifier assigned by New Relic for a specific app on a particular device. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Dupliate of |
A MobileSession event is sent when an app is closed, backgrounded, or when 10 minutes of active use has elapsed. This is the source of the general session data used by the other mobile monitoring events. MobileSession captures attributes such as device type, device OS, and geographical information.
Attribute name | Definition | Data types |
---|---|---|
appBuild ID | Indicates the technical build number of the app binary. As a developer, you can use this attribute to identify specific builds of your app. | |
appId ID | A unique identifier for a monitored app, based on the app token. For example: 35091. | |
appName | The name of the monitored app. For example: My Mobile App - iOS. | |
appVersion | The version number of the monitored app. For example: 2.2.9. | |
appVersionId ID | An identifier for the specific version of the app. For example: 1713477. | |
asn | Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user. | |
asnOwner | The telecom owner of the ASN. | |
bundleId ID | The unique string used to identify the application. | |
carrier | The network over which the app transferred data, such as Wi-Fi, Verizon, or Sprint. | |
category | The type of data: session, crash, or interaction. | |
city | The city in which the event occurred, such as Portland or Seattle. | |
countryCode | The country from which the device ran the application. For a list of country codes, see ISO 3166-1 alpha-2. | |
device | The specific type of the device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceGroup | The category of the device, such as iPhone or Tablet. | |
deviceManufacturer | The manufacturer of the device, such as Motorola or HTC. | |
deviceModel | The model number of the device, such as XT1039 or SM-G900F. | |
deviceName | The device's name. | |
deviceType | The specific type of device: iPhone 8, iPad Pro, etc. Duplicate of | |
deviceUuid ID | A unique identifier assigned at the time of app installation by New Relic. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Duplicate of | |
install | Indicates true only if the current session is the first session after app install. | |
lastInteraction | The last interaction before a crash or harvest event, if one is present. | |
memUsageMb megabytes (MB) | The total amount of memory, in MB, used by the application. Updated every 60 seconds. | |
newRelicAgent | The New Relic agent running on the application. For example: the iOSAgent or the androidAgent. | |
newRelicVersion | The version number of the agent running on the application. For example: 4.232.0. Duplicate of | |
osMajorVersion | The simplified version number of the app's host operating system, such as iOS 11, as compared to iOS 11.0.4. | |
osName | The name of the app's host operating system, for example, iOS or Android. | |
osVersion | The exact version number of the app's host operating system, such as iOS 11.0.4, as compared to iOS 11. | |
platform | The platform type of the mobile monitoring agent, such as native or Cordova. | |
regionCode | The specific region within a country where the monitored app is located. In the United States, regions are states. The regionCode is based on IP address and may not always match your region. | |
sessionCrashed | A boolean value indicating whether or not that session crashed. | |
sessionDuration seconds (s) | The length of time for which the user used the application in seconds. If the session crashes, sessionDuration is not captured (although other events and attributes are still recorded). For sessions longer than 10 minutes, events in the Interaction and Custom event categories are sent to New Relic while the session is ongoing, and therefore do not have sessionDuration attributes. Events recorded near the end of the session will include the duration, as will the Session event category. | |
sessionId ID | A unique identifier for a single user session. A new sessionId is created each time the app is brought into the foreground. | |
timeSinceLoad seconds (s) | The time, in seconds, from the beginning of the mobile session to the time the event occurred. | |
timestamp | The UTC epoch time at which an event began. | |
upgradeFrom | Indictates previous version number only if this is the first launch after app upgrade. | |
uuid ID | A unique identifier assigned by New Relic for a specific app on a particular device. It is only reset if a user deletes and then reinstalls the app. For example: B8B0BC30-0235-11E4-9191-0800200C9A66. Dupliate of |
NetworkSample event captures the descriptive and state information for each network device associated with a server. It includes the device's interface and address information, as well as current usage data. New Relic samples this data every 10 seconds for each attached network interface and packages it into a NetworkSample event, then sends the raw data to New Relic's collectors every 60 seconds.
Attribute name | Definition | Data types |
---|---|---|
agentName | The name of the agent (Infrastructure). | |
agentVersion | The version of the New Relic Infrastructure agent. | |
criticalViolationCount count | The number of times that alert conditions violated critical thresholds, causing critical violations and opening incidents. If this attribute does not exist on the sample, it has zero violations. | |
entityID ID | New Relic's unique ID number for the entity that is reporting data. This is used by New Relic to distinguish between customers and their entities. | |
fullHostname | The fully qualified (DNS) hostname. | |
hardwareAddress | The unique hardware address of the interface. | |
hostname | The short version of the entity's name. | |
interfaceName | The interface name as reported by the operating system. | |
ipV4Address | The IP version 4 address. | |
ipV6Address | The IP version 6 address. | |
kernelVersion | The Linux kernel version, in string format. This attribute is available only for systems on a Linux platform. | |
linuxDistribution | The name of the Linux distribution the server is using. This attribute is available only for systems on a Linux platform. | |
operatingSystem | The operating system on which the agent is installed. | |
receiveBytesPerSecond bytes (B) | The number of bytes per second received during the sampling period. | |
receiveDroppedPerSecond count | The number of received packets per second dropped during the sampling period. | |
receiveErrorsPerSecond count | The number of receive errors per second on the interface during the sampling period. | |
receivePacketsPerSecond count | The number of packets per second (as defined by OS) received during the sampling period. | |
state | The state of the entity: either up or down. | |
timestamp | The time (date, hour, minute, second) at which the interaction occurred. | |
transmitBytesPerSecond bytes (B) | The number of bytes sent per second during the sampling period. | |
transmitDroppedPerSecond count | The number of dropped send packets per second during the sampling period. | |
transmitErrorsPerSecond count | The number of send errors per second on the interface during the sampling period. | |
transmitPacketsPerSecond count | The number of packets per second as defined by OS) sent during this sampling period. | |
warningViolationCount count | The number of times that alert conditions violated warning thresholds, causing warning violations. | |
windowsFamily | The Windows family indicates whether the OS is a server or desktop targeted system. This attribute is available only for systems on a Windows platform. | |
windowsPlatform | The full product name of the installed version of Windows. This attribute is available only for systems on a Windows platform. | |
windowsVersion | The combined Windows version and build-number string of the OS. This attribute is available only for systems on a Windows platform. |
An NrAiIncident is created when violation of an alerts condition generates a violation event, which passes important information downstream.
Attribute name | Definition | Data types |
---|---|---|
accountId | The ID of the account where the violation occurred. Available for muting rules. | |
aggregationDuration | The active condition's aggregation window. | |
closeCause | If applicable, what caused the incident to close. Available values: | |
closeTime | If applicable, the timestamp when the incident was closed. | |
closeViolationsOnExpiration | If true, open violations on the signal are closed if the signal is lost. Default is false. To use this field, an | |
conditionId | The ID of the condition that triggered the violation. Available for muting rules. | |
conditionName | The name of the condition that triggered the violation. Available for muting rules. | |
degradationTime | The timestamp when the targeted metric started to breach the active condition’s threshold. | |
description | The contents of the active condition’s NRQL or Infrastructure conditions only. | |
entity.guid | The targeted entity's globally unique identifier, if available. | |
entity.name | The targeted entity's name, if available. | |
entity.type | The targeted entity's type, if available. | |
evaluationOffsetSeconds | The active condition's evaluation offset. A time delay (in seconds) to ensure data points are placed in the correct aggregation window. | |
evaluationType | The reason the violation was opened. Available values:
| |
event | The record's event type. Available values: | |
expirationDuration | The active condition's signal loss time window. | |
incidentId | The unique identifier of the violation. | |
muted | Shows whether the active condition was muted at the time of the violation event. | |
mutingRuleId | The unqiue identifier of the muting rule that caused the violation to be muted. | |
nrqlEventType | The type of data targeted by a NRQL condition. In this context, this refers to any NRQL-queryable data type. Available for muting rules. | |
nrqlQuery | The full string of the NRQL query. Can be used for sub-string matching on attributes in the Available for muting rules. | |
openTime | The timestamp when the violation was opened. | |
operator | The violation threshold's operator, such as For signal loss violations, this is an empty string. | |
policyId | The ID of the policy that triggered the violation. Available for muting rules. | |
policyName | The name of the policy that triggered the violation. Available for muting rules. | |
priority | The level of the violation: | |
recoveryTime | The timestamp when the active condition's targeted metric stops breaching the threshold. | |
runbookUrl | The runbook URL for the condition that triggered the violation. Available for muting rules. | |
tags.* | Arbitrary key-value metadata, or tags, associated with the violation. Available for muting rules. | |
targetName | The name of the violation’s target. This can be an entity or a query. Available for muting rules. | |
threshold | The active condition's threshold value. | |
thresholdDuration | The active condition's threshold time window. | |
thresholdOccurrences | Shows whether | |
timestamp | The event's wall clock time using an epoch timestamp. | |
title | The incident's title. | |
type | The incident's type. Available values: | |
valueFunction | The active condition's aggregation function. Used in APM, browser, and mobile alert condition types. | |
violationTimeLimitSeconds | The active condition's violation time limit setting. | |
violationUuId | Deprecated. Do not use. |
An NrAiIncidentExternal event is created when a custom incident event is received via the incident event API.
Attribute name | Definition | Data types |
---|---|---|
aggregationTag.* | The When resolving an incident, make sure the resolve event includes the same aggregation tag. | |
deepLinkUrl | A URL to a page related to the incident. | |
description | The triggering event description. | |
entity.guid | The GUID, or globally unique identifier, is the identifier of the entity linked to the incident. | |
priority | The incident's priority: | |
runbookUrl | The runbook URL for the condition that triggered the violation. | |
source | The system that triggered the notification, not the entity that faulted. Required for trigger. | |
state | Whether the event should trigger a new incident or resolve an existing one. The values can be | |
tag.* | Arbitrary key-value metadata, or tags, associated with the violation. | |
timestamp | The event's wall clock time using an epoch timestamp. | |
title | The triggering event title. Required for trigger. | |
version | The version of the current format. |
NrAiSignal shows details from every NRQL alert condition and every signal on your account, for every aggregation window that passes. This data is posted immediately after each aggregation window is aggregated and evaluated, so it will show you exactly what our alerts are seeing.
Attribute name | Definition | Data types |
---|---|---|
aggregatedDataPointsCount | Count of the number of data points that were aggregated for this window. | |
aggregationDuration | Duration of the aggregation window of the active condition, in seconds. | |
conditionId | ID of the active condition. | |
endTimestamp | Moment when this event was created, and the end of the aggregation window. | |
entity.guid | GUID of the active entity. | |
entity.type | Type of the active entity. Note that | |
error | This captures any errors when evaluating the signal. | |
event | The type of event captured in this data point.
| |
expirationDuration | Duration of the loss of signal of the active condition. | |
expirationLastSeenTime | Exclusively for expiration events, it's the wall-clock time of the last data point received. | |
fillOption | Gap-filling setting from the active condition. | |
numberOfDeviations | For baseline conditions only. Indicates the number of standard deviations between the actual value and the predicted value. Formally called z-score or standard score. | |
predictedValue | For baseline conditions only. Indicates the value that our models predicted for this data point. | |
resetCause | For reset events only. It's the reason why the evaluation stream was reset. | |
serverTime | New Relic’s server clock time when the data point was evaluated. | |
signalId | Unique identifier for this data stream. | |
signalValue | Value of the signal for this aggregation window. | |
slideByDuration | For sliding windows conditions only. Duration of the slide-by interval, in seconds. | |
standardDeviation | Tells you how closely the signal value and the baseline prediction track each other: Standard deviation will be low when they track each other closely, and high when they don't. This attribute uses the same units as the signal. | |
tags.<TagName> | All the system and custom tags that have been added to a signal. | |
timestamp | The start of the aggregation window. | |
type | Always = “signal”. |
An NrAuditEvent is created by New Relic services to record configuration changes made in New Relic products. The data gathered for this event includes the type of account change, actor (user or API key) that made the change, a human-readable description of the action taken, and a timestamp for the change.
Attribute name | Definition | Data types |
---|---|---|
actionIdentifier | Indicates an action that was taken in a New Relic account. The Some examples of
| |
actorAPIKey | ID of the API key taking action. The API key is partially obfuscated to ensure privacy of the key. | |
actorEmail | Email address for the person who made the change. | |
actorId ID | ID of the person taking action. | |
actorIpAddress | The IP address for the person or API key where the action initiated. | |
actorType | Identifies whether the action was initiated by a user (person) or with an API key that is not associated with a user.
| |
description | Human-readable description of the action taken. For example: Added name@company.com to roles Browser manager. | |
id ID | Unique ID of the audit event. | |
scopeId ID | The corresponding account ID for the 'scopeType'. | |
scopeType | Uses the value 'account'. | |
targetId | ID of the object (targetType) that changed. For example, if the targetType is a user, this is the person's New Relic user ID. | |
targetType | The object that changed; for example, account, role, user, alert conditions or notifications, logs, etc. | |
timestamp | Time that the event occurred or was evaluated over. Specifies a time or range of time. Examples:
|
This event records usage every hour, and is the equivalent of "real-time" usage. Use this event to observe usage trends over time. For aggregate views of usage across an entire billing period, use NrMTDConsumption.
Attribute name | Definition | Data types |
---|---|---|
BytesIngested bytes (B) | The number of bytes ingested by the consuming account via either an agent, a custom event API, or another integration. | |
CoreUsers count | The number of core users. | |
FullUsers count | The number of full platform users. | |
GigabytesIngested gibibyte (Gib) | The amount of data ingested by the consuming account. | |
consumingAccountId ID | ID of the New Relic account that's directly responsible for the stored data, as determined from the license key. | |
consumingAccountName | Name of the New Relic account directly responsible for the stored data, as determined from the license key. | |
consumption count | The amount of consumption converted to the unit of pricing. For example, for Data Platform, consumption is equal to GigabytesIngested. For Full Stack Observability, consumption is equal to FullUsers. This attribute is useful if you want to see consumption faceted by productLine or other attribute. | |
estimatedCost count | A cost estimate based on your usage. This is an estimate, not an actual invoiced amount. To be deprecated in May of 2022. | |
masterAccountId ID | The ID of the parent account (also known as the master account) that's either responsible for stored events or that is the parent of the consuming account. When a parent account is the consuming account, | |
masterAccountName | Name of the parent account (also known as the master account) that's either responsible for stored events, or that is the parent of the consuming account. When a parent account is the consuming account, | |
metric enum | Consolidates multiple categories of usage into a single metric. Helpful when faceting by productLine. | |
month | The month and year during which the consumption occurred. Example: August 2020. | |
monthTimestamp | The timestamp of the month during which the consumption occurred. | |
productLine | The New Relic product the usage data is from. Use this attribute to identify / filter for product specific usage data. | |
timestamp | UNIX timestamp (seconds since epoch) of the day and time when event generation was initiated. | |
usageMetric | The underlying NrUsage metric that resulted in the consumption. For example, GigabytesIngested consumption may be made up of ApmEventBytes, BrowserEventBytes, CustomEventBytes and other NrUsage metrics. |
Once per day, New Relic products generate a NrDailyUsage event. Use the productLine attribute to identify and filter for the specific product's usage.
Attribute name | Definition | Data types |
---|---|---|
agentHostname ID | ID reported by the agent to uniquely identify the host for which this usage event is reported. This value can come from several sources in the application's environment, but commonly is the value returned by the gethostname Linux syscall. In Docker environments, this attribute can take on the value (sometimes truncated) of the Docker container ID. agentHostname is one of three possible providers for the hostId value. | |
apmAgentMemoryBytes bytes (B) | Bytes of RAM available to the host, as detected by the New Relic agent from the host OS. | |
apmAgentProcessorCount count | Number of logical CPU cores available to the host, as detected by the New Relic agent from the host OS. | |
apmAgentVersion | Version of the New Relic APM agent running in the application instance reporting this usage. Present only for events where usageType equals Application. To update your agent version, see Update the New Relic agent. | |
apmAppId ID | ID uniquely identifying the application that is reporting this usage, as it appears in the APM product. Present only for events where usageType equals Application. | |
apmAppInstanceId ID | ID uniquely identifying the application instance (the process running the New Relic APM agent). | |
apmAppName | Name of the application reporting this usage, as it appears in the APM product. Present only for events where usageType equals Application. | |
apmBillingInstanceSize | Size of the host, for CU-based billing purposes. Calculated as apmProcessorCount plus (apmMemoryBytes/(1024^3)), or the number of processors plus memory (GiB). | |
apmCloudDerivedMemoryBytes bytes (B) | Bytes of RAM available to the host, as defined by the cloud provider for the host's instance type. | |
apmCloudDerivedProcessorCount count | Number of logical processors available to the host, as defined by the cloud provider for the host's instance type. | |
apmComputeUnitRule | Describes the algorithm used to calculate the host size for CU usage. Values include:
| |
apmComputeUnits count | Number of compute units (CUs) recorded for the given host. CUs are calculated as apmHoursUsed multiplied by apmBillingInstanceSize. For more information, see Compute unit pricing. | |
apmContainerCount count | The number of unique container IDs associated with this host. Present only for events where usageType equals Host. | |
apmHoursUsed | Number of hours for which usage was recorded for the given entity. When an entity is connected to New Relic for any amount of time within a given hour, that hour is counted toward usage. When calculating monthly APM host usage, the calculation for equivalent hosts for a month assumes that a standard month has 750 hours: `apmHoursUsed / 750`. | |
apmLanguage | Name of the language that the usage-reporting application is written in, as reported by the New Relic agent. Examples: ruby, java, python. Present only for events where usageType equals Application. | |
apmMemoryBytes bytes (B) | Bytes of RAM available to the host. Used to calculate apmBillingInstanceSize. The value of one of these attributes will be used: apmCloudDerivedMemoryBytes, apmAgentMemoryBytes. | |
apmProcessorCount | Number of logical processors available to the host, used to calculate apmBillingInstanceSize. The value of one of these attributes will be used: apmCloudDerivedProcessorCount, apmAgentProcessorCount. | |
bootId ID | Linux boot ID of host for which this usage is reported, which is unique for each boot lifetime of each Linux operating system instance. Will only be present when the New Relic agent is one of the following versions: Go: 1.11 or higher Java: 3.42.0 or higher .NET: 6.19.330.0 or higher Node.js: 2.1.0 or higher PHP: 7.5.0.199 or higher Python: 2.90.0.75 or higher Ruby: 4.4.0.336 or higher bootId is one of three possible providers for the hostId value. | |
browserAppId ID | ID uniquely identifying the application reporting this usage, as it appears in the Browser product. Deprecated. | |
browserPageViewCount count | Number of page views for an application for that 24-hour period. For more on how events are generated, see Data generation. Page views for both Pro and Lite Browser agents are counted. | |
cloudInstanceId ID | ID uniquely identifying the cloud host instance (example: an AWS EC2 instance) for which this usage is reported. (For example, for an AWS EC2 instance, the value would look like i-1234abcd5678ef900.) This is used to uniquely identify the host if the apmComputeUnitRule is cloud_provider_data. This will not be present if no cloud provider was detected by the agent. Agents with these versions will detect cloud provider data for AWS: Go: 1.11 or higher Java: 3.18.0 or higher .NET: 5.1.72.0 or higher Node.js: 1.21.0 or higher PHP: 5.5.0 or higher Python: 2.54.0.41 or higher Ruby: 3.12.1.298 or higher cloudInstanceId is one of three possible providers for the hostId value. | |
cloudInstanceSize | Size of the cloud instance for this host for CU-based APM billing purposes. This is calculated according to the formula for apmBillingInstanceSize, using the CPU and memory sizes associated with the instance type defined by the cloud provider. Will not be present if no cloud provider was detected by the agent. | |
cloudInstanceType | Instance type of the host as defined by the cloud provider and detected by the agent. For example: c4.2xlarge. This will not be present if no cloud provider was detected by the agent. | |
cloudProvider | Name of the cloud provider for this host. Example values: aws, azure. This will not be present if no cloud provider was detected by the agent. | |
cloudZone | Name of the zone that a cloud provider host is located in. For example: eu-central-1b. This will not be present if no cloud provider was detected by the agent. | |
consumingAccountId ID | ID of the New Relic account that's directly responsible for the stored data, as determined from the license key. | |
consumingAccountName | Name of the New Relic account directly responsible for the stored data, as determined from the license key. | |
containerId | ID of the Docker or other Linux container in which the application instance is running. This will not be present if a container was not detected by the agent. Present only for events where usageType equals Application. This attribute is not used to uniquely identify hosts for billing purposes. | |
hostId ID | ID used to uniquely identify the host for which this usage is reported. Any given hour of APM usage for this host will be counted only once when calculating apmHoursUsed. There are several possible host identifiers reported by the New Relic agent. The attributes, if present, will be chosen to use in this order of precedence: cloudInstanceId, bootId, agentHostname. | |
infrastructureAgentMemoryBytes bytes (B) | Bytes of RAM available to the host, used to calculate infrastructureBillingInstanceSize. | |
infrastructureAgentProcessorCount count | Number of logical CPU cores available to the host, used to calculate infrastructureBillingInstanceSize. | |
infrastructureAgentVersion | Version of the Infrastructure agent running on the host reporting this usage. If multiple agents are reporting from the same host, the version from the first agent seen in a given hour will be used. | |
infrastructureBillingInstanceSize gibibyte (Gib) | Size of the host, for CU billing purposes. Calculated as: number of processors multiplied by memory in gibibytes (GiB). | |
infrastructureCloudDerivedMemoryBytes bytes (B) | Bytes of RAM available to the host, as reported by the cloud provider, used to calculate infrastructureBillingInstanceSize. | |
infrastructureCloudDerivedProcessorCount count | Number of logical CPU cores available to the host, as reported by the cloud provider, used to calculate infrastructureBillingInstanceSize. | |
infrastructureComputeUnitRule | Describes the algorithm used to calculate the host size for CU usage. Values include: agent_collected_calculated_data: Use the host size data collected by the agent from the OS environment. cloud_provider_data: Use the host size data from the cloud provider. missing_data: Some host size data was missing. This could be due to an agent and operating system combination for which CPU and memory sizes are not supported. This will result in the default host size (16) being applied. | |
infrastructureComputeUnits | Number of compute units (CUs) recorded for the given host. CUs are calculated as: infrastructureHoursUsed multiplied by infrastructureBillingInstanceSize. For more about compute unit calculation, see Compute unit pricing. | |
infrastructureHoursUsed | Number of hours for which usage was recorded for the given host. When a host is connected to New Relic for any amount of time within a given hour, that hour is counted toward usage. | |
insightsEventNamespace | The type of event. For example: Transaction, MobileCrash, or SystemSample. Event namespaces are associated with a specific data retention period. | |
insightsIncludedEventCount count | Count of all events of the given insightsEventNamespace stored for the retention period included with a paid non-Insights product subscription. For example, APM Pro subscriptions include several days' retention of Transaction events. This attribute represents a count of events existing in storage as measured on a given day, and not a count of the events added to storage during a given day. Summing this attribute over a period of more than a day may not give you what you expect; for example, it will not yield the total volume of events written to storage in that period. | |
insightsIncludedRetentionInHours | Number of hours for which events of the given insightsEventNamespace are stored but are not counted toward your paid Insights Pro subscription. For more information about the data reported in nrDailyUsage, see Insights usage: Attributes and queries. | |
insightsNrProduct | New Relic product (Insights, APM, Browser, Mobile, etc.) that corresponds to the given insightsEventNamespace. | |
insightsTotalEventCount count | Count of all events stored for the given insightsEventNamespace as of the given day. Sum of insightsIncludedEventCount and the number of events stored beyond the retention period included with a paid non-Insights product subscription. This attribute represents a count of events existing in storage as measured on a given day, and not a count of the events added to storage during a given day. Summing this attribute over a period of more than a day may not give you what you expect; for example, it will not yield the total volume of events written to storage in that period. | |
insightsTotalRetentionInHours | Number of hours for which events of the given insightsEventNamespace are stored. | |
instanceSizeCapped | This is True if the calculated host size was greater than 16 and therefore capped. | |
isPrimaryApp | Boolean. true means the application is the primary app. false means the app is one of several apps that an agent reports data for. Deprecated. For more on multiple app names in APM and Browser, see Use multiple names for an app. The sum of events where this attribute is true will give an accurate total of page views when you are using the multiple app names feature. Counting events where this attribute is false will result in over-counting of usage. | |
masterAccountId ID | The ID of the parent account (also known as the master account) that's either responsible for stored events or that is the parent of the consuming account. When a parent account is the consuming account, | |
masterAccountName | Name of the parent account (also known as the master account) that's either responsible for stored events, or that is the parent of the consuming account. When a parent account is the consuming account, | |
missingCpuData | This is True if the APM agent reports no CPU count. | |
missingRamData | This is True if the APM agent reports no memory count. | |
mobileAppId ID | ID uniquely identifying the application reporting this usage, as it appears in the Mobile product. | |
mobileAppName | Name of the application reporting this usage, as it appears in the Mobile product. | |
mobileUniqueUsersPerMonth count | Number of unique users (device IDs) counted during the current calendar month to date for a Mobile app. | |
partnershipId ID | Partner ID of the New Relic customer partnership associated with the account responsible for the stored events. This attribute is only present if the consuming account is associated with a New Relic customer partnership. | |
partnershipName | Name of the New Relic customer partnership associated with the account responsible for the stored events. This attribute is only present if the consuming account is associated with a customer partnership. | |
productLine | The New Relic product the usage data is from. Use this attribute to identify / filter for product specific usage data. | |
subAccountId ID | ID of the child account (also known as the sub-account) responsible for the stored event. When present, This attribute is only present if the consuming account is a child account (not a parent account). | |
subAccountName | Name of the child account (also known as the sub-account) responsible for stored events. When present, this is the same as This attribute is only present if the consuming account is a child account (not a parent account). | |
syntheticsFailedCheckCount count | Number of failed checks that ran on the given day for the given synthetic monitor and location. Failed checks count toward subscription usage for synthetics. Only checks with syntheticsType not equal to SIMPLE count toward billable subscription usage. | |
syntheticsLocation | Location the check ran in. | |
syntheticsLocationLabel | Human-readable label for the location of the check. For more information about the data reported in nrDailyUsage, see Insights usage: Attributes and queries. | |
syntheticsMonitorId ID | Unique ID of the monitor. | |
syntheticsMonitorName | Name of the monitor. | |
syntheticsSuccessCheckCount count | Number of successful checks that ran on the given day for the given synthetic monitor and location. Only checks with syntheticsType not equal to SIMPLE count toward billable subscription usage. | |
syntheticsType | The type of Synthetics monitor. Possible values: SIMPLE, BROWSER, SCRIPT_BROWSER, SCRIPT_API. For more information, see Types of synthetic monitors. | |
syntheticsTypeLabel | Human-readable label for syntheticsType. Possible values: Ping, Simple Browser, Scripted Browser, Scripted API. | |
timestamp | UNIX timestamp (seconds since epoch) of the day and time when event generation was initiated. | |
usageType | For APM, this value can be either Application or Host, depending on the type of entity this event records usage for (other New Relic products will have different values for usageType). Events with both values are recorded so that usage data can be analyzed in several ways. For Application: the event represents usage for a single unique application instance for that day. For Host: the event represents usage for a single unique host for that day. Only Host entities are used to calculate billable usage. Application entities are useful for comparing usage between applications, but are not used for billing or contract purposes. |
The NrIntegrationError event captures error messages related to data ingest, such as exceeding limits or malformed data.
Attribute name | Definition | Data types |
---|---|---|
apiKeyPrefix | The first six characters of the API key used for the request that generated an error. | |
category | The category of the error (for example, | |
httpResponseCode enum | The HTTP response code associated with the transaction. Some agents use | |
httpResponseCode enum | The HTTP response code associated with the transaction. Some agents use | |
message | Contents of the error message. | |
name | The error's name (for example, | |
newRelicFeature | The name of the feature experiencing errors. For example: | |
requestId ID | The UUID returned by the API for the request that generated an error. | |
response.status enum | The HTTP response code associated with the transaction. | |
timestamp | Unix timestamp indicating the time it started. |
This event tracks your New Relic usage (data and billable users) and estimated cost across an entire calendar month. It generates aggregate values from the NrConsumption
event.
Attribute name | Definition | Data types |
---|---|---|
BytesIngested bytes (B) | The number of bytes ingested by the consuming account via either an agent, a custom event API, or another integration. | |
CoreUsers count | The number of core users. | |
CoreUsersBillable count | The number of billable core users. | |
FullPlatformUsersBillable count | The number of billable full platform users. | |
FullPlatformUsersFree count | The number of full platform users within the free limit (if available). | |
FullUsers count | The number of full platform users. | |
FullUsersBillable count | The number of billable full platform users. | |
FullUsersFree count | The number of full platform users within the free limit (if available). | |
GigabytesIngested gibibyte (Gib) | The amount of data ingested by the consuming account. | |
GigabytesIngestedBillable count | The number of gigabytes ingested by the consuming account that exceed the free limit and are considered billable. | |
billableConsumption count | The amount of billable consumption in the unit of pricing. For example, for Data Platform, billableConsumption is equal to GigabytesIngestedBillable. For Full Stack Observability, billableConsumption is equal to FullUsersBillable. Estimated cost is equal to billableConsumption multiplied by the unit price of the metric. | |
consumption count | The amount of consumption converted to the unit of pricing. For example, for Data Platform, consumption is equal to GigabytesIngested. For Full Stack Observability, consumption is equal to FullUsers. This attribute is useful if you want to see consumption faceted by productLine or other attribute. | |
estimatedCost count | A cost estimate based on your usage. This is an estimate, not an actual invoiced amount. To be deprecated in May of 2022. | |
freeConsumption count | The amount of consumption that is within the consuming account's free limit. | |
freeLimit count | The total amount of consumption included in the free limit. After consumption exceeds this amount billableConsumption begins to accumulate. | |
masterAccountId ID | The ID of the parent account (also known as the master account) that's either responsible for stored events or that is the parent of the consuming account. When a parent account is the consuming account, | |
metric enum | Consolidates multiple categories of usage into a single metric. Helpful when faceting by productLine. | |
month | The month and year during which the consumption occurred. Example: August 2020. | |
monthTimestamp | The timestamp of the month during which the consumption occurred. | |
productLine | The New Relic product the usage data is from. Use this attribute to identify / filter for product specific usage data. | |
timestamp | UNIX timestamp (seconds since epoch) of the day and time when event generation was initiated. |
This event records usage every hour and is used to see usage reported per product.
Attribute name | Definition | Data types |
---|---|---|
aggregationFunction | Used in conjunction with “type” to determine whether usage is aggregated based on sum (sum all usage per hour) or max (take max usage per hour). | |
appId ID | The unique numeric identifier assigned by New Relic for the service/app that generated the transaction. | |
consumingAccountId ID | ID of the New Relic account that's directly responsible for the stored data, as determined from the license key. | |
consumingAccountName | Name of the New Relic account directly responsible for the stored data, as determined from the license key. | |
durationMs milliseconds (ms) | The aggregation window (for example, 1 hour or 1 day). | |
masterAccountId ID | The ID of the parent account (also known as the master account) that's either responsible for stored events or that is the parent of the consuming account. When a parent account is the consuming account, | |
masterAccountName | Name of the parent account (also known as the master account) that's either responsible for stored events, or that is the parent of the consuming account. When a parent account is the consuming account, | |
metric enum | Consolidates multiple categories of usage into a single metric. Helpful when faceting by productLine. | |
processedTime | When the event was processed by the usage pipeline. | |
productLine | The New Relic product the usage data is from. Use this attribute to identify / filter for product specific usage data. | |
subAccountId ID | ID of the child account (also known as the sub-account) responsible for the stored event. When present, This attribute is only present if the consuming account is a child account (not a parent account). | |
subAccountName | Name of the child account (also known as the sub-account) responsible for stored events. When present, this is the same as This attribute is only present if the consuming account is a child account (not a parent account). | |
timestamp | UNIX timestamp (seconds since epoch) of the day and time when event generation was initiated. | |
type | Used with “aggregationFunction” to determine whether aggregation is based on count (sum all usage per hour) or gauge (take max usage per hour). | |
usage | The amount of usage. The unit varies, depending on the metric field. |
The Browser PageAction event is the result of the addPageAction API call that sends a user-defined name and optional attributes, along with several default attributes, such as app and geographic data. It is used to capture any event that is not already tracked automatically by the Browser agent, such as clicking a Subscribe button or accessing a tutorial.
Attribute name | Definition | Data types |
---|---|---|
actionName | The name of the PageAction, as defined by you in your code. | |
appId ID | The ID of your application, as recorded by New Relic. | |
appName | The name of the application that handled the request as shown in browser monitoring. | |
asn | Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user. | |
asnLatitude | 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. | |
asnLongitude | 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. | |
asnOrganization | The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution. | |
browserHeight | The height of the end user's browser window at the time when the PageAction occurred. | |
browserWidth | The width of the end user's browser window at the time when the PageAction occurred. | |
city | The city in which the event occurred, such as Portland or Seattle. | |
countryCode | The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2. | |
currentUrl | The URL on which the PageAction is occurring. This URL may be different from the Page URL. | |
deviceType | The type of device that loaded the page: either mobile, tablet, or desktop. | |
name | The name of the invoked web transaction. For example: Controller/customers/show. | |
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. | |
referrerUrl | The URL of the page that loaded before the PageAction occurred. | |
regionCode | The specific administrative division within a country where the In the United States, regions correspond to state codes ; for example, | |
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. | |
timeSinceLoad seconds (s) | The time (in seconds) elapsed from when the page was requested to when the PageAction was created. | |
timestamp | The time (date, hour, minute, second) at which the interaction occurred. | |
userAgentName | The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request. | |
userAgentOS | 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. | |
userAgentVersion | The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request. |
PageView events occur when a user navigates to (loads) a new page. It tracks geographic and timing data for each browser page load.
Attribute name | Definition | Data types |
---|---|---|
appId ID | The ID of your application, as recorded by New Relic. | |
appName | The name of the application that handled the request as shown in browser monitoring. | |
asn | Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user. | |
asnLatitude | 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. | |
asnLongitude | 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. | |
asnOrganization | The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution. | |
backendDuration seconds (s) | The back-end response time in seconds. Includes app server (webAppDuration) and network time (networkDuration), as well as queue time if available. Representative of Time to First Byte. Derived from the Navigation Timing API as responseStart minus navigationStart. | |
browserTransactionName | The transaction name (page view group) as it appears in New Relic Browser. | |
city | The city in which the event occurred, such as Portland or Seattle. | |
connectionSetupDuration seconds (s) | The time to establish a connection with the server in seconds (inclusive of secureHandshakeDuration). Derived from the Navigation Timing API as connectEnd minus connectStart. | |
countryCode | The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2. | |
deviceType | The type of device that loaded the page: mobile, tablet, or desktop. | |
dnsLookupDuration seconds (s) | The time to resolve the DNS record for the top-level resource (in seconds). Derived from the Navigation Timing API as domainLookupEnd minus domainLookupStart. | |
domProcessingDuration seconds (s) | The time it takes to parse the HTML into a DOM and retrieve or execute synchronous scripts. Often includes time for scripts and static assets to be retrieved. Derived from the Navigation Timing API as domContentLoadedEventEnd minus responseStart. | |
domain | The domain portion of the request URL. | |
duration seconds (s) | The browser response time in seconds. Derived from the Navigation Timing API as loadEventEnd minus navigationStart. | |
firstContentfulPaint |
Google's User-centric Performance Metrics contains detailed information about its See Compatibility and requirements for New Relic Browser for additional information about | |
firstPaint |
Google's User-centric Performance Metrics contains detailed information about its See Compatibility and requirements for New Relic Browser for additional information about | |
name | The name of the invoked web transaction. For example: Controller/customers/show. | |
networkDuration seconds (s) | The total time spent in redirects as well as in requesting and receiving HTML (in seconds). If webAppDuration (server side timing information) is not available, time on the server will be included in this duration. | |
pageRenderingDuration seconds (s) | The page rendering phase is the time between DOM completion ( | |
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. | |
queueDuration seconds (s) | The total time the request waits for a service to initiate (in seconds). | |
regionCode | The specific administrative division within a country where the In the United States, regions correspond to state codes ; for example, | |
secureHandshakeDuration seconds (s) | A subset of connectionSetupDuration, the time to establish a TLS connection with the server. Derived from the Navigation Timing API as connectEnd minus secureConnectionStart (in seconds). | |
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. | |
timestamp | The time (date, hour, minute, second) at which the interaction occurred. | |
userAgentName | The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request. | |
userAgentOS | 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. | |
userAgentVersion | The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request. | |
webAppDuration seconds (s) | The total server-side response time for the top-level resource of the This does not include network time to transmit the request or receive the response, or server-side request queueing time. The webAppDuration is measured by the APM agent and must be injected into the browser monitoring script before the request is fully finished. Its end point is slightly before the end point used to calculate the duration attribute on Transactions, so webAppDuration will be slightly less than the duration attribute on Transactions in practice. |
This event represents individual timing events during a page view lifecycle (for example, time when the largest element is displayed, or the first user interaction with the page). See the PageViewTiming docs for a list of reported events.
Attribute name | Definition | Data types |
---|---|---|
appId ID | The ID of your application, as recorded by New Relic. | |
appName | The name of the application that handled the request as shown in browser monitoring. | |
asn | Autonomous System Number: a unique number identifying a group of IP networks that serves the content to the end user. | |
asnLatitude | 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. | |
asnLongitude | 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. | |
asnOrganization | The organization that owns the Autonomous System Number. Often an ISP, sometimes a private company or institution. | |
browserTransactionName | The transaction name (page view group) as it appears in New Relic Browser. | |
city | The city in which the event occurred, such as Portland or Seattle. | |
countryCode | The country from which the browser initiated the page load. For a list of country codes, see ISO 3166-1 alpha-2. | |
cumulativeLayoutShift | An important, user-centric metric for measuring visual stability because it helps quantify how often users experience unexpected layout shifts—a low CLS helps ensure that the page is delightful. Cumulative Layout Shift is one of three metrics identified by Google as the Core Web Vitals. CLS scores up to 0.1 are considered "Good", between 0.1-0.25 considered "Needs Improvement", and above 0.25 considered "Poor." | |
deviceType | The type of device that loaded the page: either mobile, tablet, or desktop. | |
domain | The domain portion of the request URL. | |
elementId | This is the ID, if specified, of the | |
elementSize | This is the reported size of the | |
elementTagName | This is the tag name of the | |
elementUrl | This is the request url of the | |
firstContentfulPaint seconds (s) | The first contentful paint timing rounded down to the nearest second. This attribute only occurs when the value of the timingName attribute is firstContentfulPaint. The first contentful paint timing rounded down to the nearest second. This attribute only occurs when the value of the Supported browser versions:
For more information, see the | |
firstInputDelay milliseconds (ms) | The first input delay measures the duration from the first interaction to the moment the web application responds, rounded down to the nearest millisecond. First Input Delay and First Interaction are recorded on the same event, when the timingName value is firstInteraction. The first input delay measures the duration from the first interaction to the moment the web application responds. The duration is rounded down to the nearest millisecond. This attribute only occurs when the value of the The The
For more information, see the | |
firstInteraction seconds (s) | A timing that captures when customers begin to engage with a website, such as clicking a button or typing in a box, rounded down to the nearest second. Occurs when the timingName value is firstInteraction. First interaction is a timing that captures when customers begin to engage with a website, such as clicking a button or typing in a box. The first interaction timing is rounded down to the nearest second. This attribute only occurs when the value of the Events are handled at the document level with
For additional details, you can use The
For more information, see the | |
firstPaint seconds (s) | The first paint timing rounded down to the nearest second. Occurs when the timingName value is firstPaint. The first paint timing rounded down to the nearest second. Occurs when the Supported browser versions:
For more information, see the | |
interactionType | The event type of the first interaction that occurs on the web app: pointerdown, mousedown, click, keydown, or touchstart. The event type of the first interaction that occurs on the web application. The type can be one of the following:
This attribute only occurs when the value of the | |
largestContentfulPaint seconds (s) | This metric, available with agent version 1163, largestContentfulPaint, reports the render time of the largest content element visible in the viewport. This metric, available with agent version 1163, | |
networkDownlink | This is the estimated effective bandwidth in megabits per second at the time the PageViewTiming event was captured. This value will only be reported with the The value is captured from the NetworkInformation API. For a full browser compatibility table and description see the MDN web docs. | |
networkEffectiveType | This is the effective connection type ('slow-2g', '2g', '3g' or '4g'), of the current network connection at the time the PageViewTiming event was captured. This value will only be reported with the The value is captured from the NetworkInformation API. For a full browser compatibility table and description see MDN Web Docs: NetworkInformation.effectiveType. See also Effective connection type for a description of each type. | |
networkRtt | This is the estimated round trip time, in milliseconds, of the current network connection at the time the PageViewTiming event was captured. This value will only be reported with the The value is captured from the NetworkInformation API. For a full browser compatibility table and description see the MDN web docs. | |
networkType | This is the type of the current network connection at the time the PageViewTiming event was captured. This value will only be reported with the The value is captured from the NetworkInformation API. For a full browser compatibility table and description see the MDN web docs. | |
pageHide | Sent when the browser hides the current page in the process of loading a different page from the session's history (for example, a browser back button click). | |
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. | |
regionCode | The specific administrative division within a country where the In the United States, regions correspond to state codes ; for example, | |
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. | |
timestamp | The time (date, hour, minute, second) at which the interaction occurred. | |
timingName | The name of the timing event: firstPaint, firstContentfulPaint, or firstInteraction. The name of the timing event: | |
userAgentName | The browser’s name, such as Chrome and Firefox, obtained from the User-Agent header of an HTTP request. | |
userAgentOS | 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. | |
userAgentVersion | The browser’s reported software version, which is obtained from the User-Agent header of an HTTP request. | |
windowLoad seconds (s) | The windowLoad event is fired when the whole has loaded. See supporting documentation and browser compatibility for the Window Load event MDN docs. | |
windowUnload seconds (s) | The windowUnload event is fired when a document or child resource is being unloaded. The |
ProcessSample event gathers detailed resource usage information from programs running on a single system. New Relic samples the data every 20 seconds for every active process and packages it into a ProcessSample event, which then sends the raw data to New Relic's collectors every 60 seconds.
Attribute name | Definition | Data types |
---|---|---|
agentName | The name of the agent (Infrastructure). | |
agentVersion | The version of the New Relic Infrastructure agent. | |
commandLine | The full command line for the current process. This command line will be sanitized by default to strip options and arguments from the command line to prevent accidental leakage of private information. | |
commandName | The command name of the process corresponds, in most cases, to the base name of the command line's path to the form of the process. | |
contained | Returns true if the process is running inside a container; false if not inside a container. | |
containerId ID | For processes running inside a Docker container, the unique Docker container ID for this process. | |
containerImage ID | For processes running inside a Docker container, the Docker image ID for the image this process is based on. | |
containerImageName | For processes running inside a Docker container, the Docker image name for this process. | |
containerLabel_KEY | For processes running inside a Docker container, the Docker label associated with this process. Docker labels consist of key/value pairs. The key is captured in the attribute name as For example, to query a SELECT cpuPercent FROM ProcessSample WHERE containerLabel_owner = 'Test User' | |
containerName | For processes running inside a Docker container, the Docker container name for this process | |
cpuPercent percentage (%) | The combined CPU usage (of all types, including system, user, I/O, depending on platform), by CPU core, for this process at a single point in time. For systems with more than one CPU core, this percentage may be greater than 100%. | |
cpuSystemPercent percentage (%) | The system-time CPU usage component used by the process. | |
cpuUserPercent percentage (%) | The user-time CPU usage component used by the process. | |
criticalViolationCount count | The number of times that alert conditions violated critical thresholds, causing critical violations and opening incidents. If this attribute does not exist on the sample, it has zero violations. | |
entityID ID | New Relic's unique ID number for the entity that is reporting data. This is used by New Relic to distinguish between customers and their entities. | |
fullHostname | The fully qualified (DNS) hostname. | |
hostname | The short version of the entity's name. | |
ioReadBytesPerSecond rate | The number of bytes read from all storage devices per second. | |
ioReadCountPerSecond rate | The number of disk read operations by the process per second. | |
ioTotalReadBytes count | Counts bytes that the process caused to be fetched from the storage layer. Count of bytes that the process caused to be fetched from the storage layer. Done at submit_bio() level, so it's accurate for block-backed filesystems. Read from the | |
ioTotalReadCount count | Cumulative number of disk read operations by this process. | |
ioTotalWriteBytes count | Counts bytes that the process caused to be sent to the storage layer. Counts bytes that the process caused to be sent to the storage layer. This is done at page-dirtying time. Read from the | |
ioTotalWriteCount count | Cumulative number of disk write operations by this process. | |
ioWriteBytesPerSecond rate | The number of bytes written by this process per second. | |
ioWriteCountPerSecond rate | The number of disk write operations by the process per second. | |
kernelVersion | The Linux kernel version, in string format. This attribute is available only for systems on a Linux platform. | |
linuxDistribution | The name of the Linux distribution the server is using. This attribute is available only for systems on a Linux platform. | |
memoryResidentSizeBytes bytes (B) | The total amount of physical memory in use for the process, in bytes. | |
memoryVirtualSizeBytes bytes (B) | The total amount of virtual memory reserved for the process, in bytes. | |
netIoTotalReceivedPackets count | Cumulative number of net packets received by this process. | |
netIoTotalSentPackets count | Cumulative number of net packets transmitted by this process. | |
operatingSystem | The operating system on which the agent is installed. | |
parentProcessId ID | The unique parent identification number (PID) for this process. | |
processDisplayName | The display name (friendly name) of the process. This is derived from the command name by default, but if it can be determined that the process is associated with a service from the inventory system, New Relic uses the service name. Another source of the name may be a parsed component of the command line, if it is a known command line format (for example, Java app). | |
processId ID | The unique process identification number for this process. | |
state | The current process status as a platform-specific state name. For example: running or sleeping. | |
threadCount count | The number of threads active for this process. | |
timestamp | The time (date, hour, minute, second) at which the interaction occurred. | |
userId ID | The user identifier under which the process is running. | |
userName | The username of the owner of the process; for example, root or ubuntu. | |
warningViolationCount count | The number of times that alert conditions violated warning thresholds, causing warning violations. | |
windowsFamily | The Windows family indicates whether the OS is a server or desktop targeted system. This attribute is available only for systems on a Windows platform. | |
windowsPlatform | The full product name of the installed version of Windows. This attribute is available only for systems on a Windows platform. | |
windowsVersion | The combined Windows version and build-number string of the OS. This attribute is available only for systems on a Windows platform. |
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 name | Definition | Data 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 | |
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, | |
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: | |
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.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 | |
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 | 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 | |
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. |