DebugReport CRD

The DebugReport custom resource is a diagnostic tool. Customers create a DebugReport resource and the operator populates the status with diagnostic information about the beacon, port, operator, and cluster state.

---

API Details

Field	Value
API Group	api.cloudtaser.io
API Version	v1alpha1
Kind	DebugReport
Short Name	dr
Scope	Namespaced

Create a debug report:

apiVersion: api.cloudtaser.io/v1alpha1
kind: DebugReport
metadata:
  name: debug
  namespace: cloudtaser-system

# Apply the manifest
kubectl apply -f debug-report.yaml

# Check the status
kubectl get dr debug -n cloudtaser-system -o yaml

---

Spec

The DebugReport spec is empty. Create the resource and the operator fills the status subresource.

---

Status Fields

The status is managed by the operator and is read-only.

collectedAt

Type	string (date-time)

Timestamp when the report was generated.

beacon

Type	object

Beacon relay connection state.

Sub-field	Type	Description
address	string	Beacon server address
connected	boolean	Whether the beacon relay is currently connected
initialized	boolean	Whether beacon self-bootstrap has completed
infoHash	string	Operational info hash (truncated for display)
lastError	string	Most recent beacon error, if any

port

Type	object

cloudtaser-port connection state.

Sub-field	Type	Description
connected	boolean	Whether a port connection is active
remoteAddr	string	Remote address of the connected port
lastHeartbeat	string	Timestamp of the last received heartbeat

operator

Type	object

The operator's own state.

Sub-field	Type	Description
version	string	Operator binary version
webhookReady	boolean	Whether the webhook server is serving
secretBackend	string	Configured secret backend (vault or inmemory)
fingerprint	string	Cluster fingerprint (kube-system UID)

cluster

Type	object

Cluster-level information.

Sub-field	Type	Description
kubeVersion	string	Kubernetes server version
nodes	integer	Count of nodes in the cluster

pods

Type	[]object

Lists the operator pods and their states.

Sub-field	Type	Description
name	string	Pod name
ready	boolean	Whether the pod is in Ready condition
restarts	integer	Total container restart count
image	string	Operator container image

errors

Type	[]string

Recent errors collected from the operator.