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

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.