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

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.