This documentation has an index for AI agents at /llms.txt. A Markdown version of this page is available at https://explorer.opentelemetry.io/collector/components/contrib/kubeletstatsreceiver.md.

Kubelet Stats Receiver

OpenTelemetry Collector receiver · contrib distribution

The Kubelet Stats Receiver pulls node, pod, container, and volume metrics from the API server on a kubelet and sends it down the metric pipeline for further processing.

  • Component ID: contrib-kubeletstatsreceiver
  • Name: kubeletstatsreceiver
  • Type: receiver
  • Distribution: contrib
  • Repository: opentelemetry-collector-contrib

Stability

LevelSignals
betametrics

Metrics

MetricTypeValue typeUnitStabilityEnabledAttributesDescription
container.cpu.timesum (monotonic)doublesdevelopmentyesTotal cumulative CPU time (sum of all cores) spent by the container/pod/node since its creation
container.cpu.usagegaugedouble{cpu}developmentyesTotal CPU usage (sum of all cores per second) averaged over the sample window
container.filesystem.availablegaugeintBydevelopmentyesContainer filesystem available
container.filesystem.capacitygaugeintBydevelopmentyesContainer filesystem capacity
container.filesystem.usagegaugeintBydevelopmentyesContainer filesystem usage
container.memory.availablegaugeintBydevelopmentyesContainer memory available
container.memory.major_page_faultsgaugeint1developmentyesContainer memory major_page_faults
container.memory.page_faultsgaugeint1developmentyesContainer memory page_faults
container.memory.rssgaugeintBydevelopmentyesContainer memory rss
container.memory.usagegaugeintBydevelopmentyesContainer memory usage
container.memory.working_setgaugeintBydevelopmentyesContainer memory working_set
container.uptimesum (monotonic)intsdevelopmentnoThe time since the container started
k8s.container.cpu.node.utilizationgaugedouble1developmentnoContainer cpu utilization as a ratio of the node's capacity
k8s.container.cpu_limit_utilizationgaugedouble1developmentnoContainer cpu utilization as a ratio of the container's limits
k8s.container.cpu_request_utilizationgaugedouble1developmentnoContainer cpu utilization as a ratio of the container's requests
k8s.container.ephemeral_storage.usagesumintBydevelopmentnofs.type (string)Ephemeral storage used by the container.
k8s.container.memory.node.utilizationgaugedouble1developmentnoContainer memory utilization as a ratio of the node's capacity
k8s.container.memory_limit_utilizationgaugedouble1developmentnoContainer memory utilization as a ratio of the container's limits
k8s.container.memory_request_utilizationgaugedouble1developmentnoContainer memory utilization as a ratio of the container's requests
k8s.node.cpu.timesum (monotonic)doublesdevelopmentyesTotal cumulative CPU time (sum of all cores) spent by the container/pod/node since its creation
k8s.node.cpu.usagegaugedouble{cpu}developmentyesTotal CPU usage (sum of all cores per second) averaged over the sample window
k8s.node.filesystem.availablegaugeintBydevelopmentyesNode filesystem available
k8s.node.filesystem.capacitygaugeintBydevelopmentyesNode filesystem capacity
k8s.node.filesystem.inode.countsumint{inode}developmentnoTotal number of inodes in the node's root filesystem.
k8s.node.filesystem.inode.freesumint{inode}developmentnoNumber of free inodes in the node's root filesystem.
k8s.node.filesystem.usagegaugeintBydevelopmentyesNode filesystem usage
k8s.node.memory.availablegaugeintBydevelopmentyesNode memory available
k8s.node.memory.major_page_faultsgaugeint1developmentyesNode memory major_page_faults
k8s.node.memory.page_faultsgaugeint1developmentyesNode memory page_faults
k8s.node.memory.rssgaugeintBydevelopmentyesNode memory rss
k8s.node.memory.usagegaugeintBydevelopmentyesNode memory usage
k8s.node.memory.working_setgaugeintBydevelopmentyesNode memory working_set
k8s.node.network.errorssum (monotonic)int1developmentyesdirection (string), interface (string)Node network errors
k8s.node.network.iosum (monotonic)intBydevelopmentyesdirection (string), interface (string)Node network IO
k8s.node.system_container.cpu.timesum (monotonic)doublesdevelopmentnoTotal cumulative CPU time (sum of all cores) spent by the system container since its creation
k8s.node.system_container.cpu.usagegaugedouble{cpu}developmentnoTotal CPU usage (sum of all cores per second) averaged over the sample window for the system container
k8s.node.system_container.memory.usagegaugeintBydevelopmentnoSystem container memory usage
k8s.node.system_container.memory.working_setgaugeintBydevelopmentnoSystem container memory working_set
k8s.node.uptimesum (monotonic)intsdevelopmentnoThe time since the node started
k8s.pod.cpu.node.utilizationgaugedouble1developmentnoPod cpu utilization as a ratio of the node's capacity
k8s.pod.cpu.timesum (monotonic)doublesdevelopmentyesTotal cumulative CPU time (sum of all cores) spent by the container/pod/node since its creation
k8s.pod.cpu.usagegaugedouble{cpu}developmentyesTotal CPU usage (sum of all cores per second) averaged over the sample window
k8s.pod.cpu_limit_utilizationgaugedouble1developmentnoPod cpu utilization as a ratio of the pod's total container limits. If any container is missing a limit the metric is not emitted.
k8s.pod.cpu_request_utilizationgaugedouble1developmentnoPod cpu utilization as a ratio of the pod's total container requests. If any container is missing a request the metric is not emitted.
k8s.pod.filesystem.availablegaugeintBydevelopmentyesPod filesystem available
k8s.pod.filesystem.capacitygaugeintBydevelopmentyesPod filesystem capacity
k8s.pod.filesystem.usagegaugeintBydevelopmentyesPod filesystem usage
k8s.pod.memory.availablegaugeintBydevelopmentyesPod memory available
k8s.pod.memory.major_page_faultsgaugeint1developmentyesPod memory major_page_faults
k8s.pod.memory.node.utilizationgaugedouble1developmentnoPod memory utilization as a ratio of the node's capacity
k8s.pod.memory.page_faultsgaugeint1developmentyesPod memory page_faults
k8s.pod.memory.rssgaugeintBydevelopmentyesPod memory rss
k8s.pod.memory.usagegaugeintBydevelopmentyesPod memory usage
k8s.pod.memory.working_setgaugeintBydevelopmentyesPod memory working_set
k8s.pod.memory_limit_utilizationgaugedouble1developmentnoPod memory utilization as a ratio of the pod's total container limits. If any container is missing a limit the metric is not emitted.
k8s.pod.memory_request_utilizationgaugedouble1developmentnoPod memory utilization as a ratio of the pod's total container requests. If any container is missing a request the metric is not emitted.
k8s.pod.network.errorssum (monotonic)int1developmentyesdirection (string), interface (string)Pod network errors
k8s.pod.network.iosum (monotonic)intBydevelopmentyesdirection (string), interface (string)Pod network IO
k8s.pod.uptimesum (monotonic)intsdevelopmentnoThe time since the pod started
k8s.pod.volume.usagesumintBydevelopmentnoThe number of used bytes in the pod volume.
k8s.volume.availablegaugeintBydevelopmentyesThe number of available bytes in the volume.
k8s.volume.capacitygaugeintBydevelopmentyesThe total capacity in bytes of the volume.
k8s.volume.inodesgaugeint1developmentyesThe total inodes in the filesystem.
k8s.volume.inodes.freegaugeint1developmentyesThe free inodes in the filesystem.
k8s.volume.inodes.usedgaugeint1developmentyesThe inodes used by the filesystem. This may not equal inodes - free because filesystem may share inodes with other filesystems.

Attributes

AttributeTypeDescription
directionstringDirection of flow of bytes/operations (receive or transmit).
fs.typestringThe type of filesystem component.
interfacestringName of the network interface.

Data

  • JSON (latest): /data/collector/components/contrib-kubeletstatsreceiver/latest.json
  • JSON (pinned): /data/collector/components/contrib-kubeletstatsreceiver/contrib-kubeletstatsreceiver-c3bd150e73d3.json
  • Explore: /collector/components/contrib/kubeletstatsreceiver