Dicionário de dados da New Relic

Este dicionário de dados define alguns dos nossos dados relatados por padrão armazenados no NRDB e que podem ser consultados usando NRQL. Isso inclui eventos como Transaction, MobileRequest e BrowserInteraction, além dos nossos tipos de dados de métrica, log e span. Essas definições também estão disponíveis por meio da nossa interface do criador de consulta, passando o cursor do mouse sobre tipos de dados aplicáveis e nomes de atributos.

Este dicionário não contém:

  • Dados de nossas integrações de infraestrutura (para tal, consulte a documentação da integração específica)
  • Dados personalizados
  • Atributos detalhados específicos da integração para dados de métricas

AjaxRequest

Data source:

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 nameDefinitionData types
actionText

The text of the HTML element that was clicked when a browser interaction started. Added to BrowserInteraction and any AjaxRequest, JavaScriptError and BrowserTiming events that occurred during that 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.

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 targetGroupedUrl or the custom name set via the API.

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 BrowserInteraction events so you can view the interactions that occurred surrounding a specific event. For example, you can see the browser interactions that occurred prior to a JavaScript error.

groupedPageURL

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

groupedRequestUrl

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

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

hostname

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

httpMethod
enum

The HTTP method of the AJAX request. Example: POST.

httpResponseCode
enum

The HTTP response code. Example: 200.

jsDuration
seconds (s)

The total duration, in seconds, spent on JavaScript execution. This attribute is only seen in AjaxRequest data that is tied to BrowserInteraction. This attribute doesn't exist for initial page load events.

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.

regionCode

The specific administrative division within a country where the PageView 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 numerical codes.

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

requestBodySize
bytes (B)

The payload size of the request body, in bytes.

requestUrl

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

responseBodySize
bytes (B)

The payload size of the response body, in bytes.

session

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

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

timeSinceBrowserInteractionStart
seconds (s)

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

timestamp

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

timeToLastCallbackEnd
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 AjaxRequest data that is tied to BrowserInteraction.

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 XMLHttpRequest load events.

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 AjaxRequest data that is tied to BrowserInteraction.

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.

AwsLambdaInvocation

Data source:

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 nameDefinitionData 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 browser.spans, or api.traces).

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 Content-Length HTTP request header.

request.headers.contentType

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

request.headers.host

The name from the HTTP host request header.

request.headers.referer

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

request.headers.userAgent

The contents of the User-Agent HTTP header.

request.method

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

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: Transaction, Span.

AwsLambdaInvocationError

Data source:

This event is reported by New Relic monitoring for AWS Lambda. It's generated when an error occurs during a Lambda function invocation.

Attribute nameDefinitionData 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 browser.spans, or api.traces).

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 Content-Length HTTP request header.

request.headers.contentType

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

request.headers.host

The name from the HTTP host request header.

request.headers.referer

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

request.headers.userAgent

The contents of the User-Agent HTTP header.

request.method

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

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: Transaction, Span.

BrowserInteraction

Data source:

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 nameDefinitionData types
actionText

The text of the HTML element that was clicked when a browser interaction started. Added to BrowserInteraction and any AjaxRequest, JavaScriptError and BrowserTiming events that occurred during that interaction.

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 targetGroupedUrl or the custom name set via the API.

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 BrowserInteraction events so you can view the interactions that occurred surrounding a specific event. For example, you can see the browser interactions that occurred prior to a JavaScript error.

firstContentfulPaint

firstContentfulPaint is the point when the browser renders the first bit of content from the DOM, which may be text, an image, SVG, or a <canvas> element.

Google's User-centric Performance Metrics contains detailed information about its Paint Timing API and firstContentfulPaint.

See Compatibility and requirements for New Relic Browser for additional information about firstContentfulPaint browser compatibility.

firstPaint

firstPaint marks the point when the browser renders anything that is visually different from what was on the screen prior to navigation. This includes non-default background paint and the enclosing box of an iframe.

Google's User-centric Performance Metrics contains detailed information about its Paint Timing API and firstPaint.

See Compatibility and requirements for New Relic Browser for additional information about firstPaint browser compatibility.

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

jsDuration
seconds (s)

The total duration, in seconds, spent on JavaScript execution. This attribute is only seen in AjaxRequest data that is tied to BrowserInteraction. This attribute doesn't exist for initial page load events.

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 setCurrentRouteName before the start of the interaction.

previousURL

The ungrouped URL in the browser at the start of the interaction.

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 PageView 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 numerical codes.

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

session

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

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

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 setCurrentRouteName before the end of the interaction.

targetUrl

The ungrouped URL in the browser at the end of the interaction.

timestamp

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

timeToConnectEnd
seconds (s)

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

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 connectStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 domainLookupEnd, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 domainLookupStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 domComplete, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 domContentLoadedEventEnd, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 domContentLoadedEventStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 domInteractive, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 domLoading, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 fetchStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

timeToLoadEventEnd
seconds (s)

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

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 loadEventStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 redirectEnd, as defined by the Navigation Timing API. This attribute exists only for initial page load events, not route changes.

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 redirectStart, as defined by the Navigation Timing API. This attribute exists only for initial page load events, not route changes.

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 requestStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 responseEnd, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 responseStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 secureConnectionStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 unloadEventEnd, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

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 unloadEventStart, as defined by the Navigation Timing API. This attribute exists for initial page load events, not route changes.

For more information about the Navigation Timing API, see Instrumentation for Browser monitoring.

trigger

The cause of the route change or page load. The default values are click, submit, popstate, or initial page load. For a custom event created with the API, the default value for trigger will be api. This value can also be set via the API.

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 PageView or BrowserInteraction event (in seconds) as measured by the APM agent.

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.

BrowserTiming

Data source:

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 nameDefinitionData types
actionText

The text of the HTML element that was clicked when a browser interaction started. Added to BrowserInteraction and any AjaxRequest, JavaScriptError and BrowserTiming events that occurred during that 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.

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 targetGroupedUrl or the custom name set via the API.

browserTimingName

The name of the event. This is taken from the name argument of createTracer.

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 BrowserInteraction events so you can view the interactions that occurred surrounding a specific event. For example, you can see the browser interactions that occurred prior to a JavaScript error.

groupedPageURL

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

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

jsDuration
seconds (s)

The total duration, in seconds, spent on JavaScript execution. This attribute is only seen in AjaxRequest data that is tied to BrowserInteraction. This attribute doesn't exist for initial page load events.

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 PageView 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 numerical codes.

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

session

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

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

timeSinceBrowserInteractionStart
seconds (s)

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

timestamp

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

timeToLastCallbackEnd
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 AjaxRequest data that is tied to BrowserInteraction.

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 AjaxRequest data that is tied to BrowserInteraction.

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 BrowserTiming event.

tracedCallbackDuration
seconds (s)

The duration in seconds of the traced callback. This attribute is unique to the BrowserTiming 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.

ContainerSample

Data source:

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 nameDefinitionData types
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 by CPU core. For containers with more than one CPU core, this percentage may be greater than 100%.

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 memorySwapUsageBytes over memorySwapLimitBytes, if the limit exists.

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 memoryUsageBytes percentage over memorySizeLimitBytes, if the limit exists.

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.

networksTxBytes
count

Total number of bytes transmitted.

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.

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.

StorageDataAvailableBytes
bytes (B)

Data space available in the Storage Driver. Only available while using Docker's devicemapper storage driver that is deprecated.

StorageDataTotalBytes
bytes (B)

Total Data space in the Storage Driver. Only available while using Docker's devicemapper storage driver that is deprecated.

StorageDataUsagePercent
percentage (%)

Percent of Data space used in the Storage Driver. Only available while using Docker's devicemapper storage driver that is deprecated.

StorageDataUsedBytes
bytes (B)

Data space used by the Storage Driver. Only available while using Docker's devicemapper storage driver that is deprecated.

StorageMetadataAvailableBytes
bytes (B)

Metadata space available in the Storage Driver. Only available while using Docker's devicemapper storage driver that is deprecated.

StorageMetadataTotalBytes
bytes (B)

Total Metadata space in the Storage Driver. Only available while using Docker's devicemapper storage driver that is deprecated.

StorageMetadataUsagePercent
percentage (%)

Percent of Metadata space used in the Storage Driver. Only available while using Docker's devicemapper storage driver that is deprecated.

StorageMetadataUsedBytes
bytes (B)

Metadata space used by the Storage Driver. Only available while using Docker's devicemapper storage driver that is deprecated.

warningViolationCount
count

The number of times that alert conditions violated warning thresholds, causing warning violations.

Deployment

Data source:

Deployment events occur for changes you decide to follow using the change tracking feature.

Attribute nameDefinitionData types
changelog

A URL for the changelog, or if it is not linkable, a list of changes.

commit

The commit identifier (for example, the Git commit SHA).

deepLink

A URL pointing back to the system generating the deployment. This field can hold any URL.

deploymentId
ID

Unique identifier we generate when a marker is created. Alphanumeric IDs are from our newer NerdGraph change tracking feature. Numeric IDs are from our legacy REST API-based feature.

deploymentType

The type of the deployment (for example, 'BASIC', 'BLUE-GREEN', 'CANARY', 'OTHER', 'ROLLING', or 'SHADOW').

description

A description of the deployment.

entity.guid

The globally unique identifier for the New Relic entity that this marker applies to.

entity.name

The friendly name for the New Relic entity this marker applies to.

groupId

String value that can be used to correlate multiple entities across a single change event.

timestamp
milliseconds (ms)

The start time of the deployment (in milliseconds since Unix epoch).

user

Username of the deployer or bot that created this deployment.

version

The version of the deployment (for example, v1.1).

DistributedTraceSummary

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. This event only appears in the parent account.

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

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 nameDefinitionData types
category

A New Relic category used to organize events in the UI. For example: automation, notification, and service.

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.

changeType

A simple classification of the type of change made to the entity: added, modified, or removed.

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 DatastoreSample event is used by several integrations, including the AWS DynamoDB integration and the AWS RDS integration. In these cases, the provider attribute value represents the source of that attribute. This will usually be the service that data comes from or, for integrations that use several provider values, a certain sub-category of data from that service.

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 DatastoreSample event reported by the AWS RDS integration:

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.

JavaScriptError

Data source:

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 nameDefinitionData types
actionText

The text of the HTML element that was clicked when a browser interaction started. Added to BrowserInteraction and any AjaxRequest, JavaScriptError and BrowserTiming events that occurred during that interaction.

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.

error.group.name

An optional attribute set using the Browser agent API that can be used to inform how errors should be grouped in Errors Inbox. For more info, see our docs.

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.

firstOccurrenceTimestamp

The timestamp of when the first JS error occurs on the page.

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

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 PageView 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 numerical codes.

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

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 is tracked in browser storage using the Web Storage API, subject to each browser's implementation and handling. The session will automatically reset or refresh after a set period of inactivity or a pre-defined duration limit, whichever is less.

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

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.

K8sApiServerSample

Data source:

This event contains Kubernetes API server data.

Attribute nameDefinitionData types
apiserverCurrentInflightRequestsMutating

Maximal number of currently used inflight request limit of the apiserver per request kind Mutating in the last second (requires k8s v1.23+).

apiserverCurrentInflightRequestsReadOnly

Maximal number of currently used inflight request limit of the apiserver per request ReadOnly kind in the last second (requires k8s v1.23+).

apiserverRequestDelta_verb_VERB_code_CODE
count

This is a delta counter for each request verb (e.g. GET, WATCH, LIST, CREATE) and their response codes. The delta is between the current and the last polled value.

apiserverRequestRate_verb_VERB_code_CODE

Rate of apiserver requests per minute, broken out for each verb and HTTP response code.

apiserverStorageObjects_resource_RESOURCE-KIND

Number of stored objects at the time of last check, split by kind (requires k8s 1.23+; replaces etcdObjectCounts).

etcdObjectCounts_resource_RESOURCE_KIND

Number of stored objects at the time of last check, split by kind (alpha; deprecated in Kubernetes 1.22; replaced by apiserverStorageObjects).

goGoroutines

Number of goroutines that currently exist.

goThreads

Number of OS threads created.

processCpuSecondsDelta
seconds (s)

Difference of the user and system CPU time spent, in seconds.

processResidentMemoryBytes
bytes (B)

Resident memory size, in bytes.

restClientRequestsDelta_code_CODE_method_METHOD

Difference of the number of HTTP requests, partitioned by method and code.

restClientRequestsRate_code_CODE_method_METHOD

Rate of the number of HTTP requests, partitioned by method and code.

K8sClusterSample

Data source:

This event contains Kubernetes cluster data.

Attribute nameDefinitionData types
clusterK8sVersion

Kubernetes version that the cluster is running on.

clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

K8sContainerSample

Data source:

This event contains Kubernetes container data.

Attribute nameDefinitionData types
clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

containerCpuCfsPeriodsDelta

Delta change of elapsed enforcement period intervals.

containerCpuCfsPeriodsTotal
count

Total number of elapsed enforcement period intervals.

containerCpuCfsThrottledPeriodsDelta

Delta change of throttled period intervals.

containerCpuCfsThrottledPeriodsTotal

Total number of throttled period intervals.

containerCpuCfsThrottledSecondsDelta
seconds (s)

Delta change of duration the container has been throttled, in seconds.

containerCpuCfsThrottledSecondsTotal
seconds (s)

Total time duration the container has been throttled, in seconds.

containerID
ID

Unique ID associated with the container. If you are running Docker, this is the Docker container id.

containerImage

Name of the image that the container is running.

containerImageID
ID

Unique ID associated with the image that the container is running.

containerMemoryMappedFileBytes
bytes (B)

Total size of memory mapped files used by this container, in bytes.

containerName

Name associated with the container.

containerOOMEventsDelta

Number of "out of memory" events observed for the container (requires k8s v1.24+).

cpuCoresUtilization

Percentage of CPU cores actually used by the container with respect to the CPU limit specified. This percentage is based on this calculation: (cpuUsedCores / cpuLimitCores) * 100.

cpuLimitCores

Integer representing limit CPU cores defined for the container in the pod specification.

cpuRequestedCores

Requested CPU cores defined for the container in the pod specification.

cpuUsedCores

CPU cores actually used by the container.

daemonsetName

Name of the DaemonSet the container is associated with.

deploymentName

Name of the deployment to be used as an identifier.

isReady

Boolean. Whether or not the container's readiness check succeeded.

jobName

Name of the Job the container is associated with.

label.LABEL_NAME

Labels associated with your container, so you can filter and query for specific containers. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

memoryLimitBytes
bytes (B)

Integer representing limit bytes of memory defined for the container in the pod specification.

memoryRequestedBytes
bytes (B)

Integer. Requested bytes of memory defined for the container in the pod specification.

memoryUsedBytes
bytes (B)

Integer. Bytes of memory actually used by the container.

memoryUtilization
percentage (%)

Percentage of memory actually used by the container with respect to the memory limit specified.

memoryWorkingSetBytes
bytes (B)

Integer. Bytes of memory in the working set.

memoryWorkingSetUtilization

Percentage of working set memory actually used by the container with respect to the memory limit specified.

namespaceName

Name of the namespace that the container belongs to.

nodeIP

Host IP address the container is running on.

nodeName
count

Host name that the pod is running on.

podName

Name of the pod that the container is in, to be used as an identifier.

reason

Provides a reason why the container is in the current status.

replicasetName

Name of the ReplicaSet the container is associated with.

requestedCpuCoresUtilization
percentage (%)

Percentage of CPU cores actually used by the container with respect to the CPU request specified.

requestedMemoryUtilization
percentage (%)

Percentage of memory actually used by the container with respect to the memory request specified.

requestedMemoryWorkingSetUtilization

Percentage of working set memory actually used by the container with respect to the memory request specified.

restartCount
count

Number of times the container has been restarted.

restartCountDelta
count

Delta change of number of times the container has been restarted.

statefulsetName

Name of the StatefulSet the container is associated with.

status

Current status of the container. Value can be Running, Terminated, or Unknown.

K8sControllerManagerSample

Data source:

This event contains Kubernetes controller manager data.

Attribute nameDefinitionData types
goGoroutines

Number of goroutines that currently exist.

goThreads

Number of OS threads created.

leaderElectionMasterStatus

Gauge of if the reporting system is master of the relevant lease, 0 indicates backup, 1 indicates master.

nodeCollectorEvictionsDelta

Delta change of node evictions that happened since current instance of NodeController started (requires k8s v1.24+).

processCpuSecondsDelta
seconds (s)

Difference of the user and system CPU time spent in seconds.

processResidentMemoryBytes
bytes (B)

Resident memory size, in bytes.

workqueueAddsDelta_name_WORK_QUEUE_NAME

Difference of the total number of adds handled by workqueue.

workqueueDepth_name_WORK_QUEUE_NAME

Current depth of workqueue.

workqueueRetriesDelta_name_WORK-QUEUE-NAME

Difference of the total number of retries handled by workqueue.

K8sCronjobSample

Data source:

This event contains Kubernetes CronJob data.

Attribute nameDefinitionData types
concurrencyPolicy

Whether or not to allow the jobs created by this CronJob to run concurrently.

createdAt

Timestamp of when the CronJob was created.

cronjobName

The name of the CronJob.

isActive

Whether the CronJob has currently running jobs.

isSuspended

Whether the CronJob is currently suspended.

label.LABEL_NAME

Labels associated with your CronJob so you can filter and query for specific CronJobs. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

lastScheduledTime

The last time the CronJob successfully scheduled a job.

metadataResourceVersion

The resource version representing a specific version of the Cronjob.

namespaceName

Name of the namespace that the CronJob belongs to.

nextScheduledTime

Next time the Cronjob should be scheduled. The time after lastScheduleTime, or after the Cronjob's creation time if it's never been scheduled. Use this to determine if the job is delayed.

schedule

The schedule which the CronJob uses to run jobs.

specStartingDeadlineSeconds
seconds (s)

The deadline in seconds for starting the job if it misses scheduled time for any reason.

K8sDaemonsetSample

Data source:

This event contains Kubernetes DaemonSet data.

Attribute nameDefinitionData types
clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

createdAt

Timestamp of when the DaemonSet was created.

daemonsetName

Name associated with the DaemonSet.

label.LABEL_NAME

Labels associated with your DaemonSet, so you can filter and query for specific DaemonSet. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

metadataGeneration

Sequence number representing a specific generation of the desired state.

namespaceName

Name of the namespace that the DaemonSet belongs to.

podsAvailable

The number of nodes that should be running the daemon pod and have one or more of the daemon pod running and available.

podsDesired

The number of nodes that should be running the daemon pod.

podsMisscheduled

The number of nodes running a daemon pod but are not supposed to.

podsMissing

Total number of replicas that are currently missing (number of desired replicas, podsDesired, minus the number of ready replicas, podsReady).

podsReady

The number of nodes that should be running the daemon pod and have one or more of the daemon pod running and ready.

podsScheduled

The number of nodes running at least one daemon pod and are supposed to.

podsUnavailable

The number of nodes that should be running the daemon pod and have none of the daemon pod running and available.

podsUpdatedScheduled

The total number of nodes that are running updated daemon pod.

K8sDeploymentSample

Data source:

This event contains Kubernetes deployment data.

Attribute nameDefinitionData types
clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

createdAt

Timestamp of when the deployment was created.

deploymentName

Name of the deployment to be used as an identifier.

label.LABEL_NAME

Labels associated with your deployment, so you can filter and query for specific deployments. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

namespaceName

Name of the namespace that the deployment belongs to.

podsAvailable

Number of replicas that are currently available.

podsDesired

Number of replicas that you defined in the deployment.

podsMissing

Total number of replicas that are missing (number of desired replicas, podsDesired, minus the total number of replicas, podsTotal).

podsTotal

Total number of replicas that are currently running.

podsUnavailable

Number of replicas that are currently unavailable.

podsUpdated

Number of replicas that have been updated to achieve the desired state of the deployment.

K8sEndpointSample

Data source:

This event contains Kubernetes endpoint data.

Attribute nameDefinitionData types
addressAvailable
count

Number of addresses available in endpoint.

addressNotReady
count

Number of addresses not ready in endpoint.

clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

createdAt

Timestamp of when the endpoint was created.

endpointName

Name associated with the endpoint.

label.LABEL_NAME

Labels associated with your endpoint, so you can filter and query for specific endpoints. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

namespaceName

Name of the namespace that the endpoint belongs to.

K8sEtcdSample

Data source:

This event contains Kubernetes etcd data.

Attribute nameDefinitionData types
etcdMvccDbTotalSizeInBytes
bytes (B)

Total size of the underlying database physically allocated, in bytes.

etcdNetworkClientGrpcReceivedBytesRate

Rate of the total number of bytes received from gRPC clients.

etcdNetworkClientGrpcSentBytesRate

Rate of the total number of bytes sent to gRPC clients.

etcdServerHasLeader

Whether or not a leader exists. 1 is existence, 0 is not.

etcdServerLeaderChangesSeenDelta

Difference of the number of leader changes seen.

etcdServerProposalsAppliedDelta

Difference of the total number of consensus proposals applied.

etcdServerProposalsAppliedRate

Rate of the total number of consensus proposals applied.

etcdServerProposalsCommittedDelta

Difference of the total number of consensus proposals committed.

etcdServerProposalsCommittedRate

Rate of the total number of consensus proposals committed.

etcdServerProposalsFailedDelta

Difference of the total number of failed proposals seen.

etcdServerProposalsFailedRate

Rate of the total number of failed proposals seen.

etcdServerProposalsPending
count

The current number of pending proposals to commit.

goGoroutines

Number of goroutines that currently exist.

goThreads

Number of OS threads created.

processCpuSecondsDelta

Difference of the user and system CPU time spent in seconds.

processFdsUtilization

Percentage open file descriptors with respect to the maximum number that can be opened.

processMaxFds

Maximum number of open file descriptors.

processOpenFds
count

Number of open file descriptors.

processResidentMemoryBytes
bytes (B)

Resident memory size, in bytes.

K8sHpaSample

Data source:

This event contains Kubernetes horizontal pod autoscaler data.

Attribute nameDefinitionData types
clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

currentReplicas
count

Current number of replicas of pods managed by this autoscaler.

desiredReplicas
count

Desired number of replicas of pods managed by this autoscaler.

isAble

Boolean representing whether or not the autoscaler is able to fetch and update scales, as well as whether or not any backoff-related conditions would prevent scaling.

isActive

Boolean representing whether or not the autoscaler is enabled (if it's able to calculate the desired scales).

isLimited

Boolean representing whether or not the autoscaler is capped, either up or down, by the maximum or minimum replicas configured.

label.LABEL_NAME

Labels associated with your HPA, so you can filter and query for specific autoscaler. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

labels
count

Number of Kubernetes labels converted to Prometheus labels.

maxReplicas
count

Upper limit for the number of pods that can be set by the autoscaler; cannot be smaller than minReplicas.

metadataGeneration

The generation observed by the HorizontalPodAutoscaler controller.

minReplicas
count

Lower limit for the number of pods that can be set by the autoscaler, 1 by default.

targetMetric

The metric specifications used by this autoscaler when calculating the desired replica count.

K8sJobSample

Data source:

This event contains Kubernetes Job data.

Attribute nameDefinitionData types
activePods

The number of actively running Job pods.

completedAt

Timestamp of when the Job was completed.

createdAt

Timestamp of when the Job was created.

failed

Whether the job has failed its execution.

failedPods

The number of pods which reached Phase Failed.

failedPodsReason

The reason a pod reached Phase Failed.

isComplete

Whether the job has completed its execution.

jobName

The name of the Job.

label.LABEL_NAME

Labels associated with your Job, so you can filter and query for specific Jobs. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

namespaceName

Name of the namespace that the Job belongs to.

ownerIsController

Information about the Job's owner.

ownerKind

The type of Kubernetes workload that created the Job (e.g. CronJob).

ownerName

The name of the Kubernetes workload that created the Job.

specActiveDeadlineSeconds
seconds (s)

The duration in seconds relative to the startTime that the Job may be active before the system tries to terminate it.

specCompletions

The desired number of successfully finished pods the Job should be run with.

specParallelism

The maximum desired number of pods the Job should run at any given time.

startedAt

Timestamp of when the Job was acknowledged by the Job Manager.

succeededPods

The number of pods which reached Phase Succeeded.

K8sNamespaceSample

Data source:

This event contains Kubernetes namespace data.

Attribute nameDefinitionData types
clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

createdAt

Timestamp of the namespace when it was created.

label.LABEL_NAME

Labels associated with your namespace, so you can filter and query for specific namespaces. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

namespaceName

Name of the namespace to be used as an identifier.

nrFiltered

Indicates whether the namespace is being filtered. The value can be true or false.

status

Current status of the namespace. The value can be Active or Terminated.

K8sNodeSample

Data source:

This event contains Kubernetes node data.

Attribute nameDefinitionData types
allocatableCpuCores
count

Node allocatable CPU cores.

allocatableCpuCoresUtilization

Percentage of CPU cores actually used with respect to the CPU cores allocatable.

allocatableEphemeralStorageBytes
bytes (B)

Node allocatable ephemeral-storage bytes.

allocatableMemoryBytes
bytes (B)

Node allocatable memory bytes.

allocatableMemoryUtilization

Percentage of bytes of memory in the working set with respect to the node allocatable memory.

allocatablePods

Node allocatable pods.

capacityCpuCores
count

Node CPU capacity.

capacityEphemeralStorageBytes
bytes (B)

Node ephemeral-storage capacity.

capacityMemoryBytes
bytes (B)

Node memory capacity (in bytes).

capacityPods
count

Pod capacity of the node.

clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

condition.CONDITION_NAME=CONDITION_VALUE

Status of the current observed node condition. The reported conditions can vary depending on your Kubernetes flavor and installed operators.

Examples of common conditions are: Ready, DiskPressure, MemoryPressure, PIDPressure and NetworkUnavailable. Condition values can be 1 (true), 0 (false), or -1 (unknown).

cpuRequestedCores
count

Total amount of CPU cores requested from all containers on a node.

This metric includes CPU cores requested for containers that are no longer running. To see CPU cores requested from only running containers, filter for status = 'Running', or refer to the metric cpuRequestedCores from the K8sContainerSample data type.

cpuUsedCoreMilliseconds
milliseconds (ms)

Node CPU usage measured in core milliseconds.

cpuUsedCores
count

Node CPU usage measured in cores.

fsAvailableBytes
bytes (B)

Bytes available in the node filesystem.

fsCapacityBytes
bytes (B)

Total capacity of the node filesystem in bytes.

fsCapacityUtilization
percentage (%)

Percentage of used bytes in the node filesystem with respect to the capacity.

fsInodes

Total number of inodes in the node filesystem.

fsInodesFree

Free inodes in the node filesystem.

fsInodesUsed

Used inodes in the node filesystem.

fsUsedBytes
bytes (B)

Used bytes in the node filesystem.

label.LABEL_NAME

Labels associated with your node, so you can filter and query for specific nodes. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

memoryAvailableBytes
bytes (B)

Bytes of memory available in the node.

memoryMajorPageFaultsPerSecond

Number of major page faults per second in the node.

memoryPageFaults
count

Number of page faults in the node.

memoryRequestedBytes
bytes (B)

Total amount of requested memory.

memoryRssBytes
bytes (B)

Bytes of rss memory.

memoryUsedBytes
bytes (B)

Bytes of memory used.

memoryWorkingSetBytes
bytes (B)

Bytes of memory in the working set.

net.errorCountPerSecond
count

Number of errors per second while receiving/transmitting over the network.

net.rxBytesPerSecond
bytes (B)

Number of bytes per second received over the network.

net.txBytesPerSecond
bytes (B)

Number of bytes per second transmitted over the network.

nodeName
count

Host name that the pod is running on.

runtimeAvailableBytes
count

Bytes available to the container runtime filesystem.

runtimeCapacityBytes
count

Total capacity assigned to the container runtime filesystem in bytes.

runtimeInodes
count

Total number of inodes in the container runtime filesystem.

runtimeInodesFree
count

Free inodes in the container runtime filesystem.

runtimeInodesUsed
count

Used inodes in the container runtime filesystem.

runtimeUsedBytes
count

Used bytes in the container runtime filesystem.

unschedulable
count

Status of node schedulability of new pods. Its value can be 0 (false) or 1 (true).

K8sPodSample

Data source:

This event contains Kubernetes pod data.

Attribute nameDefinitionData types
clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

createdAt

Timestamp of when the pod was created in epoch seconds.

createdBy

Name of the Kubernetes object that created the pod, for example, newrelic-infra.

createdKind

Kind of Kubernetes object that created the pod, for example, DaemonSet.

daemonsetName

Name of the DaemonSet the Pod is associated with.

deploymentName

Name of the deployment to be used as an identifier.

isReady

Boolean representing whether or not the pod is ready to serve requests.

isScheduled

Boolean representing whether or not the pod has been scheduled to run on a node.

jobName

Name of the Job the Pod is associated with.

label.LABEL_NAME

Labels associated with your pod, so you can filter and query for specific pods. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

message

Details related to the last pod status change.

namespaceName

Name of the namespace that the pod belongs to.

net.errorCountPerSecond
second (s)

Number of errors per second while receiving/transmitting over the network.

net.errorsPerSecond
seconds (s)

Number of errors per second.

net.rxBytesPerSecond

Number of bytes per second received over the network.

net.txBytesPerSecond

Number of bytes per second transmitted over the network.

nodeIP

Host IP address that the pod is running on.

nodeName
count

Host name that the pod is running on.

podIP

IP address of the pod. If it doesn't have an IP, it'll be empty.

podName

Name of the pod to be used as an identifier.

reason

Reason why the pod is in the current status.

replicasetName

Name of the ReplicaSet the Pod is associated with.

startTime

Timestamp of when the pod started running in epoch seconds.

statefulsetName

Name of the StatefulSet the Pod is associated with.

status

Current status of the pod. Value can be Pending, Running, Succeeded, Failed, Unknown.

K8sReplicasetSample

Data source:

This event contains Kubernetes ReplicaSet data.

Attribute nameDefinitionData types
clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

createdAt

Timestamp of when the ReplicaSet was created.

deploymentName

Name of the deployment to be used as an identifier.

namespaceName

Name of the namespace that the ReplicaSet belongs to.

observedGeneration

Integer representing generation observed by the ReplicaSet.

podsDesired

Number of replicas that you defined in the deployment.

podsFullyLabeled

Number of pods that have labels that match the ReplicaSet pod template labels.

podsMissing

Total number of replicas that are currently missing (number of desired replicas, podsDesired, minus the number of ready replicas, podsReady).

podsReady

Number of replicas that are ready for this ReplicaSet.

podsTotal

Total number of replicas that are currently running.

replicasetName

Name of the ReplicaSet to be used as an identifier.

K8sSchedulerSample

Data source:

This event contains Kubernetes scheduler data.

Attribute nameDefinitionData types
goGoroutines

Number of goroutines that currently exist.

goThreads

Number of OS threads created.

httpRequestDurationMicroseconds_handler_HANDLER_count
count

The number of observed HTTP requests events.

httpRequestDurationMicroseconds_handler_HANDLER_quantile_QUANTILE

The HTTP request latencies in microseconds, per quantile.

httpRequestDurationMicroseconds_handler_HANDLER_sum

The sum of the HTTP request latencies, in microseconds.

leaderElectionMasterStatus

Gauge of if the reporting system is master of the relevant lease, 0 indicates backup, 1 indicates master.

processCpuSecondsDelta
seconds (s)

Difference of the user and system CPU time spent in seconds.

processFdsUtilization

Percentage open file descriptors with respect to the maximum number that can be opened.

processMaxFds

Maximum number of open file descriptors.

processOpenFds

Number of open file descriptors.

processResidentMemoryBytes
bytes (B)

Resident memory size, in bytes.

restClientRequestsDelta_code_CODE_host_HOST_method_METHOD

Difference of the number of HTTP requests, partitioned by status code, method, and host.

restClientRequestsRate_code_CODE_host_HOST_method_METHOD

Rate of the number of HTTP requests, partitioned by status code, method, and host.

schedulerPendingPodsActive
count

Number of pending pods in the active queue (requires k8s v1.23+).

schedulerPendingPodsBackoff
count

Number of pending pods in the backoff queue (requires k8s v1.23+).

schedulerPendingPodsUnschedulable
count

Number of pending pods in the unschedulable queue (requires k8s v1.23+).

schedulerPodPreemptionVictims
count

Number of selected preemption victims.

schedulerPreemptionAttemptsDelta

Difference of the total preemption attempts in the cluster until now.

schedulerScheduleAttemptsDelta_result_RESULT

Difference of the number of attempts to schedule pods, by the result. unschedulable means a pod could not be scheduled, while error means an internal scheduler problem.

schedulerScheduleAttemptsRate_result_RESULT

Rate of the number of attempts to schedule pods, by the result. unschedulable means a pod could not be scheduled, while error means an internal scheduler problem.

schedulerSchedulingDurationSeconds_operation_OPERATION_count

The number of observed events of schedulings split by sub-parts of the scheduling operation.

schedulerSchedulingDurationSeconds_operation_OPERATION_quantile_QUANTILE

Scheduling latency in seconds split by sub-parts of the scheduling operation.

schedulerSchedulingDurationSeconds_operation_OPERATION_sum

The sum of scheduling latency in seconds split by sub-parts of the scheduling operation.

K8sServiceSample

Data source:

This event contains Kubernetes service data.

Attribute nameDefinitionData types
clusterIP

The internal cluster IP, if Spectype is ClusterIP.

clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

createdAt

Timestamp of when the service was created.

externalName

The external name value, if Spectype is ExternalName.

label.LABEL_NAME

Labels associated with your service, so you can filter and query for specific service. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

loadBalancerIP

The IP of the external load balancer, if Spectype is LoadBalancer.

namespaceName

Name of the namespace that the service belongs to.

selector.LABEL_NAME

The label selector that this service targets.

serviceName

Name associated with the service.

specType

Type of the service.

K8sStatefulsetSample

Data source:

This event contains Kubernetes StatefulSet data.

Attribute nameDefinitionData types
clusterName

Name that you assigned to the cluster when you installed the Kubernetes integration.

createdAt

Timestamp of when the StatefulSet was created.

currentRevision

Indicates the version of the StatefulSet used to generate pods in the sequence. Value range: between 0 and podsCurrent.

label.LABEL_NAME

Labels associated with your StatefulSet, so you can filter and query for specific StatefulSet. By default they are not collected, so you need to enable them in the KSM chart by configuring the metricLabelsAllowlist.

metadataGeneration

Sequence number representing a specific generation of the desired state for the StatefulSet.

namespaceName

Name of the namespace that the StatefulSet belongs to.

observedGeneration

The generation observed by the StatefulSet controller.

podsCurrent

The number of current replicas per StatefulSet.

podsDesired

Number of desired pods for a StatefulSet.

podsMissing

Total number of replicas that are currently missing (number of desired replicas, podsDesired, minus the number of ready replicas, podsReady).

podsReady

The number of ready replicas per StatefulSet.

podsTotal

The number of replicas per StatefulSet.

podsUpdated

The number of updated replicas per StatefulSet.

statefulsetName

Name associated with the StatefulSet.

updateRevision

Indicates the version of the StatefulSet used to generate pods in the sequence. Value range: between podsDesired-podsUpdated and podsDesired.

K8sVolumeSample

Data source:

This event contains Kubernetes volume data.

Attribute nameDefinitionData types
clusterName

Cluster where the volume is configured.

fsAvailableBytes
bytes (B)

Capacity available of the volume, in bytes.

fsCapacityBytes
bytes (B)

Capacity of the volume, in bytes.

fsInodes

Total inodes of the volume.

fsInodesFree

inodes available in the volume.

fsInodesUsed

inodes used in the volume.

fsUsedBytes
bytes (B)

Usage of the volume, in bytes.

fsUsedPercent
percentage (%)

Usage of the volume in percentage.

namespaceName

Namespace where the volume is configured.

persistent

If this is a persistent volume, this value is set to true.

podName

The pod that the volume is attached to. The Kubernetes monitoring integration lists volumes that are attached to a pod.

pvcName

Name that you assigned to the Persistent Volume Claim at creation.

pvcNamespace

Namespace where the Persistent Volume Claim is configured.

volumeName

Name that you assigned to the volume at creation.

LlmChatCompletionMessage

Data source:

An event that corresponds to each message (sent and received) from a chat completion call. These messages include those created by the user, assistant, and system.

Attribute nameDefinitionData types
completion_id
ID

The ID of the LlmChatCompletionSummary event that a message event is connected to.

content

A string value that describes the contents of a message.

id
ID

An agent-generated identifier for the event.

ingest_source

The name of the APM agent that collected the data.

is_response
Boolean

Boolean set to True if a message is the result of a chat completion. The attribute is omitted if False, like in cases where the message is the result of an input.

response.model

The model that returned the response. May or may not match the value for request.model.

role

A string value that describes the source of the message. This varies depending on the LLM vendor, but could have values that represent prompt engineering, the user, or a response from the LLM itself.

sequence

An index associated with each message, including the prompt and responses. Begins at 0.

span_id
ID

The identifier for the span.

token_count

The integer value returned from llm_token_count_callback. Omitted if no value is returned.

trace_id
ID

The identifier for the trace.

vendor

The name of the vendor that provided the model.

LlmChatCompletionSummary

Data source:

An event that captures high level data about the creation of a chat completion for request and response messages.

Attribute nameDefinitionData types
duration
milliseconds (ms)

Total time for the chat or embedding call to complete.

error
Boolean

If the agent detects an error during the creation call, it sets the value to True. Omitted if the agent doesn't detect an error.

id
ID

An agent-generated identifier for the event.

ingest_source

The name of the APM agent that collected the data.

request.max_tokens

An integer value for the maximum number of tokens that can be generated during a chat completion. The value is typically set from a hardcoded configuration.

request.model

The model that processed the request. May or may not match the value for response.model.

request.temperature

An integer value that represents how random or deterministic an output response should be. The threshold for random and deterministic values can vary with vendor and model, but more deterministic responses will be closer to 0. If the number is higher, then it is more random.

request_id
ID

The ID associated with the request, which is typically available in the response headers.

response.choices.finish_reason

A string value containing the reason a model stopped generating tokens.

response.model

The model that returned the response. May or may not match the value for request.model.

response.number_of_messages

An integer value for the number of messages in a completed chat exchange. This includes messages from the system, user, and AI assistant

response.organization

The unique identifier for your organization that can be used in API requests.

span_id
ID

The identifier for the span.

trace_id
ID

The identifier for the trace.

vendor

The name of the vendor that provided the model.

LlmEmbedding

Data source:

An event that captures data specific to the creation of an embedding.

Attribute nameDefinitionData types
duration
milliseconds (ms)

Total time for the chat or embedding call to complete.

error
Boolean

If the agent detects an error during the creation call, it sets the value to True. Omitted if the agent doesn't detect an error.

id
ID

An agent-generated identifier for the event.

ingest_source

The name of the APM agent that collected the data.

input

The text string passed to the embedding creation call.

request.model

The model that processed the request. May or may not match the value for response.model.

request_id
ID

The ID associated with the request, which is typically available in the response headers.

response.model

The model that returned the response. May or may not match the value for request.model.

response.organization

The unique identifier for your organization that can be used in API requests.

span_id
ID

The identifier for the span.

token_count

The integer value returned from llm_token_count_callback. Omitted if no value is returned.

trace_id
ID

The identifier for the trace.

vendor

The name of the vendor that provided the model.

Metric

Data source:

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

Mobile

Data source:

A Mobile event is created when a crash occurs, when an interaction ends, or when the harvest cycle is triggered. The harvest cycle typically occurs every 600 seconds (10 minutes), but this can vary depending on the app's activity. Events are created during the session and reported when event harvest cycle has ended. Recommendation: Upgrade to the most recent mobile monitoring agent version to take full advantage of the new event types.

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

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

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

interactionDuration

For interaction category events only.

An iOS interaction starts automatically when a view controller's viewDidLoad or viewDidAppear method is called, which will terminate any active interactions. An Android interaction starts when an activity or fragment's onCreate method is called.

A "healthy" interaction trace ends itself after .5 seconds of inactivity, where inactivity is defined by a lack of instrumented method calls. If there is never .5 seconds of inactivity, the trace will terminate after one minute.

An interaction does not end when the view/activity is done loading. As long as there is activity from an instrumented class/method, the interaction will stay open. This means async tasks or dispatch_async calls that run after the view/activity ends will increase the duration of the interaction.

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.

MobileApplicationExit

Data source:

A MobileApplicationExit event is generated when an app terminates, either due to a crash or other reasons such as low memory, ANRs, etc. Currently, this event is reported only for Android mobile applications. It leverages Android’s ApplicationExitInfo API to monitor and report on the different reasons for your app’s termination.

This event provides valuable insights into the circumstances surrounding the app's termination and includes attributes such as reason, description, etc. For example, to understand the different reasons for your app exit, you would look at the reason attribute. For all ANRs, the reason would be 6, for crashes it would be 4, and so on, as described in the Android documentation. For a human readable description for your app exit, try looking at the description attribute.

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

appState

The perceptible state of the app (foreground versus background) based on interpretation of the returned importance field.

appVersion

The version number of the monitored app. For example: 2.2.9.

appVersionId
ID

An internal identifier New Relic uses to order lists of multiple instances of app versions (appVersion).

architecture

The processor architecture of the device. For example: armv7 or arm64.

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.

asnOwner

The telecom owner of the ASN.

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.

description

The human-readable description of the process's death, given by Android runtime. This could be null.

Note: Android provides no guarantees that the format is stable across devices or Android releases.

device

The specific type of the device: iPhone 8, iPad Pro, etc. Duplicate of deviceType.

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.

deviceType

The specific type of device: iPhone 8, iPad Pro, etc. Duplicate of device.

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

exitTimestamp

This is the recorded process time of death, in milliseconds as returned by System.currentTimeMillis().

importance

The relative priority of the process at termination.

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

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.

processName

The name of the process.

reason

The underlying reason for the application exit (numeric).

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.

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 the configured event harvest cycle, 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, but they do have timeSinceLoad attributes. Events recorded near the end of the session may include the duration.

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

MobileCrash

Data source:

The MobileCrash event is created when an app crashes. MobileCrash includes attributes such as crash line number, class, and crash message.

Attribute nameDefinitionData 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 internal identifier New Relic uses to order lists of multiple instances of app versions (appVersion).

architecture

The processor architecture of the device. For example: armv7 or arm64.

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.

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.

crashLocation

The crashing class, file name, method, and line number if the crash is symbolicated. If not symbolicated, a memory address within the application binary (iOS), or obfuscated class, method, and line number (Android). Platform specific algorithms are applied to the stack to determine the crashing frame.

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

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

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

diskAvailable
bytes (B)

The root filesystem and the external filesystem space available, in bytes, separated by a comma. For example: 50491392,6523789312 or 0,1495339008.

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.

memoryUsage
megabytes (MB)

The total amount of memory, in MB, used by the application. Updated every 60 seconds.

memUsageMb
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 newRelicAgentVersion.

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

The UTC timestamp for when the event was received by New Relic. (This is different from timestamp, which is when the MobileSession event began that crashed.)

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

MobileHandledException

Data source:

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 nameDefinitionData 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 internal identifier New Relic uses to order lists of multiple instances of app versions (appVersion).

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.

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

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

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

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 iOS 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 iOS agent only. The library name where the exception was generated.

libraryStartAddr

For iOS 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 newRelicAgentVersion.

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

Epoch timestamp of the handled exception. This exception timestamp represents the time New Relic created the event, if it's older than two days or some other unexpected time.

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

MobileRequest

Data source:

A MobileRequest event is created when an HTTP request successfully completes, resulting in a response code below 400.

Attribute nameDefinitionData 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 internal identifier New Relic uses to order lists of multiple instances of app versions (appVersion).

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.

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

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

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

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

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

MobileRequestError

Data source:

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 nameDefinitionData 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 internal identifier New Relic uses to order lists of multiple instances of app versions (appVersion).

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.

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

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

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

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

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

MobileSession

Data source:

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 nameDefinitionData 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 internal identifier New Relic uses to order lists of multiple instances of app versions (appVersion).

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.

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

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

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

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

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 the configured event harvest cycle, 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, but they do have timeSinceLoad attributes. Events recorded near the end of the session may include the duration.

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

NetworkSample

Data source:

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.

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

NrAiIncident

Data source:

An NrAiIncident is created when violation of an alerts condition generates a violation event, which passes important information downstream.

Attribute nameDefinitionData 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:

  • CONDITION_DELETED: condition deleted.
  • CONDITION_DISABLED condition disabled.
  • CONDITION_MODIFIED condition edited
  • EVALUATOR: natural close because the metric has ceased to breach the threshold.
  • EXPIRED: incident closed due to TTL.
  • INCIDENT_WORKFLOW_INTEGRATION: a third party closed the issue or incident through an API call.
  • LABEL_BINDINGS_CHANGED : label was removed from the target, causing it to no longer be covered by the condition. This only applies to APM/Mobile/Browser/Infrastructure conditions.
  • LOSS_OF_SIGNAL: signal was lost, and incident was closed based on loss of signal settings.
  • MAINTENANCE: New Relic was performing maintenance and we closed the incident as part of it.
  • POLICY_DELETED: policy was deleted.
  • TARGET_REMOVED: the target was removed from the condition.
  • USER: closed manually by a user.
closeTime

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 expirationDuration must be specified.

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 Violation Description field.

NRQL or Infrastructure conditions only.

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 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:

  • threshold (the condition threshold was breached)
  • expiration (the entity's signal was lost)
  • anomaly (an automatic anomaly was generated)
event

The record's event type.

Available values: open and close.

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 incident 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 WHERE clause.

Available for muting rules.

openTime

The timestamp when the violation was opened.

operator

The violation threshold's operator, such as =, <, or >.

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 incident's priority: low, medium, high, or critical. Default: high.

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. tags. is the prefix and * is the metadata/tag name. For details on how to use this, see the documentation for muting rules or alerts condition descriptions.

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 for at least or at least once in occurrence values are being used in the active condition's threshold. Available values: all or any.

timestamp

The event's wall clock time using an epoch timestamp.

title

The incident's title.

type

The incident's type.

Available values: Incident.

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.

NrAiIncidentExternal

Data source:

An NrAiIncidentExternal event is created when a custom incident event is received via the incident event API.

Attribute nameDefinitionData types
aggregationTag.*

The aggregationTag attribute has a unique suffix added to it. Any events with aggregationTag and the same suffix value are grouped together in an incident. A resolve event resets this aggregation grouping.

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

priority

The incident's priority: low, medium, high, or critical. Default: high.

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 trigger, resolve, or acknowledge. Required.

tag.*

Arbitrary key-value metadata, or tags, associated with the violation. tag is the prefix and * is the metadata/tag name.

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.

NrAiIssue

Data source:

An NrAiIssue is created when a threshold of an alert condition generates an incident event, which passes important information downstream.

Attribute nameDefinitionData types
accountIds
ID

ID of the account where incidents occurred.

activateTime

The timestamp when the issue was activated.

closeCause

What caused the incident to close. Available values:

  • CLOSED_BY_ISSUE: Issue in a created state that closed naturally before activation.

  • CLOSED_BY_USER: Issue in a created state that the user closes before activation.

  • CLOSE_INACTIVE: Issue reached 5000 (max) incidents.

  • closeTtl: Issue closed due to issue TTL (issue settings).

  • CONDITION_DELETED: Condition deleted.

  • CONDITION_DISABLED: Condition disabled.

  • CONDITION_MODIFIED: Condition edited.

  • EVALUATOR: Natural close because the metric has ceased to breach the threshold.

  • EXPIRED: Incident closed due to TTL.

  • INCIDENT_CLOSED: The issue contains only anomalies and is closed when the last anomaly is closed.

  • LOSS_OF_SIGNAL: Signal was lost, and incident was closed based on loss of signal settings.

  • POLICY_DELETED: Policy was deleted.

  • TARGET_REMOVED: The target was removed from the condition.

  • thirdPartyIntegration: A third party closed the issue through an API call.

  • USER: Closed manually by a user on the legacy version.

  • userAction: Closed manually by a user.

closeTime

The timestamp when the incident was closed.

correlated

Indicates whether the issue was correlated (true/false).

correlatedCandidate

Indicates whether the issue was a correlated candidate (true/false).

correlationRuleIds
ID

The unique identifier of the correlation rule.

correlationRuleNames

The name of the correlation rule.

createTime

The timestamp when the issue was created.

entitiesCount
count

Number of impacted entities.

entity.names

The name of the targeted entity.

entity.types

The type of the targeted entity.

event

The event type of the record.

incidentCount
count

Number of incidents in the issue.

incidentIds
ID

The unique identifiers of the issue's incidents.

isIdle
ID

Indicates whether the issue is idle (true/false).

issueId
ID

The unique identifier of the issue.

issueLink

Link to the issue page.

lastModifiedTime
millisecond (s)

The timestamp of the last modification.

muted

Shows whether the active condition was muted at the time of the incident event.

parentId
ID

The unique identifier of the parent issue.

priority

The issue's priority: LOW, MEDIUM, HIGH, or CRITICAL. Default: HIGH.

sources

If applicable, the source of the issue.

timestamp

The wall clock time of the event using an epoch timestamp.

title

The incident's title.

NrAiNotification

Data source:

NrAiNotification shows details from every sent notification on your account, including both successful and failed notifications.

Attribute nameDefinitionData types
destinationName

Name of the destination used to send the notification.

destinationType

Destination type, such as Slack, email, or Jira.

notificationId

Internal identifier for the notification. Mostly used for debugging purposes.

notificationResult

If the integration allows us to create or fetch a link for the notification, this will show that link. If not, this will show the response json (for example, with webhook notifications).

operation

Notification operation, for example, Notify, Acknowledge, Close.

payload

For webhook operations, this will show the outgoing payload.

status

Whether the notification was SUCCESS or FAIL.

timestamp

Time the notification was sent.

NrAiSignal

Data source:

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

dataAccountId

The account ID containing the data being evaluated.

earlyEventDropCount
count

The number of data points that arrived too early to be included in the data aggregation window and were dropped from evaluation.

endTimestamp

Moment when this event was created, and the end of the aggregation window.

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

Type of the active entity. Note that NA indicates an infrastructure entity.

error

This captures any errors when evaluating the signal.

event

The type of event captured in this data point.

  • value: A single value was evaluated (most common).
  • expiration: A signal loss is detected.
  • reset: Indicates a detail of the condition was changed, and the signal has been reset.
  • summary: Indicates that data points were dropped for being early and/or late
  • removed: Indicates that a facet was removed from correlation because of a limit or ttl
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.

lateEventDropCount
count

The number of data points that arrived too late to be included in the data aggregation window and were dropped from evaluation.

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.

removalCause

For removal events only. Available values:

  • facet_limit_reached: The number of facets being correlated has reached the limit.
  • facet_ttl_expired: A facet being correlated has not been updated within the defined ttl.
resetCause

For reset events only. Available values:

  • new: It's a new signal coming online.
  • expired: Signal reset due to loss of signal configuration.
  • conditionDisabled: The user disabled the condition in the UI.
  • delayedEvaluation: The condition has a delayed evaluation configured. Therefore, New Relic sends resets through the system to prevent evaluation before the expected time.
  • suppression: Because of an ongoing incident, alerts are suppressed.
  • interrupt: When we detect issues, we internally interrupt our services. Issues are mainly out-of-order data points that can cause false alerts.
  • conditionDeleted: The user has deleted the condition in the UI.
  • conditionModified: The user has modified the condition in a way that requires re-registration on our side.
  • policyDeleted: Deleted the entire policy.
  • user: The user has closed the incident manually in the UI.
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.

slideBySeconds

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

The type of event being reported. Available values:

  • signal: A signal value that was evaluated.
  • info: Updates to a signal that do not correspond to a specific evaluation window.

NrAuditEvent

Data source:

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 nameDefinitionData types
actionIdentifier

Indicates an action that was taken in a New Relic account.

The actionIdentifier attribute describes the action that was taken. Some actionIdentifier values will be prefixed by the targetType.

Some examples of actionIdentifier values:

  • account.update_owner
  • alerts.condition.create
  • alerts.condition.update
  • alerts.condition.delete
  • alerts.condition.unarchive
  • role.create
  • user.add_roles
  • user.add_to_account
  • user.invite_to_account
  • user.remove_from_account
  • user.remove_roles
  • synthetics_monitor.create
  • synthetics_monitor.delete
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.

  • user: For greatest data accuracy, select user, along with actorId and actorEmail.
  • api_key: If used, the actorId and actorEmail are not required
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:

  • MM-DD-YYYY HH:MM:SS
  • SINCE 2018-05-28 11:18:45
  • UNTIL 30 minutes ago
  • SINCE '2018-06-20' UNTIL today

NrConsumption

Data source:

This event records usage every hour, and is the equivalent of "real-time" usage. Use this event to observe usage trends over time. The values in this event are estimates and may not correspond exactly with your invoice. For aggregate views of usage across an entire billing period, use NrMTDConsumption.

Attribute nameDefinitionData types
BytesIngested
bytes (B)

The number of bytes ingested by the consuming account via either an agent, a custom event API, or another integration.

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.

CoreUsers
count

The number of core users.

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.

FullUsers
count

The number of full platform users.

GigabytesIngested
gigabyte (GB)

The amount of data ingested by the consuming account.

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, masterAccountId is the consumingAccountId. This attribute is present even for accounts that don't have a parent account. This is to ensure continued reporting if the account is later made a parent 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, masterAccountName is the same as consumingAccountName. This attribute is present even for accounts that don't have a parent account. This is to ensure continued reporting if the account is later made a parent 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.

NrDailyUsage

Data source:

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 nameDefinitionData 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:

  • 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 older agent that doesn't support reporting CPU and memory sizes, or an agent and OS combination for which CPU and memory sizes are not supported. This will result in the default host size (16) being applied.
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, masterAccountId is the consumingAccountId. This attribute is present even for accounts that don't have a parent account. This is to ensure continued reporting if the account is later made a parent 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, masterAccountName is the same as consumingAccountName. This attribute is present even for accounts that don't have a parent account. This is to ensure continued reporting if the account is later made a parent 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, subAccountId is the same as consumingAccountId.

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

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.

NrIntegrationError

Data source:

The NrIntegrationError event captures error messages related to data ingest, such as exceeding limits or malformed data.

Attribute nameDefinitionData 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, EventApiException for custom events).

http.statusCode
enum

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

httpResponseCode
enum

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

message

Contents of the error message.

name

The error's name (for example, EventValidationException for custom events).

newRelicFeature

The name of the feature experiencing errors. For example: Event API, Metrics, or Distributed tracing.

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.

NrMTDConsumption

Data source:

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

BytesIngested
bytes (B)

The number of bytes ingested by the consuming account via either an agent, a custom event API, or another integration.

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.

CoreUsers
count

The number of core users.

CoreUsersBillable
count

The number of billable core users.

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.

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
gigabyte (GB)

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.

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, masterAccountId is the consumingAccountId. This attribute is present even for accounts that don't have a parent account. This is to ensure continued reporting if the account is later made a parent 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.

NrUsage

Data source:

This event records usage every hour and is used to see usage reported per product.

Attribute nameDefinitionData 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, masterAccountId is the consumingAccountId. This attribute is present even for accounts that don't have a parent account. This is to ensure continued reporting if the account is later made a parent 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, masterAccountName is the same as consumingAccountName. This attribute is present even for accounts that don't have a parent account. This is to ensure continued reporting if the account is later made a parent 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, subAccountId is the same as consumingAccountId.

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

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.

NrdbQuery

Data source:

Each time a query is executed on behalf of a user in your account an NrdbQuery event is published. Events contain the full query string, information about when and where it originated, and how it performed.

Attribute nameDefinitionData types
durationMs
milliseconds (ms)

The total time that it took for the query to execute.

inspectedCount
count

The number of events, if any, that were inspected while executing the query.

productCapability
enum

The New Relic capability where the query originated.

query

The NRQL query string that was executed.

query.eventType

The event type specified in the FROM clause of the query. A query with a FROM clause can return more than one event type.

scannedEvents
count

The count of data points scanned, if any, to return the query result.

source.apiKeyId
ID

The API key used to execute the query for 'query-api' sources.

source.dashboardId
ID

The dashboard ID that executed this query for 'dashboard' sources. This value can be entered into the dashboard search bar to display that dashboard.

source.grafana.dashboardId
ID

The Grafana dashboard where the query originated for 'prometheus-api' sources.

source.grafana.panelId
ID

The panel on the Grafana dashboard where the query originated for 'prometheus-api' sources.

source.name

String description of the feature or tool the query originates from. Available values:

  • apm: Application performance monitoring
  • dashboard: Dashboards displayed on the New Relic platform
  • Distributed tracing: Distributed tracing
  • errors-inbox: Errors inbox
  • infrastructure: Infrastructure monitoring
  • metrics-explorer: Metrics explorer
  • nerdgraph: NerdGraph, our GraphQL API
  • nerdpack: A New Relic application or visualization
  • New Relic user interface: A New Relic curated UI
  • nrql-console: NRQL console
  • prometheus-api: Queries via the Prometheus integration
  • query-api: Insights query API
  • query-builder: Query builder
  • service-levels: Service levels
  • other: Source not specified
source.nerdpackUuid
ID

The unique identifier of the Nerdpack that executed the query, for 'nerdpack' sources.

source.promql.query

The PromQL query string that was translated into the NRQL query that was executed, for 'prometheus-api' sources.

source.url

The URL of the UI page that executed this query.

source.widgetId
ID

The ID of the dashboard widget that executed the query, for 'dashboard' sources.

status
enum

Indicates the successful or unsuccessful execution of the query. Available values:

  • successful: Query executed successfully.
  • error: Query failed to execute due to an error.
  • cancelled: Query execution stopped before fully completed.
  • limited - congestion: Query dropped due to internal New Relic system congestion.
  • limited - inspected count: Query dropped due to your account being over its inspected count resource limits.
  • limited - memory estimation: Query dropped as its estimated memory consumption exceeded system constraints. Reducing the complexity of this query could increase the probability of successful execution.
  • limited: Query dropped, no reason available.
  • timedout: Query timed out before execution completed and did not return results. Try reducing the scope of the query by changing the time window or reducing the number of EventTypes in the FROM clause.
timestamp
milliseconds (ms)

The UNIX timestamp (milliseconds since epoch) of the date and time when the query was executed.

timeWindowMinutes
minutes (min)

The difference in minutes between the SINCE and UNTIL clauses of the query. Often, the longer the time window, the longer the query will run and the more events will be inspected.

user

The email address of the user who executed the query.

PageAction

Data source:

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 nameDefinitionData 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 value at the time of observing the event. This URL may differ from the Page URL if soft navigations have occurred.

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 PageView 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 numerical codes.

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

session

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

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

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

Data source:

PageView events occur when a user navigates to (loads) a new page. It tracks geographic and timing data for each browser page load.

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

domain

The domain portion of the request URL.

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.

duration
seconds (s)

The browser response time in seconds. Derived from the Navigation Timing API as loadEventEnd minus navigationStart.

firstContentfulPaint

firstContentfulPaint is the point when the browser renders the first bit of content from the DOM, which may be text, an image, SVG, or a <canvas> element.

Google's User-centric Performance Metrics contains detailed information about its Paint Timing API and firstContentfulPaint.

See Compatibility and requirements for New Relic Browser for additional information about firstContentfulPaint browser compatibility.

firstPaint

firstPaint marks the point when the browser renders anything that is visually different from what was on the screen prior to navigation. This includes non-default background paint and the enclosing box of an iframe.

Google's User-centric Performance Metrics contains detailed information about its Paint Timing API and firstPaint.

See Compatibility and requirements for New Relic Browser for additional information about firstPaint browser compatibility.

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

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 (domContentLoadedEventEnd) and the window load event (loadEventEnd), in seconds. This phase measures browser-side processing and display of the page content.

pageTraceId

An ID that is generated per hard page load. This ID remains the same across soft navigations but changes on page refreshes and hard navigations.

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 PageView 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 numerical codes.

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

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 is tracked in browser storage using the Web Storage API, subject to each browser's implementation and handling. The session will automatically reset or refresh after a set period of inactivity or a pre-defined duration limit, whichever is less.

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

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 PageView or BrowserInteraction event (in seconds) as measured by the APM agent.

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.

PageViewTiming

Data source:

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

For more information, see the PageViewTiming documentation.

deviceType

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

domain

The domain portion of the request URL.

element

Per the web-vitals v4 library, if specified, this is the element corresponding to the largest contentful paint for the page.

This attribute only occurs when the value of the timingName attribute is largestContentfulPaint.

Please see the web-vitals documentation for current browser support.

elementId

This is the ID, if specified, of the largestContentfulPaint element. This value will only be reported with the LCP metric. This value can be null or empty and is captured from the LargestContentfulPaint.id property.

Please see the web-vitals documentation for current browser support.

elementRenderDelay

Per the web-vitals v4 library, this is the delta between when the LCP resource finishes loading until the LCP element is fully rendered. For more information, please see Optimize LCP.

This attribute only occurs when the value of the timingName attribute is largestContentfulPaint.

Please see the web-vitals documentation for current browser support.

elementSize

This is the reported size of the largestContentfulPaint element. This value will only be reported with the LCP metric and is captured from the LargestContentfulPaint.size property.

elementTagName

This is the tag name of the largestContentfulPaint element. This value will only be reported with the LCP metric and is captured from the LargestContentfulPaint.element.tagName property.

elementUrl

This is the request url of the largestContentfulPaint element, if the element is an image. This value will only be reported with the LCP metric. The value is captured from the LargestContentfulPaint.url property (if present).

Please see the web-vitals documentation for current browser support.

eventTarget

This is the selector string of the element the user first interacted with as part of the frame where the interaction to next paint (INP) interaction occurred. If this value is an empty string, that generally means the element was removed from the DOM after the interaction.

Note: this has been renamed to interactionTarget as per the web-vitals v4 library in browser agent version 1.267 or higher.

Deprecated, please use interactionTarget instead.

eventTime

The time when the user first interacted during the frame where the interaction to next paint (INP) interaction occurred. If more than one interaction occurred within the frame, only the first time is reported.

Note: this has been renamed to interactionTime as per the web-vitals v4 library in browser agent version 1.267 or higher.

Deprecated, please use interactionTime instead.

firstByteToFCP

Per the web-vitals v4 library, this is the delta between time to first byte (TTFB) and the first contentful paint (FCP).

This attribute only occurs when the value of the timingName attribute is firstContentfulPaint.

Please see the web-vitals documentation for current browser support.

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.

For more information, see the PageViewTiming documentation.

firstInteraction
seconds (s)

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 timingName attribute is firstInteraction.

Events are handled at the document level with addEventListener(). Clicking an empty page will cause an interaction to fire. Valid event type values include:

  • pointerdown
  • mousedown
  • click
  • keydown
  • touchstart

Note that this attribute represents the time of the event; to know which event triggered it, use interactionType.

For more information, see the PageViewTiming documentation.

firstPaint
seconds (s)

The first paint timing rounded down to the nearest second. Occurs when the timingName value is firstPaint.

For more information, see the PageViewTiming documentation.

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

inputDelay
milliseconds (ms)

The time from when the user interacted with the page until when the browser was first able to start processing event listeners for that interaction. This time captures the delay before event processing can begin due to the main thread being busy with other work. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint.

Introduced in browser agent version 1.267 as part of web-vitals v4 library. Please see the web-vitals documentation for current browser support.

interactionTarget

This is the selector string of the element the user first interacted with as part of the frame where the interaction to next paint (INP) interaction occurred. If this value is an empty string, that generally means the element was removed from the DOM after the interaction. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint.

Renamed from eventTarget in browser agent version 1.267 or higher as part of web-vitals v4. Please see the web-vitals documentation for current browser support.

interactionTime

The time when the user first interacted during the frame where the interaction to next paint (INP) interaction occurred. If more than one interaction occurred within the frame, only the first time is reported. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint.

Renamed from eventTime in browser agent version 1.267 or higher as part of web-vitals v4 library. Please see the web-vitals documentation for current browser support.

interactionToNextPaint
seconds (s)

A core web vitals metric that assesses responsiveness, or how quickly a web page visually responds to user actions like clicks or taps. A low INP means the page was consistently able to respond quickly to all or nearly all user interactions.

For more information, see the PageViewTiming documentation.

interactionType

The event type of the first interaction that occurs on the web application.

Since Browser agent version 1.267, the type can be pointer or keyboard as per the web-vitals v4 library. interactionType will only occur when value of the timingName attribute is interactionToNextPaint.

Prior to Browser agent version 1.267, this attribute only occurs when the value of the timingName attribute is firstInteraction and it can be one of the following types:

  • pointerdown
  • mousedown
  • click
  • keydown
  • touchstart

For more information, see the PageViewTiming documentation.

Please see the web-vitals documentation for current browser support.

largestContentfulPaint
seconds (s)

This metric reports the render time of the largest content element visible in the viewport, which is a more accurate way to measure when the main content of a page is loaded and useful.

For more information, see the PageViewTiming documentation.

largestShiftTarget

Per the web-vitals v4 library, if specified, this is a selector identifying the first element (in document order) that shifted when the single largest layout shift contributing to the page's CLS score occurred.

This attribute only occurs when the value of the timingName attribute is cumulativeLayoutShift.

Please see the web-vitals documentation for current browser support.

largestShiftTime

Per the web-vitals v4 library, if specified, this is the time when the single largest layout shift contributing to the page's CLS score occurred.

This attribute only occurs when the value of the timingName attribute is cumulativeLayoutShift.

Please see the web-vitals documentation for current browser support.

largestShiftValue

Per the web-vitals v4 library, if specified, this is the layout shift score of the single largest layout shift contributing to the page's CLS score occurred.

This attribute only occurs when the value of the timingName attribute is cumulativeLayoutShift.

Please see the web-vitals documentation for current browser support.

loadState

The loading state of the document at the time of the corresponding event. It can have one of the following values:

  • 'loading'
  • 'dom-interactive'
  • 'dom-content-loaded'
  • 'complete'

For more information, see the web-vitals v4 library documentation.

metricId

A unique ID used by the Google Core Web Vitals library to track changes for a particular metric instance. For more information, see this link.

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 largestContentfulPaint and firstInteraction events on compatible browsers.

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 largestContentfulPaint and firstInteraction events on compatible browsers.

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 largestContentfulPaint and firstInteraction events on compatible browsers.

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 largestContentfulPaint and firstInteraction events on compatible browsers.

The value is captured from the NetworkInformation API. For a full browser compatibility table and description see the MDN web docs.

nextPaintTime

The best-guess timestamp of the next paint after the interaction. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint. For more information, see the web-vitals v4 library documentation.

Introduced in browser agent version 1.267 as part of web-vitals v4 library. Please see the web-vitals documentation for current browser support.

pageHide

Sent when the document becomes hidden to the user, which could mean the user switched tabs or navigated to another page. This is the most reliable event to indicate the (potential) end of a user session or visit to the page.

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.

presentationDelay
milliseconds (ms)

The time from when the browser finished processing all event listeners for the user interaction until the next frame is presented on the screen and visible to the user. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint. For more information, see the web-vitals v4 library documentation.

Introduced in browser agent version 1.267 as part of web-vitals v4 library.Please see the web-vitals documentation for current browser support.

processingDuration
milliseconds (ms)

The time from when the first event listener started running in response to the user interaction until when all event listener processing has finished. This attribute only occurs when the value of the timingName attribute is interactionToNextPaint.

Introduced in browser agent version 1.267 as part of web-vitals v4 library. Please see the web-vitals documentation for current browser support.

regionCode

The specific administrative division within a country where the PageView 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 numerical codes.

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

resourceLoadDelay

Per web-vitals v4, this is the delta between time to first byte (TTFB) and when the browser starts loading the largest contentful paint (LCP) resource (if there is one, otherwise 0). For more information, please see Optimize LCP.

This attribute only occurs when the value of the timingName attribute is largestContentfulPaint.

Please see the web-vitals documentation for current browser support.

resourceLoadDuration
milliseconds (ms)

Per web-vitals v4, this is the total time it takes to load the LCP resource itself (if there is one, otherwise 0). For more information, please see Optimize LCP.

This attribute only occurs when the value of the timingName attribute is largestContentfulPaint.

Please see the web-vitals documentation for current browser support.

resourceLoadTime
milliseconds (ms)

The total time it takes to load the LCP resource itself (if there is one, otherwise 0). This attribute only occurs when the value of the timingName attribute is largestContentfulPaint.

Note: this has been renamed to resourceLoadDuration as per web-vitals library v4 in browser agent version 1.267 or higher.

Deprecated, please use resourceLoadDuration instead.

session

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

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

targetGroupedUrl

The grouped version of the URL in the browser at the end of the interaction.

timestamp

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

timeToFirstByte

Per web-vitals v4, this is the time from when the user initiates loading the page until when the browser receives the first byte of the response (for example, time to first byte (TTFB)).

This attribute only occurs when the value of the timingName attribute is firstContentfulPaint or largestContentfulPaint.

Please see the web-vitals documentation for current browser support.

timingName

The name of the timing event: firstPaint, firstContentfulPaint, or firstInteraction.

The name of the timing event: firstPaint, firstContentfulPaint, or firstInteraction. For more information, see the PageViewTiming documentation.

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)

Sent when the page unloading is detected, which marks the definitive end of a user session or visit to the page.

ProcessSample

Data source:

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.

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

In Linux, this attribute is retrieved from `/proc/PID/stat`, in which strings longer than 16 characters are silently truncated. Internally, linux command names can be up to 16 bytes long. More information can be found in the [proc manual pages](https://man7.org/linux/man-pages/man5/proc.5.html).
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 containerLabel_KEY, and the returned stringtype value is then associated with that attribute.

For example, to query a owner label for containers maintained by Test User:

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 /proc/PID/io file, where PID is the ID of the process being monitored.

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 /proc/PID/io file, where PID is the ID of the process being monitored.

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.

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.

ServiceLevelSnapshot

Data source:

This event is created when we periodically calculate the compliance and remaining error budget for a given service level entity.

Attribute nameDefinitionData types
entity.name

The service level entity name.

remainingErrorBudget
percentage (%)

The remaining error budget (based on the SLI compliance and the service level objective).

sliCompliance
percentage (%)

The service level compliance (% of good vs valid events) calculated for the configured SLO time window (1d, 7d or 28d).

timestamp
milliseconds (ms)

The time at which the calculation was done, in Unix time.

Span

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

Attribute nameDefinitionData types
appId
ID

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

appName

The application name set in the New Relic agent configuration.

asn

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

asn.latitude

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

asn.longitude

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

asn.organization

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

browserApp.name

The name of the browser application monitored by New Relic.

browserInteraction.id
ID

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

browserInteraction.name

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

bytes.received
bytes (B)

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

bytes.sent
bytes (B)

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

category

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

code.filepath

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

code.function

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

code.lineno

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

code.namespace

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

component

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

connection.type

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

containerId
ID

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

db.instance

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

db.statement

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

device.size

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

device.type

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

duration
seconds (s)

The span's elapsed time in seconds.

duration.ms
milliseconds (ms)

The span's elapsed time in milliseconds.

entity.guid
ID

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

entity.name

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

error

Makes a span as having an error.

error.class

The full class name for the span's error.

error.message

The message for the span's error.

error.statusCode

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

error.type

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

geo.city

The city in which the span occurred.

geo.countryCode

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

geo.regionCode

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

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

groupedPageUrl

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

groupedRequestUrl

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

guid
ID

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

host

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

http.method

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

http.statusCode
enum

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

http.statusText
enum

The response status message for a web request.

http.url

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

httpResponseCode
enum

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

jsDuration.ms
milliseconds (ms)

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

mobileApp.name

The name of the mobile application that created this span.

name

The span name that best represents the operation.

networkError

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

networkError.code

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

newRelic.ingestPoint

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

newRelic.traceFilter.type

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

pageUrl

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

parentId
ID

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

peer.address

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

peer.hostname

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

port
enum

The request port.

priority

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

realAgentId
ID

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

request.bodySize
bytes (B)

The payload size of the request body, in bytes.

request.domain

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

request.method

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

request.path

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

request.url

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

response.body

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

response.bodySize
bytes (B)

The payload size of the response body, in bytes.

response.statusCode
enum

The HTTP response code. Example: 200.

sampled

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

service.name

The name of the instrumented service that created this span.

session

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

span.kind

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

timeSinceBrowserInteractionStart.ms
milliseconds (ms)

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

timestamp

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

timeToLastCallbackEnd.ms
milliseconds (ms)

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

timeToLoadEventStart.ms
milliseconds (ms)

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

timeToSettle.ms
milliseconds (ms)

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

trace.id
ID

The unique ID (a randomly generated string) used to identify a single request as it crosses inter- and intra- process boundaries. This ID allows the linking of spans in a distributed trace. Included when distributed tracing is enabled.

traceId
ID

The unique ID (a randomly generated string) used to identify a single request as it crosses inter- and intra- process boundaries. This ID allows the linking of spans in a distributed trace. Included when distributed tracing is enabled.

transaction.name

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

transactionId
ID

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

userAgent.name

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

userAgent.os

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

userAgent.version

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

StorageSample

Data source:

StorageSample event represents a single storage device associated with a server. Each sample gathers descriptive information about the device, the type of file system it uses, and its current usage and capacity. New Relic samples this data every 20 seconds for each mounted file system and packages it into a StorageSample event, then sends the raw data to New Relic's collectors.

Attribute nameDefinitionData types
agentName

The name of the agent (Infrastructure).

agentVersion

The version of the New Relic Infrastructure agent.

avgQueueLen
count

The average disk queue length derived from (Disk Transfers/sec) * (Disk secs/Transfer).

This metric is only available for the Windows Infrastructure agent, version 1.5.0 or higher.

This value coincides with the following Windows Performance counter:

\LogicalDisk(<drive letter>)\Avg. Disk Queue Length

avgReadQueueLen
count

The average disk read queue length derived from (Disk Reads/sec) * (Disk secs/Read).

This metric is only available for the Windows Infrastructure agent, version 1.5.0 or higher.

This value coincides with the following Windows Performance counter:

\LogicalDisk(<drive letter>)\Avg. Disk Read Queue Length

avgWriteQueueLen
count

The average disk write queue length derived from (Disk Writes/sec) * (Disk secs/Write)

This metric is only available for the Windows Infrastructure agent, version 1.5.0 or higher.

This value coincides with the following Windows Performance counter:

\LogicalDisk(<drive letter>)\Avg. Disk Write Queue Length

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.

currentQueueLen
count

Length of the disk queue at the time of sampling.

This metric is only available for the Windows Infrastructure Agent, version 1.5.0 or higher.

This value coincides with the following Windows Performance counter:

\LogicalDisk(<drive letter>)\Current Disk Queue Length

device

The device name.

diskFreeBytes
bytes (B)

The cumulative disk space that is free across all supported devices. (To find per-device values, use StorageSample events.)

diskFreePercent
percentage (%)

The cumulative disk emptiness percentage across all supported devices. To find per-device values, use StorageSample events.

diskTotalBytes
bytes (B)

The cumulative total disk space across all supported devices. To find per-device values, use StorageSample events.

diskUsedBytes
bytes (B)

The cumulative disk space used across all supported devices, in bytes. To find per-device values, use StorageSample events.

diskUsedPercent
percentage (%)

The cumulative disk fullness percentage across all supported devices. To find per-device values, use StorageSample events.

entityAndMountPoint
ID

A unique identifier concatenating the entityId and mountPoint attributes.

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.

filesystemType

The operating system's specific file system type. For example: xfs or ext4.

fullHostname

The fully qualified (DNS) hostname.

hostname

The short version of the entity's name.

inodesFree
count

The number of free inodes.

This metric is only available for the Linux Infrastructure Agent, version 1.5.0 or higher.

inodesTotal
count

The number of total available inodes.

This metric is only available for the Linux Infrastructure Agent, version 1.5.0 or higher.

inodesUsed
count

The number of inodes in use.

This metric is only available for the Linux Infrastructure Agent, version 1.5.0 or higher.

inodesUsedPercent
percentage (%)

The number of inodes in use as a fraction of the total.

This metric is only available for the Linux Infrastructure Agent, version 1.5.0 or higher.

isReadOnly

If the system is set to be read-only, this value will be true, otherwise false. These values are string literals, not booleans, to allow for faceting.

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.

mountPoint

The location of the device in the operating system's file system.

operatingSystem

The operating system on which the agent is installed.

readBytesPerSecond
bytes (B)

The number of bytes read per second from the device during the last sampling period.

readIoPerSecond

The average number of read I/O operations per second during the sampling period.

readUtilizationPercent
percentage (%)

The percent of totalUtilizationPercent dedicated to read I/O operations.

timestamp

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

totalUtilizationPercent
percentage (%)

The percent of time spent waiting for read or write disk I/O operations.

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.

writeBytesPerSecond
bytes (B)

The number of bytes per second written to the device during the last sampling period.

writeIoPerSecond

The average number of write I/O operations per second during the sample period.

writeUtilizationPercent
percentage (%)

The percent of totalUtilizationPercent dedicated to write I/O operations.

SyntheticCheck

Data source:

SyntheticCheck returns metrics from one run of a specific monitor. These metrics include duration information for the monitor, location of the monitor check, size of the request and response headers, the type of monitor, and a timestamp. Each time a synthetic monitor runs a check, details about the check are captured in the SyntheticCheck event type. SyntheticCheck events contain details specific to the check to provide visibility such as the status, type of monitor, and size of request and response headers.

Attribute nameDefinitionData types
browserVersion

Reports the version of the browser used for browser based synthetic monitors. This is only set for Chrome 112 and newer.

deviceOrientation

Reports the device orientation configuration (PORTRAIT or LANDSCAPE) if device emulation is enabled.

deviceType

Reports the device type configuration (MOBILE or TABLET) if device emulation is enabled.

duration
milliseconds (ms)

The total time between the beginning of the first HTTP request and the end of the final HTTP request, in milliseconds.

entityGuid

The unique identifier of the monitor referenced in New Relic One.

error

Error message returned during the monitor run, if an error message was received.

executionDuration
milliseconds (ms)

The total time spent executing the synthetic check, in milliseconds.

hasUserDefinedHeaders

A boolean value that indicates if custom headers are defined for a ping or simple browser monitor.

id
ID

A unique number identifying this monitor check.

isMuted

A boolean value that indicates the monitor status is muted. This will only be set if the monitor configuration is changed to muted. This will not be set if the monitor is part of a monitor downtime or muting rules configuration.

location

The location from which the monitor check ran. For example, AWS_US_EAST_1 identifies a location on the east coast of the United States.

locationLabel

The check location (user friendly).

minionContainerSystemVersion
ID

The version of the Docker or Kubernetes running on the minion.

minionDeploymentMode
ID

Represents how the minion is deployed (for example, wrapped as a Kubernetes pod).

monitorExtendedType

Indicates the monitor type for extended type monitors, including BROKEN_LINKS, CERT_CHECK, and STEP_MONITOR. This will otherwise be set to NONE.

monitorId
ID

A unique number identifying a particular monitor.

monitorName

The name of the monitor, as shown in the Synthetics interface.

result

Whether the monitor run succeeded.

runtimeType

Set to CHROME_BROWSER for browser based monitors and NODE_API for API based monitors if the check executed on a non-legacy runtime.

runtimeTypeVersion

The version of the runtimeType used if the check executed on a non-legacy runtime.

scriptLanguage

Set to JAVASCRIPT for non-ping monitors if the check executed on a non-legacy runtime.

secureCredentials

A comma separated list of secure credential names used in the monitor run.

timestamp
milliseconds (ms)

The start time of the job in milliseconds since the Unix epoch. (See https://currentmillis.com for an example.)

totalRequestBodySize
bytes (B)

The size of the body request to the host, in bytes.

totalRequestHeaderSize
bytes (B)

The size of the header request to the host, in bytes.

totalResponseBodySize
bytes (B)

The size of the response body returned by the host, in bytes.

totalResponseHeaderSize
bytes (B)

The size of the response header returned by the host, in bytes.

type

The monitor type. Options include: SIMPLE, BROWSER, SCRIPT_BROWSER, API_TEST.

Each of these have user-friendly names, captured by the typeLabel attribute; these are, respectively: ping monitor, simple browser monitor, scripted browser monitor, and API test monitor.

typeLabel

The user-friendly name of the monitor type.

userDaysUntilExpiration
days

The days remaining until the configured expiration threshold on a certificate check monitor is reached. For private locations this requires Synthetics Job Manager release-350 and Node API runtime 1.2.58 or higher.

websiteDaysUntilExpiration
days

The days remaining until expiration for a domain tested by a certificate check monitor. For private locations this requires Synthetics Job Manager release-350 and Node API runtime 1.2.58 or higher.

SyntheticRequest

Data source:

SyntheticRequest returns results from individual HTTP requests made during a check. The data gathered includes job information, location, type of content for request, duration information, request size, and page load information. With each simple or scripted monitor check, we capture each individual HTTP request made during the check. The HTTP details are captured at a more granular level than the SyntheticsCheck event type.

Attribute nameDefinitionData types
checkId
ID

The unique identifier of the check that triggered this request.

contentCategory

A generalized version of the media type of the content returned by the host; for example, html or javascript. To query the exact media type, use the contentType attribute.

contentType

The media type [external link] of the content returned by the host; for example, text/html or image/gif.

domain

The domain portion of the request URL. To retrieve the entire URL, use the URL attribute.

domComplete
milliseconds (ms)

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

For more information on timestamps, see DOMHighResTimeStamp.

For more information on document readiness status, see Parsing HTML documents.

Google's Navigation and Resource Timing Load Performance Assessment contains detailed information about its Navigation Timing API and domComplete.

domContentLoadedEventEnd
milliseconds (ms)

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

For more information on timestamps, see DOMHighResTimeStamp.

For more information on the DOMContentLoaded event, see Parsing HTML documents.

Google's Navigation and Resource Timing Load Performance Assessment contains detailed information about its Navigation Timing API and domContentLoadedEventEnd.

domContentLoadedEventStart
milliseconds (ms)

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

For more information on timestamps, see DOMHighResTimeStamp.

For more information on document readiness status, see Parsing HTML documents.

Google's Navigation and Resource Timing Load Performance Assessment contains detailed information about its Navigation Timing API and domContentLoadedEventStart.

domInteractive
milliseconds (ms)

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

For more information on timestamps, see DOMHighResTimeStamp.

For more information on document readiness status, see Parsing HTML documents.

Google's Navigation and Resource Timing Load Performance Assessment contains detailed information about its Navigation Timing API and domInteractive.

duration
milliseconds (ms)

The total time for this request, in milliseconds.

durationBlocked
milliseconds (ms)

The total time this request was blocked, in milliseconds.

durationConnect
milliseconds (ms)

The total time this request was establishing a connection, in milliseconds. This is inclusive of the timing from durationSSL.

durationDNS
milliseconds (ms)

The total time this request resolving DNS, in milliseconds.

durationReceive
milliseconds (ms)

The total time this request was receiving data, in milliseconds.

durationSend
milliseconds (ms)

The total time this request was sending data, in milliseconds.

durationSSL
milliseconds (ms)

The total time spent establishing an SSL connection, in milliseconds.

durationWait
milliseconds (ms)

The total time this request was waiting, in milliseconds.

entityGuid

The unique identifier of the monitor referenced in New Relic One.

externalResource

Whether the resource returned by the host is from an external domain. Returns TRUE for an external domain.

firstContentfulPaint
milliseconds (ms)

firstContentfulPaint is the point when the browser renders the first bit of content from the DOM, which may be text, an image, SVG, or a <canvas> element.

Google's User-centric Performance Metrics contains detailed information about its Paint Timing API and firstContentfulPaint.

firstPaint
milliseconds (ms)

firstPaint marks the point when the browser renders anything that is visually different from what was on the screen prior to navigation. This includes non-default background paint and the enclosing box of an iframe.

Google's User-centric Performance Metrics contains detailed information about its Paint Timing API and firstPaint.

hierarchicalURL
ID

The identifier that holds the URL that the minion is running jobs on.

host

The hostname of the server that processed the request.

id
ID

A unique number identifying this monitor check.

isAjax

Whether the request is an AJAX request, determined by the HTTP_X_REQUESTED_WITH header.

isNavigationRoot

A boolean value that indicates the start point of request navigation in a scripted browser.

jobId
ID

Alias for checkId.

loadEventEnd
milliseconds (ms)

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

For more information on timestamps, see DOMHighResTimeStamp.

Google's Navigation and Resource Timing Load Performance Assessment contains detailed information about its Navigation Timing API and loadEventEnd.

loadEventStart
milliseconds (ms)

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

For more information on timestamps, see DOMHighResTimeStamp.

Google's Navigation and Resource Timing Load Performance Assessment contains detailed information about its Navigation Timing API and loadEventStart.

location

The location from which the monitor check ran. For example, AWS_US_EAST_1 identifies a location on the east coast of the United States.

locationLabel
ID

The request location (user friendly).

longRunningTasksAvgTime
milliseconds (ms)

The average time of long running tasks.

longRunningTasksCount
count

A browser responds to user input by adding tasks to a queue on the main thread to be executed one by one. Any task taking 50 milliseconds or longer to execute is identified as a long running time.

Google's User-centric Performance Metrics contains detailed information about its Paint Timing API and longRunningTasksCount.

longRunningTasksMaxTime
milliseconds (ms)

The maximum time of long running tasks.

longRunningTasksMinTime
milliseconds (ms)

The minimum time of long running tasks.

minion
ID

The identifier that holds the IP address of the minion.

minionId
ID

The unique identifier of this minion.

minionJobsReceived5MinRate
rate

The number of jobs the minion received in five minutes.

minionJobsSkipped5MinRate
rate

The number of jobs the minion skipped in five minutes.

monitorId
ID

The unique identifier of the monitor that the minion is running on.

monitorName

The name of the monitor, as shown in the Synthetics interface.

nr.durationConnectV2

The boolean identifier that holds if the minion is connected to V2.

onPageContentLoad
milliseconds (ms)

The total time to completely load and parse the initial HTML document, in milliseconds. This does not include external resources such as stylesheets, images and subframes.

onPageLoad
milliseconds (ms)

The total time to load the page and all dependent resources, in milliseconds.

pageref

The page request to which the requested resource belongs. Page requests are numbered from page_0 upward.

parentId

The identifier of the host system that the minion is running on. port: The unique identifier of the port.

path

The path portion of the request URL. To retrieve the entire URL, use the URL attribute.

port
ID

The unique identifier of the port.

requestBodySize
bytes (B)

The size of the body request to the host, in bytes.

requestHeaderSize
bytes (B)

The size of the header request to the host, in bytes.

responseBodySize
bytes (B)

The size of the response body from the host, in bytes.

responseCode
enum

The HTTP response code returned by the host; for example, 200, 400, 503, atc.

responseHeaderSize
bytes (B)

The size of the response header from the host, in bytes.

responseStatus
ID

The identifier that holds if the job has been timed out.

runtimeType

Set to CHROME_BROWSER for browser based monitors and NODE_API for API based monitors if the check executed on a non-legacy runtime.

runtimeTypeVersion

The version of the runtimeType used if the check executed on a non-legacy runtime.

scriptLanguage

Set to JAVASCRIPT for non-ping monitors if the check executed on a non-legacy runtime.

serverIPAddress

The IP address of the server that processed the request.

sslCertificateExpirationDaysRemaining
ID

How many days remain before the ssl certificate expires. This value is only created for ping monitors with the Verify SSL option enabled.

sslCertificateExpirationMs
milliseconds (ms)

The epoch timestamp that the certificate expires in milliseconds. This value is only created for ping monitors with the Verify SSL option enabled.

timestamp
milliseconds (ms)

The start time of the job in milliseconds since the Unix epoch. (See https://currentmillis.com for an example.)

unloadEventEnd
milliseconds (ms)

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

For more information on timestamps, see DOMHighResTimeStamp.

Google's Navigation and Resource Timing Load Performance Assessment contains detailed information about its Navigation Timing API and unloadEventEnd.

unloadEventStart
milliseconds (ms)

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

For more information on timestamps, see DOMHighResTimeStamp.

Google's Navigation and Resource Timing Load Performance Assessment contains detailed information about its Navigation Timing API and unloadEventStart.

URL

The full request URL.

verb

The protocol (such as GET or POST) used to make the request.

SyntheticsPrivateLocationStatus

Data source:

Every monitor check running on a private location triggers capacity details for that private location. These details are captured in a SyntheticPrivateLocationStatus event. This provides visibility into the capacity of a private location and whether additional minions are required to support the workload.

Attribute nameDefinitionData types
checksPending
count

Total number of queued checks waiting to run in the private location.

jobManagerHeavyweightJobs
count

Total number of queued non-ping checks waiting to run in the private location using runtimes supported by synthetics job manager.

minionHeavyweightJobs
count

Total number of queued non-ping checks waiting to run in the private location using runtimes supported by containerized private minion (CPM).

name

The private location name that New Relic sets internally, based on the accountId, location name, and private location key.

pingJobs
count

Total number of queued ping checks waiting to run in the private location. Ping jobs can be ran by synthetics job manager or containerized private minions (CPM)

timestamp
milliseconds (ms)

The start time of the job in milliseconds since the Unix epoch. (See https://currentmillis.com for an example.)

SyntheticsPrivateMinion

Data source:

If you have private locations, such as those inside your firewall, you can view information regarding those locations with the SyntheticsPrivateMinion event. Each private minion running sends health details to SyntheticPrivateMinion every 30 seconds. This allows you to understand the health of the private minion running at the location.

Attribute nameDefinitionData types
minionArchitecture
ID

The identifier that holds what type of architecture the minion host uses.

minionBuildNumber
ID

The identifier of the minion build number.

minionContainerSystemVersion
ID

The version of the Docker or Kubernetes running on the minion.

minionDockerVer
ID

The version of Docker running in the minion.

minionHostname
ID

The identifier of the minion host name.

minionId
ID

The unique identifier of this minion.

minionIpv4

The IP address that the minion is running on.

minionIsContainerized

The identifier that identifies if the minion is containerized or not. Returns FALSE if the minion is a Legacy Private Minion.

minionIsPrivate

The identifier that identifies if the minion is private or not. Returns TRUE for a private minion.

minionJobsFailed
count

The number of jobs this minion has failed.

minionJobsFailed15MinRate
rate

The number of jobs the minion failed in fifteen minutes.

minionJobsFailed1MinRate
rate

The number of jobs the minion failed in one minute.

minionJobsFailed5MinRate
rate

The number of jobs the minion failed in five minutes.

minionJobsFinished
count

The number of jobs this minion has finished.

minionJobsFinished15MinRate
rate

The number of jobs the minion finished in fifteen minutes

minionJobsFinished1MinRate
rate

The number of jobs the minion finished in one minute.

minionJobsFinished5MinRate
rate

The number of jobs the minion finished in five minutes.

minionJobsInternalEngineError
count

The total number of internal engine errors in the minion.

minionJobsInternalEngineError15MinRate
rate

The number of internal engine errors in the minion in fifteen minutes.

minionJobsInternalEngineError1MinRate
rate

The number of internal engine errors in the minion in one minute.

minionJobsInternalEngineError5MinRate
rate

The number of internal engine errors in the minion in five minutes.

minionJobsQueued
count

The number of jobs this minion is currently working on.

minionJobsQueued15MinRate
rate

The number of jobs the minion worked on in fifteen minutes.

minionJobsQueued1MinRate
rate

The number of jobs the minion worked on in one minute.

minionJobsQueued5MinRate
rate

The number of jobs the minion worked on in five minutes.

minionJobsReceived
count

The number of jobs this minion has received to process.

minionJobsReceived15MinRate
rate

The number of jobs the minion received in fifteen minutes.

minionJobsReceived1MinRate
rate

The number of jobs the minion received in one minute.

minionJobsReceived5MinRate
rate

The number of jobs the minion received in five minutes.

minionJobsRunning
count

The number of jobs the minion is running.

minionJobsSkipped
count

The total number of jobs the minion skipped.

minionJobsSkipped15MinRate
rate

The number of jobs the minion skipped in fifteen minutes.

minionJobsSkipped1MinRate
rate

The number of jobs the minion skipped in one minute.

minionJobsStarted
count

The number of jobs this minion has started.

minionJobsStarted15MinRate
rate

The number of jobs the minion started in fifteen minutes.

minionJobsStarted1MinRate
rate

The number of jobs the minion started in one minute.

minionJobsStarted5MinRate
rate

The number of jobs the minion started in five minutes.

minionJobsTimedout
count

The number of jobs that reached the maximum execution time.

minionJobsTimedout15MinRate
rate

The number of jobs that reached the maximum execution time in fifteen minutes.

minionJobsTimedout1MinRate
rate

The number of jobs that reached the maximum execution time in one minute.

minionJobsTimedout5MinRate
rate

The number of jobs that reached the maximum execution time in five minutes.

minionLocation

The location code this minion is operating in.

minionLocationIsPrivate

The boolean identifier of the minion is private or not.

minionOsName
ID

The identifier of the operating system the minion is running.

minionOsVersion
ID

The version of the operating system that the minion is running on.

minionPhysicalMemoryFreeBytes
bytes (B)

The number of free physical memory in bytes that the minion has access to.

minionPhysicalMemoryFreePercentage
percentage (%)

The percentage of free physical memory that the minion has access to.

minionPhysicalMemoryTotalBytes
bytes (B)

The total number of physical memory in bytes that the minion has access to.

minionPhysicalMemoryUsedBytes
bytes (B)

The amount of physical memory in bytes that the minion has used.

minionPhysicalMemoryUsedPercentage
percentage (%)

The percentage of used physical memory in the minion.

minionProcessors
count

The number of CPUs that the minion host has.

minionProcessorsFrequencyGHz
count

The frequency in GHz in which the processors are running at.

minionProcessorsUsagePercentage
percentage (%)

The total percentage of the processor that the minion uses.

minionProvider
ID

The identifier of the minion provider.ider.

minionStartTimestamp

The time which this specific minion started.

minionSwapMemoryFreeBytes
bytes (B)

The amount of free swap memory in bytes that the minion has access to.

minionSwapMemoryFreePercentage
percentage (%)

The percentage of free swap memory that is accessible by the minion.

minionSwapMemoryTotalBytes
bytes (B)

The total number of swap memory in bytes that the minion has access to.

minionSwapMemoryUsedBytes
bytes (B)

The amount of swap memory in bytes that the minion has used.

minionSwapMemoryUsedPercentage
percentage (%)

The percentage of used swap memory in the minion.

minionSystemUptimeMs
milliseconds (ms)

The time that the system has been running.

minionUptimeMs
milliseconds (ms)

The time that minion has been running.

minionVmName
ID

The identifier of the virtual machine name the minion is running on.

minionVmSpecVersion
ID

The version of the Java virtual machine that the minion is running.

minionVmUptimeMs
milliseconds (ms)

The time that the Java virtual machine has been running.

minionVmVendor
ID

The identifier of the Java virtual machine vendor that the minion is running on. (Examples: Oracle Corporation, AdobeOpenJDK, etc.)

minionVmVersion
ID

The version of the virtual machine that the minion is running on.

minionWorkers
count

The number of concurrent workers that can process jobs for Simple Browser, Scripted Browser, and API Test monitors.

SystemSample

Data source:

The SystemSample event aggregates data describing the current overall state of the entire server. This data appears in the New Relic Infrastructure Hosts page to show usage trends for the associated host's main resources. These resources include CPU, memory, disk, and network. New Relic samples this data every 5 seconds and packages it into a SystemSample event, then sends the raw data to New Relic's collectors.

Attribute nameDefinitionData types
agentName

The name of the agent (Infrastructure).

agentVersion

The version of the New Relic Infrastructure agent.

coreCount
count
  • Linux: [/proc/cpuinfo: 'cpu cores'] The number of cores within a single CPU.

  • Windows: [WMI win32_processor: 'NumberOfLogicalProcessors'] The number of logical processors, including cores divided by hyperthreading.

cpuIdlePercent
percentage (%)

The portion of the current CPU utilization capacity that is idle.

This is calculated as:

(100.00 - cpuUserPercent - cpuSystemPercent - cpuIOWaitPercent) / elapsed_time

cpuIoWaitPercent
percentage (%)

The portion of the current CPU utilization composed only of I/O wait time usage.

This is calculated as:

current_sample_io_time - previous_sample_io_time) / elapsed_time

cpuPercent
percentage (%)

Total CPU utilization as a percentage. This is not an actual recorded value; it is an alias that combines percentage data from cpuSystemPercent, cpuUserPercent, cpuIoWaitPercent and cpuStealPercent.

This is calculated as:

(cpuUserPercent + cpuSystemPercent + cpuIOWaitPercent + cpuStealPercent)

cpuStealPercent
percentage (%)

The portion of time when a virtualized CPU is waiting for the hypervisor to make real CPU time available to it.

cpuSystemPercent
percentage (%)

The portion of the current CPU utilization composed only of system time usage.

This is calculated as:

(current_sample_sys_time - previous_sample_sys_time) / elapsed_time

cpuUserPercent
percentage (%)

The portion of the current CPU utilization composed only of user time usage.

This is calculated as:

current_sample_user_time - previous_sample_user_time) / elapsed_time

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.

diskFreeBytes
bytes (B)

The cumulative disk space that is free across all supported devices. (To find per-device values, use StorageSample events.)

diskFreePercent
percentage (%)

The cumulative disk emptiness percentage across all supported devices. To find per-device values, use StorageSample events.

diskReadsPerSecond
rate

The number of read I/O operations per second.

diskReadUtilizationPercent
percentage (%)

The portion of disk I/O utilization for read operations.

diskTotalBytes
bytes (B)

The cumulative total disk space across all supported devices. To find per-device values, use StorageSample events.

diskUsedBytes
bytes (B)

The cumulative disk space used across all supported devices, in bytes. To find per-device values, use StorageSample events.

diskUsedPercent
percentage (%)

The cumulative disk fullness percentage across all supported devices. To find per-device values, use StorageSample events.

diskUtilizationPercent
percentage (%)

The percent of time spent waiting for read or write disk I/O operations.

diskWritesPerSecond
rate

The number of write I/O operations per second.

diskWriteUtilizationPercent
percentage (%)

The portion of disk I/O utilization for write operations.

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.

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.

loadAverageFifteenMinute
count

Over the last fifteen minutes, the average number of system processes, threads, or tasks that are waiting and ready for CPU time.

loadAverageFiveMinute

Over the last 5 minutes, the average number of system processes, threads, or tasks that are waiting and ready for CPU time.

loadAverageOneMinute

Over the last minute, the average number of system processes, threads, or tasks that are waiting and ready for CPU time.

memoryBuffers
bytes (B)

The portion of buffered memory available to this server, in bytes.

memoryCachedBytes
bytes (B)

The total amount of cached memory, in bytes, available to this server.

This metric is only available for the Linux Infrastructure agent, version 1.18.1 or higher.

memoryFreeBytes
bytes (B)

The portion of free memory available to this server, in bytes.

MemoryFreePercent
percentage (%)

The portion of free memory available to the server.

memoryKernelFree
bytes (B)

The portion of physical memory not used by the system, in bytes.

memorySharedBytes
bytes (B)

The total amount of shared memory, in bytes, available to this server.

This metric is only available for the Linux Infrastructure agent, version 1.18.1 or higher.

memorySlabBytes
bytes (B)

The total amount of slab memory, in bytes, available to this server.

This metric is only available for the Linux Infrastructure agent, version 1.18.1 or higher.

memoryTotalBytes
bytes (B)

The total amount of memory, in bytes, available to this server.

memoryUsedBytes
bytes (B)

The portion of available memory that is in use on this server, in bytes.

ntpOffset
seconds

The time difference in seconds between the host and the provided NTP hosts.

operatingSystem

The operating system on which the agent is installed.

processorCount
count
  • Linux: [/proc/cpuinfo: 'processor'] The total number of cores in all CPUs.

  • Windows: [WMI win32_processor: 'NumberOfCores'] The number of physical processors on the integrated circuit.

swapFreeBytes
bytes (B)

The portion of available swap space on this server that is free, in bytes.

swapInBytes
bytes (B)

The amount of memory swapped in, in bytes. This metric is only available for the Linux Infrastructure agent, version 1.32.0 or higher.

swapOutBytes
bytes (B)

The amount of memory swapped out, in bytes. This metric is only available for the Linux Infrastructure agent, version 1.32.0 or higher.

swapTotalBytes
bytes (B)

The total amount of swap space available to the server, in bytes.

swapUsedBytes
bytes (B)

The portion of available swap space on this server that is in use, in bytes.

timestamp

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

uptime
seconds (s)

The amount of time the system has been active (running), in seconds.

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.

Transaction

Data source:

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

Attribute nameDefinitionData types
accountId
ID

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

appId
ID

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

appName

The application name set in the New Relic agent configuration.

databaseCallCount
count

The number of database calls made by this transaction.

databaseDuration
seconds (s)

The database response time in seconds.

duration
seconds (s)

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

error
Boolean

Indicates whether an error was noticed during execution.

errorMessage

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

errorType

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

eventLoopTime
seconds (s)

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

eventLoopWait
seconds (s)

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

externalCallCount
count

The number of external calls made by this transaction.

externalDuration
seconds (s)

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

gcCumulative
seconds (s)

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

guid
ID

The identifier for the transaction.

host

The name of the application host that processed this request.

http.statusCode
enum

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

http.statusText
enum

The response status message for a web request.

httpResponseCode
enum

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

memcacheDuration
seconds (s)

The memcache response time, in seconds.

name

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

parent.account
ID

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

parent.app
ID

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

parent.transportDuration

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

parent.transportType

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

parent.type

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

parentId
ID

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

priority

Likelihood this event will be saved.

queueDuration
seconds (s)

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

realAgentId
ID

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

request.headers.accept

The types as read from the HTTP Accept request header.

request.headers.contentLength
bytes (B)

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

request.headers.contentType

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

request.headers.host

The name from the HTTP host request header.

request.headers.referer

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

request.headers.userAgent

The contents of the User-Agent HTTP header.

request.method

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

request.uri

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

response.headers.contentLength
bytes (B)

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

response.headers.contentType

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

response.status
enum

The HTTP response code associated with the transaction.

sampled

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

totalTime
seconds (s)

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

trace.id
ID

The unique ID (a randomly generated string) used to identify a single request as it crosses inter- and intra- process boundaries. This ID allows the linking of spans in a distributed trace. Included when distributed tracing is enabled.

transactionSubType

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

transactionType

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

tripId
ID

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

webDuration

The duration of the transaction, equivalent to duration.

TransactionError

Data source:

Transaction errors occur when a transaction throws an exception in the code path that was taken to complete that transaction. The number of transaction errors does not equal the number of transactions, because you can specify whether you want to collect, ignore, or mark errors as expected.

Attribute nameDefinitionData types
accountId
ID

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

appId
ID

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

appName

The application name set in the New Relic agent configuration.

databaseCallCount
count

The number of database calls made by this transaction.

databaseDuration
seconds (s)

The database response time in seconds.

duration
seconds (s)

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

error.class

The class name or type for the error. This will be server and platform specific.

error.expected

Determines whether an error is expected or not. Expected errors do not affect error rates or Apdex.

error.message

The error message for the transaction. This will be server and platform specific.

errorType

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

eventLoopTime
seconds (s)

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

eventLoopWait
seconds (s)

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

externalCallCount
count

The number of external calls made by this transaction.

externalDuration
seconds (s)

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

gcCumulative
seconds (s)

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

guid
ID

The identifier for the transaction.

host

The name of the application host that processed this request.

http.statusCode
enum

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

http.statusText
enum

The response status message for a web request.

httpResponseCode
enum

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

memcacheDuration
seconds (s)

The memcache response time, in seconds.

parent.account
ID

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

parent.app
ID

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

parent.transportDuration

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

parent.transportType

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

parent.type

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

parentId
ID

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

port

The listening port of the transaction that generated the event. This information will not always be available, so this attribute may not always be reported.

priority

Likelihood this event will be saved.

queueDuration
seconds (s)

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

realAgentId
ID

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

request.headers.accept

The types as read from the HTTP Accept request header.

request.headers.contentLength
bytes (B)

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

request.headers.contentType

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

request.headers.host

The name from the HTTP host request header.

request.headers.referer

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

request.headers.userAgent

The contents of the User-Agent HTTP header.

request.method

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

response.headers.contentLength
bytes (B)

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

response.headers.contentType

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

response.status
enum

The HTTP response code associated with the transaction.

sampled

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

threadConcurrency
count

A measure of "thread utilization", representing the number of threads handling concurrent requests.

timestamp
milliseconds (ms)

The start time of the job in milliseconds since the Unix epoch.

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

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

transactionUiName

The UI display name equivalent of transactionName.

wsgi.input.calls.read
count

(Python agent only) The number of calls to read() by the WSGI server to handle request.

wsgi.input.calls.readline
count

(Python agent only) The number of calls to readline() by the WSGI server to handle request.

wsgi.input.calls.readlines
count

(Python agent only) The number of calls to readlines() by the WSGI server to handle request.

wsgi.output.calls.write
count

(Python agent only) Number of calls to yield by the WSGI server to send response.

wsgi.output.calls.yield
count

(Python agent only) Number of calls to yield by the WSGI server to send response.

UserAction

Data source:

The Browser UserAction event is captured as the result of a user interaction with the web application and includes action information and DOM target identifiers along with several default attributes, such as app and geographic data.

The types of interactions captured include:

  • auxclick
  • blur (window only)
  • click
  • copy
  • focus (window only)
  • keydown
  • paste
  • scrollend

Please see element events for more information about the type of events the agent subscribes to when capturing UserAction events.

Attribute nameDefinitionData types
action

The action performed by the end user.

actionCount

The number of times the matching action was seen.

actionDuration
milliseconds (ms)

The duration between the first and last event of the aggregation set.

actionMs

A stringified array of the MS timestamps relative to the origin point of the first observed event in the set.

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.

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 value at the time of observing the event. This URL may differ from the Page URL if soft navigations have occurred.

deviceType

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

hasReplay

Indicates whether the event is associated with a session replay. If you already have custom dashboards, adding hasReplay = true to queries would allow you to search for a particular session of interest and watch the replay.

name

The name of the invoked web transaction. For example: Controller/customers/show.

nearest__

The value of the attribute name of the nearest DOM element to the target which was acted upon. If an attribute is supplied to the agent configuration but not found on the target element, this value will reflect the nearest parental node that has the matching attribute name. If the target contains the desired attribute name, the corresponding "nearest" and "target" attributes will match. This behavior is influenced by the elementAttributes property supplied to the agent configuration. For example: nearestId, nearestClass, nearestTag, and nearestType are the default values collected. If other attributes are supplied to the configuration, they will be reported matching the same target + 'attribute name' syntax.

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.

rageClick

A boolean flag indicating if the event qualifies as a "rage click" (repeated clicks on an element).

regionCode

The specific administrative division within a country where the PageView 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 numerical codes.

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

session

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

sessionTraceId
ID

Allows for linking together end user actions from session traces and querying across browser events. Not all browser events will have this. For example, PageView events complete before the first session trace harvest. Also, initial page loads from BrowserInteraction won't always include this.

target

The window, document or CSS selector path generated for the event.

target__

The value of the attribute name of the DOM target which was acted upon. This is influenced by the elementAttributes supplied to the agent configuration. For example: targetId, targetClass, targetTag, and targetType are the default values collected. If other attributes are supplied to the configuration, they will be reported matching the same target + 'attribute name' syntax.

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.

Vulnerability

New Relic Vulnerability Management is an opinionated solution that helps Devs, SREs, and Infosec teams build and run secure software with more confidence and less effort by centralizing, organizing, and prioritizing security risks in observability context.

Attribute nameDefinitionData types
cve

The common vulnerability and exposure ID assigned by the disclosing agency.

cvss.score

The vulnerablity's CVSS score as assigned by the disclosing agency.

cvss.vector

A breakdown of the CVSS score's components as assigned by the disclosing agency.

description

Long form description of the vulnerability. May include exploit risks, specific versions, other links.

disclosureUrl

A URL linking to detailed information on the vulnerability from the disclosing agency.

entity.guid

The unique ID of the New Relic entity impacted by the vulnerability.

entityGuid

The unique ID of the New Relic entity impacted by the vulnerability.

entityLookupValue

An identifier created by New Relic using details from the disclosing agency to help determine which New Relic entity this vulnerability is associated with.

entityType

The type of New Relic entity, which is determined by New Relic based on the disclosing agency and vulnerability details.

issue.id

The unique ID assigned to the vulnerability by the disclosing agency.

issue.type

The type of issue, for example library vulnerability or misconfiguration.

issue.vendor.id

The unique ID assigned to this instance of the vulnerablity by the disclosing agency.

issueId

The unique ID assigned to the vulnerablity by the disclosing agency.

issueInstanceKey

The unique ID assigned to this instance of the vulnerablity by the disclosing agency.

issueType

The type of issue, for example library vulnerability or misconfiguration.

message

Long form description of the vulnerability. May include exploit risks, specific versions, other links.

package

The name of the library or module that is vulnerable.

package.version

The version of the library or module that is vulnerable.

rawPayload

Where the original payload that New Relic received is stored - only applies to Security API ingested vulnerabilities.

remediation.exists

A boolean indicating whether the vulnerability has a fix.

remediation.upgradeAction

The action required to fix the vulnerability.

remediationExists

A boolean indicating whether the vulnerability has a fix.

scan.id

Used by 3rd party tools to identify the scan which discovered the vulnerability.

severity

The severity of the vulnerability assigned by the disclosing agency.

source

The source of the vulnerablity disclosure.

timestamp

The time the vulnerability event was created.

title

A short description of the vulnerabilty.

WorkloadStatus

Data source:

The workload status is derived from the alerting status of entities in your workload. This allows you to set up an alert condition to notify you whenever the workload goes into a DISRUPTED or DEGRADED status.

Attribute nameDefinitionData types
entity.name

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

statusValue

Human-readable value of the workload status: OPERATIONAL, DEGRADED, DISRUPTED, or UNKNOWN.

statusValueCode
enum

Numerical status code that can be used in alert conditions. 0 (operational), 2 (degraded), 3 (disrupted) or -99 (unknown). For more information, see our workload status docs.

timestamp

Time that the event occurred or was evaluated over. Specifies a time or range of time. Examples:

  • MM-DD-YYYY HH:MM:SS
  • SINCE 2018-05-28 11:18:45
  • UNTIL 30 minutes ago
  • SINCE '2018-06-20' UNTIL today
workloadGuid
ID

The New Relic-assigned GUID for a workload.