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/k8sclusterreceiver.md.

Kubernetes Cluster Receiver

OpenTelemetry Collector receiver · contrib distribution

The Kubernetes Cluster receiver collects cluster-level metrics and entity events from the Kubernetes API server. It uses the K8s API to listen for updates. A single instance of this receiver should be used to monitor a cluster.

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

Stability

LevelSignals
betametrics
developmentlogs

Attributes

AttributeTypeDescription
conditionstringthe name of Kubernetes Node condition. Example: Ready, Memory, PID, DiskPressure
k8s.container.status.reasonstringThe reason of the current container status.
k8s.container.status.statestringThe state of the container (terminated, running, waiting). See https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#containerstate-v1-core for details.
k8s.namespace.namestringThe k8s namespace name.
k8s.persistentvolume.status.phasestringThe phase of the PersistentVolume.
k8s.persistentvolumeclaim.status.phasestringThe phase of the PersistentVolumeClaim.
k8s.service.endpoint.address_typestringThe address type of the endpoint.
k8s.service.endpoint.conditionstringThe condition of the service endpoint.
k8s.service.endpoint.zonestringThe zone of the service endpoint, typically corresponding to a failure domain.
resourcestringthe name of the resource on which the quota is applied

Data

  • JSON: /data/collector/components/contrib-k8sclusterreceiver/contrib-k8sclusterreceiver-aee88f1d3b4a.json
  • Explore: /collector/components/contrib/k8sclusterreceiver