---
title: "K8s: Cluster"
slug: "k8s-cluster"
updated: 2026-07-09T12:03:04Z
published: 2026-07-09T12:03:04Z
canonical: "resources.realtheory.io/k8s-cluster"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://resources.realtheory.io/llms.txt
> Use this file to discover all available pages before exploring further.

# K8s: Cluster

This model describes information about a Cluster and includes an object describing the cluster's version, endpoint, labels, and services.

#### Example:

```
{
    "metadata": {
        "id": "f99e055f-b35d-208b-63b1-f4222b80151a",
        "name": "realtheory-cluster-01",
        "timestamp": "2024-07-17T20:15:15.333644Z"
    },
    "object": {
        "version": "v1.27.13",
        "url": "https://10.222.0.1:443/api/v1",
        "labels": {
            "environment": "production"
        },
        "services": {
            "prometheus": "http://prometheus.monitoring.svc:9090"
        }
    }
}
```

where:

- **metadata**
  - `id`: Represents the ID of the cluster.
  - `name`: Represents the name of the cluster.
  - `timestamp`: Represents the timestamp of the record.
- **object**
  - `version`: Represents the version of the cluster.
  - `url`: Represents the URL of the cluster's API server.
  - `labels`: Represents the labels associated with the cluster, as a set of key/value pairs.
  - `services`: Represents the services associated with the cluster, as a set of key/value pairs.