New Relic OTel K8s metrics mapping

preview

We're still working on this feature, but we'd love for you to try it out!

This feature is currently provided as part of a preview program pursuant to our pre-release policies.

The Kubernetes OpenTelemetry metrics are collected by the OpenTelemetry Collector and sent to New Relic using the New Relic Kubernetes integration.

This document provides a mapping of the Kubernetes OpenTelemetry metrics to the New Relic Kubernetes metrics. This mapping helps you understand the metrics and attributes that are available for monitoring your Kubernetes cluster.

The table following maps Kubernetes OpenTelemetry metrics to New Relic Kubernetes metrics. These metrics are sourced from the API server configured with the Prometheus Receiver:

OTel metric	New Relic Metric	New Relic Event Name	Type: Description
`apiserver_storage_objects`	`apiserverStorageObjects_resource_RESOURCE-KIND`	`K8sApiServerSample`	Gauge: Number of objects stored in the API server.
`go_goroutines`	`goGoroutines`	`K8sApiServerSample`	Gauge: Number of `goroutines` that currently exist.
`go_threads`	`goThreads`	`K8sApiServerSample`, `K8sControllerManagerSample`, `K8sEtcdSample`, `K8sSchedulerSample`	Gauge: Number of OS threads created.
`process_resident_memory_bytes`	`processResidentMemoryBytes`	`K8sApiServerSample`	Gauge: Resident memory size in bytes.

The table following maps Kubernetes OpenTelemetry metrics to New Relic Kubernetes metrics. These metrics are sourced from the cAdvisor configured with the Prometheus Receiver:

OTel metric	New Relic Metric	New Relic Event Name	Description
`container_cpu_cfs_periods_total`	`containerCpuCfsPeriodsTotal`	`K8sContainerSample`	Counter: Total number of elapsed enforcement period intervals.
`container_cpu_cfs_throttled_periods_total`	`containerCpuCfsThrottledPeriodsTotal`	`K8sContainerSample`	Counter: Total number of throttled period intervals.
`container_cpu_usage_seconds_total`	`cpuUsedCores`	`K8sContainerSample`	Counter: Total CPU time consumed.
`container_memory_working_set_bytes`	`memoryWorkingSetBytes`	`K8sContainerSample`	Gauge: Working set size of memory in bytes.
`container_network_receive_bytes_total`	`net.rxBytesPerSecond`	`K8sPodSample`	Counter: Cumulative count of bytes received.
`container_network_receive_errors_total`	`net.txBytesPerSecond`	`memoryRequestedBytes`	Counter: Cumulative count of receive errors encountered.
`container_network_transmit_bytes_total`	`net.errorsPerSecond`	`K8sPodSample`	Counter: Cumulative count of bytes transmitted.
`container_network_transmit_errors_total`	`net.errorsPerSecond`	`K8sPodSample`	Counter: Cumulative count of transmit errors encountered.
`container_spec_memory_limit_bytes`	`memoryLimitBytes`	`K8sContainerSample`	Gauge: Memory limit of the container in bytes.

The table following maps Kubernetes OpenTelemetry metrics to New Relic Kubernetes metrics. These metrics are sourced from the controller manager configured with the Prometheus Receiver:

OTel metric	New Relic Metric	New Relic Event Name	Description
`go_goroutines`	`goGoroutines`	`K8sControllerManagerSample`	Gauge: Number of `goroutines` that currently exist.
`process_resident_memory_bytes`	`processResidentMemoryBytes`	`K8sControllerManagerSample`	Gauge: Resident memory size in bytes.

The table following maps Kubernetes OpenTelemetry metrics to New Relic Kubernetes metrics. These metrics are sourced from the kubelet configured with the KubeletStats Receiver:

OTel metric	New Relic Metric	New Relic Event Name	Description
`container.cpu.utilization`	`cpuCoresUtilization`	`K8sContainerSample`	Gauge: CPU utilization percentage of the container.
`container.filesystem.capacity`	`fsCapacityBytes`	`K8sContainerSample`	Gauge: Total filesystem capacity for the container.
`container.filesystem.usage`	`fsUsedBytes`	`K8sContainerSample`	Gauge: Used filesystem space for the container.
`container.memory.usage`	`memoryUsedBytes`	`K8sContainerSample`	Gauge: Total memory usage of the container.
`go_goroutines`	`goGoroutines`	`K8sEtcdSample`	Gauge: Number of `goroutines` that currently exist.
`go_threads`	`goThreads`	`K8sApiServerSample`, `K8sControllerManagerSample`, `K8sEtcdSample`, `K8sSchedulerSample`	Gauge: Number of OS threads created.
`k8s.node.cpu.time`	`cpuUsedCoreMilliseconds`	`K8sNodeSample`	Gauge: Total CPU time used by the node.
`k8s.node.cpu.utilization`	`allocatableCpuCoresUtilization`	`K8sNodeSample`	Gauge: CPU utilization percentage of the node.
`k8s.node.filesystem.capacity`	`fsCapacityBytes`	`K8sNodeSample`	Gauge: Total filesystem capacity for the node.
`k8s.node.filesystem.usage`	`fsUsedBytes`	`K8sNodeSample`	Gauge: Used filesystem space for the node.
`k8s.node.memory.available`	`memoryAvailableBytes`	`K8sNodeSample`	Gauge: Available memory for the node.
`k8s.node.memory.working_set`	`memoryWorkingSetBytes`	`K8sNodeSample`	Gauge: Working set size of the node memory.
`k8s.pod.filesystem.available`	`fsAvailableBytes`	`K8sVolumeSample`	Gauge: Available filesystem space for the pod.
`k8s.pod.filesystem.capacity`	`fsCapacityBytes`	`K8sVolumeSample`	Gauge: Total filesystem capacity for the pod.
`k8s.pod.filesystem.usage`	`fsUsedBytes`	`K8sVolumeSample`	Gauge: Used filesystem space for the pod.
`k8s.pod.memory.working_set`	`memoryWorkingSetBytes`	`K8sContainerSample`	Gauge: Working set size of the pod memory.

The table following maps Kubernetes OpenTelemetry metrics to New Relic Kubernetes metrics. These metrics are sourced from the kubelet configured with the Prometheus Receiver:

OTel metric	New Relic Metric	New Relic Event Name	Description
`process_resident_memory_bytes`	`processResidentMemoryBytes`	`K8sApiServerSample`	Gauge: Resident memory size in bytes.

The table following maps Kubernetes OpenTelemetry metrics to New Relic Kubernetes metrics. These metrics are sourced from the kubeStateMetrics configured with the Prometheus Receiver:

OTel metric	New Relic Metric	New Relic Event Name	Description
`kube_cronjob_created`	`createdAt`	`K8sCronjobSample`	Gauge: Creation timestamp of the CronJob.
`kube_cronjob_spec_suspend`	`isSuspended`	`K8sCronjobSample`	Gauge: Suspend flag of the CronJob.
`kube_cronjob_status_active`	`isActive`	`K8sCronjobSample`	Gauge: Number of active CronJob instances.
`kube_cronjob_status_last_schedule_time`	`lastScheduledTime`	`K8sCronjobSample`	Gauge: Last schedule time of the CronJob.
`kube_daemonset_created`	`createdAt`	`K8sDaemonsetSample`	Gauge: Creation timestamp of the DaemonSet.
`kube_daemonset_status_desired_number_scheduled`	`podsScheduled`	`K8sDaemonsetSample`	Gauge: Desired number of scheduled DaemonSet instances.
`kube_daemonset_status_number_misscheduled`	`podsMisscheduled`	`K8sDaemonsetSample`	Gauge: Number of misscheduled DaemonSet instances.
`kube_daemonset_status_number_ready`	`podsReady`	`K8sDaemonsetSample`	Gauge: Number of ready DaemonSet instances.
`kube_daemonset_status_number_unavailable`	`podsUnavailable`	`K8sDaemonsetSample`	Gauge: Number of unavailable DaemonSet instances.
`kube_daemonset_status_updated_number_scheduled`	`podsUpdatedScheduled`	`K8sDaemonsetSample`	Gauge: Updated number of scheduled DaemonSet instances.
`kube_deployment_created`	`createdAt`	`K8sDeploymentSample`	Gauge: Creation timestamp of the Deployment.
`kube_deployment_metadata_generation`	`metadataGeneration`	`K8sDeploymentSample`	Gauge: Generation number of the Deployment metadata.
`kube_deployment_spec_replicas`	`podsDesired`	`K8sDeploymentSample`	Gauge: Number of desired replicas for the Deployment.
`kube_deployment_spec_strategy_rollingupdate_max_surge`	`rollingUpdateMaxPodsSurge`	`K8sDeploymentSample`	Gauge: Maximum surge allowed during rolling update.
`kube_deployment_status_condition`	`conditionAvailable`, `conditionProgressing`	`K8sDeploymentSample`	Gauge: Deployment status conditions.
`kube_deployment_status_observed_generation`	`observedGeneration`	`K8sDeploymentSample`	Gauge: The most recent generation observed for this Deployment.
`kube_deployment_status_replicas`	`podsTotal`	`K8sDeploymentSample`	Gauge: Number of replicas for the Deployment.
`kube_deployment_status_replicas_available`	`podsAvailable`	`K8sDeploymentSample`	Gauge: Number of available replicas for the Deployment.
`kube_deployment_status_replicas_ready`	`podsReady`	`K8sDeploymentSample`	Gauge: Number of ready replicas for the Deployment.
`kube_deployment_status_replicas_unavailable`	`podsUnavailable`	`K8sDeploymentSample`	Gauge: Number of unavailable replicas for the Deployment.
`kube_deployment_status_replicas_updated`	`podsUpdated`	`K8sDeploymentSample`	Gauge: Number of updated replicas for the Deployment.
`kube_horizontalpodautoscaler_spec_min_replicas`	`minReplicas`	`K8sHpaSample`	Gauge: Minimum number of replicas for the HorizontalPodAutoscaler.
`kube_horizontalpodautoscaler_status_condition`	`isActive`	`K8sHpaSample`	Gauge: Status conditions of the HorizontalPodAutoscaler.
`kube_horizontalpodautoscaler_status_current_replicas`	`currentReplicas`	`K8sHpaSample`	Gauge: Current number of replicas for the HorizontalPodAutoscaler.
`kube_horizontalpodautoscaler_status_desired_replicas`	`desiredReplicas`	`K8sHpaSample`	Gauge: Desired number of replicas for the HorizontalPodAutoscaler.
`kube_job_complete`	`isComplete`	`K8sJobSample`	Gauge: Whether the Job is complete `(1)` or not `(0)`.
`kube_job_created`	`createdAt`	`K8sJobSample`	Gauge: Creation timestamp of the Job.
`kube_job_failed`	`failed`	`K8sJobSample`	Gauge: Whether the Job has failed `(1)` or not `(0)`.
`kube_job_spec_active_deadline_seconds`	`specActiveDeadlineSeconds`	`K8sJobSample`	Gauge: Number of seconds the Job can run before being terminated.
`kube_job_spec_completions`	`specCompletions`	`K8sJobSample`	Gauge: Desired number of successfully finished pods for the Job.
`kube_job_spec_parallelism`	`specParallelism`	`K8sJobSample`	Gauge: Maximum desired number of pods executing in parallel for the Job.
`kube_job_status_active`	`activePods`	`K8sJobSample`	Gauge: Number of active pods for the Job.
`kube_job_status_completion_time`	`completedAt`	`K8sJobSample`	Gauge: Completion time of the Job.
`kube_job_status_failed`	`failedPods`	`K8sJobSample`	Gauge: Number of failed pods for the Job.
`kube_job_status_start_time`	`startedAt`	`K8sJobSample`	Gauge: Start time of the Job.
`kube_job_status_succeeded`	`succeededPods`	`K8sJobSample`	Gauge: Number of succeeded pods for the Job.
`kube_node_status_allocatable`	`memoryWorkingSetUtilization`	`K8sContainerSample`	Gauge: Allocatable resources of the Node.
`kube_node_status_condition`	`condition.CONDITION_NAME=CONDITION_VALUE`	`K8sNodeSample`	Gauge: Condition of the Node's status.
`kube_persistentvolume_capacity_bytes`	`capacityBytes`	`K8sPersistentVolumeSample`	Gauge: Capacity of the PersistentVolume in bytes.
`kube_persistentvolume_created`	`createdAt`	`K8sPersistentVolumeSample`	Gauge: Creation timestamp of the PersistentVolume.
`kube_persistentvolume_info`		`K8sPersistentVolumeSample`	Gauge: Information about the PersistentVolume.
`kube_persistentvolume_status_phase`	`statusPhase`	`K8sPersistentVolumeSample`	Gauge: Phase of the PersistentVolume.
`kube_persistentvolumeclaim_created`	`createdAt`	`K8sPersistentVolumeSample`	Gauge: Creation timestamp of the PersistentVolumeClaim.
`kube_persistentvolumeclaim_info`	All attributes describing the volume	`K8sPersistentVolumeSample`	Gauge: Information about the PersistentVolumeClaim.
`kube_persistentvolumeclaim_resource_requests_storage_bytes`	`requestedStorageBytes`	`K8sPersistentVolumeClaimSample`	Gauge: Storage resource requests of the PersistentVolumeClaim in bytes.
`kube_persistentvolumeclaim_status_phase`	`statusPhase`	`K8sPersistentVolumeClaimSample`	Gauge: Phase of the PersistentVolumeClaim.
`kube_pod_container_resource_limits`	`cpuLimitCores`, `memoryLimitBytes`	`K8sContainerSample`	Gauge: Resource limits of the Pod container.
`kube_pod_container_resource_requests`	`cpuRequestedCores`, `memoryRequestedBytes`	`K8sContainerSample`	Gauge: Resource requests of the Pod container.
`kube_pod_container_status_phase`	`status`	`K8sContainerSample`	Gauge: Current phase of the Pod container.
`kube_pod_container_status_ready`	`isReady`	`K8sContainerSample`	Gauge: Whether the Pod container is ready `(1)` or not `(0)`.
`kube_pod_container_status_restarts_total`	`restartCount`	`K8sContainerSample`	Counter: Total number of restarts for the Pod container.
`kube_pod_container_status_waiting_reason`	`reason`	`K8sContainerSample`	Gauge: Reason for the container waiting state.
`kube_pod_created`	`createdAt`	`K8sPodSample`	Gauge: Creation timestamp of the Pod.
`kube_pod_info`	All attributes describing the POD	`K8sPodSample`	Gauge: Information about the Pod.
`kube_pod_status_phase`	`status`	`K8sPodSample`	Gauge: Current phase of the Pod status.
`kube_pod_status_ready`	`isReady`	`K8sPodSample`	Gauge: Whether the Pod is ready `(1)` or not `(0)`.
`kube_pod_status_ready_time`	`startTime`	`K8sPodSample`	Gauge: Time when the Pod status became ready.
`kube_pod_status_scheduled`	`isScheduled`	`K8sPodSample`	Gauge: Whether the Pod is scheduled `(1)` or not `(0)`.
`kube_pod_status_scheduled_time`			Gauge: Time when the Pod became scheduled.
`kube_service_annotations`	`selector.ANNOTATIONS`	`K8sServiceSample`	Gauge: Annotations applied to the Service.
`kube_service_created`	`createdAt`	`K8sServiceSample`	Gauge: Creation timestamp of the Service.
`kube_service_info`	All attributes describing the Service	`K8sServiceSample`	Gauge: Information about the Service.
`kube_service_labels`	`label.LABEL_NAME`	`K8sServiceSample`	Gauge: Labels applied to the Service.
`kube_service_spec_type`	`specType`	`K8sServiceSample`	Gauge: Type of the Service specification.
`kube_service_status_load_balancer_ingress`	filter with `WHERE specType = 'LoadBalancer'`	`K8sServiceSample`	Gauge: Status of the load balancer ingress for the Service.
`kube_statefulset_created`	`createdAt`	`K8sStatefulsetSample`	Gauge: Creation timestamp of the StatefulSet.
`kube_statefulset_persistentvolumeclaim_retention_policy`	`filter with WHERE persistent = 'true'`	`K8sVolumeSample`	Gauge: Retention policy of PersistentVolumeClaims for the StatefulSet.
`kube_statefulset_replicas`	`podsDesired`	`K8sStatefulsetSample`	Gauge: Desired number of replicas for the StatefulSet.
`kube_statefulset_status_current_revision`	`currentRevision`	`K8sStatefulsetSample`	Gauge: Current revision of the StatefulSet.
`kube_statefulset_status_replicas`	`podsTotal`	`K8sStatefulsetSample`	Gauge: Number of replicas for the StatefulSet.
`kube_statefulset_status_replicas_available`	`podsTotal - podsCurrent`	`K8sStatefulsetSample`	Gauge: Number of available replicas for the StatefulSet.
`kube_statefulset_status_replicas_current`	`podsCurrent`	`K8sStatefulsetSample`	Gauge: Number of current replicas for the StatefulSet.
`kube_statefulset_status_replicas_ready`	`podsReady`	`K8sStatefulsetSample`	Gauge: Number of ready replicas for the StatefulSet.
`kube_statefulset_status_replicas_updated`	`podsUpdated`	`K8sStatefulsetSample`	Gauge: Number of updated replicas for the StatefulSet.

The table following maps Kubernetes OpenTelemetry metrics to New Relic Kubernetes metrics. These metrics are sourced from the node configured with the HostMetric Receiver:

OTel metric	New Relic Metric	New Relic Event Name	Description
`process.cpu.utilization`	`cpuPercent`	`ProcessSample`	Gauge: CPU utilization of the process as a percentage.
`process.disk.io`	`ioTotalReadCount+ioTotalWriteCount`	`ProcessSample`	Counter: Number of disk I/O operations performed by the process.
`process.memory.usage`	`memoryResidentSizeBytes`	`ProcessSample`	Gauge: Memory usage of the process in bytes.
`process.memory.virtual`	`memoryVirtualSizeBytes`	`ProcessSample`	Gauge: Virtual memory usage of the process in bytes.
`system.cpu.load_average.15m`	`loadAverageFifteenMinute`	`SystemSample`	Gauge: System load average over the last 15 minutes.
`system.cpu.load_average.1m`	`loadAverageOneMinute`	`SystemSample`	Gauge: System load average over the last 1 minute.
`system.cpu.load_average.5m`	`loadAverageFiveMinute`	`SystemSample`	Gauge: System load average over the last 5 minutes.
`system.cpu.utilization`	`cpuPercent`	`SystemSample`	Gauge: Total CPU utilization percentage.
`system.disk.io`	`readBytesPerSecond+writeBytesPerSecond`	`StorageSample`	Counter: Number of disk I/O operations performed.
`system.disk.io_time`	`diskReadsPerSecond+diskWritesPerSecond`	`SystemSample`	Counter: Time spent in disk I/O operations in seconds.
`system.disk.operation_time`	`diskWriteUtilizationPercent`	`SystemSample`	Counter: Total time spent in disk operations in seconds.
`system.disk.operations`	`readIoPerSecond`	`StorageSample`	Counter: Number of disk operations performed.
`system.filesystem.usage`	`diskUsedBytes`	`SystemSample`	Gauge: Usage of filesystem space in bytes.
`system.filesystem.utilization`	`diskUsedPercent`	`SystemSample`	Gauge: Utilization of the filesystem as a percentage.
`system.memory.usage`	`memoryUsedBytes`	`SystemSample`	Gauge: Total memory usage in bytes.
`system.memory.utilization`	`memoryUsedPercent`	`SystemSample`	Gauge: Memory utilization as a percentage.
`system.network.errors`	`transmitErrorsPerSecond`	`NetworkSample`	Counter: Number of network errors.
`system.network.io`	`receiveBytesPerSecond`, `transmitBytesPerSecond`	`NetworkSample`	Counter: Number of network I/O operations.
`system.network.packets`	`transmitPacketsPerSecond+receivePacketsPerSecond`	`NetworkSample`	Counter: Number of network packets transmitted and received.

The table following maps Kubernetes OpenTelemetry metrics to New Relic Kubernetes metrics. These metrics are sourced from the scheduler configured with the Prometheus Receiver:

OTel metric	New Relic Metric	New Relic Event Name	Description
`go_goroutines`	`goGoroutines`	`K8sSchedulerSample`	Gauge: Number of `goroutines` that currently exist.
`process_resident_memory_bytes`	`processResidentMemoryBytes`	`K8sSchedulerSample`	Gauge: Resident memory size in bytes.

preview

For API Server

For cAdvisor

For controller manager

For kubelet

For kube state metrics

For Node

For Scheduler