New Relic data dictionary

This data dictionary defines some of our default-reported data stored in NRDB and queryable via NRQL. This includes events like Transaction, MobileRequest, and BrowserInteraction, and our Metric, Log, and Span data types. These definitions are also available from our query builder UI by mousing over applicable data type and attribute names.

This dictionary doesn't contain:

  • Data from our infrastructure integrations (for that, see docs for a specific integration)
  • Custom data
  • Detailed integration-specific attributes for Metric data

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.