# Kubernetes Cluster Receiver

<!-- llms-txt-link: /llms.txt -->

> 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

| Level | Signals |
| --- | --- |
| beta | metrics |
| development | logs |

## Attributes

| Attribute | Type | Description |
| --- | --- | --- |
| `condition` | string | the name of Kubernetes Node condition. Example: Ready, Memory, PID, DiskPressure |
| `k8s.container.status.reason` | string | The reason of the current container status. |
| `k8s.container.status.state` | string | The 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.name` | string | The k8s namespace name. |
| `k8s.persistentvolume.status.phase` | string | The phase of the PersistentVolume. |
| `k8s.persistentvolumeclaim.status.phase` | string | The phase of the PersistentVolumeClaim. |
| `k8s.service.endpoint.address_type` | string | The address type of the endpoint. |
| `k8s.service.endpoint.condition` | string | The condition of the service endpoint. |
| `k8s.service.endpoint.zone` | string | The zone of the service endpoint, typically corresponding to a failure domain. |
| `resource` | string | the name of the resource on which the quota is applied |

## Data

- **JSON**: [/data/collector/components/contrib-k8sclusterreceiver/contrib-k8sclusterreceiver-aee88f1d3b4a.json](/data/collector/components/contrib-k8sclusterreceiver/contrib-k8sclusterreceiver-aee88f1d3b4a.json)
- **Explore**: [/collector/components/contrib/k8sclusterreceiver](/collector/components/contrib/k8sclusterreceiver)