--- title: New Relic OTel K8s metrics mapping source: https://docs.newrelic.com/docs/kubernetes-pixie/kubernetes-integration/installation/k8s-otel-metrics --- 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. **For API Server** 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. | **For cAdvisor** 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. | **For controller manager** 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. | **For kubelet** 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. | **For kube state metrics** 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_resourcequota` | | K8sResourcequotaSample | **Gauge:** The current usage and hard limit for a resource defined in a ResourceQuota. | | `kube_resourcequota_created` | | K8sResourcequotaSample | **Gauge:** Creation timestamp of the ResourceQuota. | | `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. | **For Node** 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. | **For Scheduler** 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. |