Zum Inhalt

kubectl describe

Zeigt ein Objekt im Detail, gut lesbar und mit den letzten Ereignissen.

kubectl-describe output

Syntax

kubectl describe TYP NAME [-n NAMESPACE]

Optionen

Option Beschreibung
TYP NAME Etwa pod web-9bc5f7f5b-8ptw2, deploy web oder node tuxdex-srv
TYP/NAME Dasselbe in einem Wort geschrieben
-n NAMESPACE Namespace des Objekts
-l LABEL=WERT Alle Objekte mit diesem Label beschreiben

Beispiele

Warum startet der Pod nicht? Die Events am Ende:

kubectl describe pod broken -n status | tail -7
  Type     Reason     Age   From               Message
  ----     ------     ----  ----               -------
  Normal   Scheduled  15s   default-scheduler  Successfully assigned status/broken to tuxdex-srv
  Normal   Pulling    14s   kubelet            Pulling image "nginx:9.99"
  Warning  Failed     14s   kubelet            Failed to pull image "nginx:9.99": rpc error: code = NotFound desc = failed to pull and unpack image "docker.io/library/nginx:9.99": failed to resolve reference "docker.io/library/nginx:9.99": docker.io/library/nginx:9.99: not found
  Warning  Failed     14s   kubelet            Error: ErrImagePull
  Warning  Failed     13s   kubelet            Error: ImagePullBackOff

Die Details eines laufenden Pods:

kubectl describe pod web-9bc5f7f5b-8ptw2 -n status | head -32
Name:             web-9bc5f7f5b-8ptw2
Namespace:        status
Priority:         0
Service Account:  default
Node:             tuxdex-srv/192.0.2.10
Start Time:       Mon, 26 Oct 2026 08:41:13 +0100
Labels:           app=web
                  pod-template-hash=9bc5f7f5b
Annotations:      <none>
Status:           Running
IP:               10.42.0.9
IPs:
  IP:           10.42.0.9
Controlled By:  ReplicaSet/web-9bc5f7f5b
Containers:
  nginx:
    Container ID:   containerd://8766fd32b309448bd25f9ef07d6576cd2ed7977cc53b04e7f8345a0adcea261a
    Image:          nginx:1.28
    Image ID:       docker.io/library/nginx@sha256:146adea4768b83c607d0bdfa4188464e3da6e0a3ad4475db1d1d8f64f27c29cc
    Port:           80/TCP
    Host Port:      0/TCP
    State:          Running
      Started:      Mon, 26 Oct 2026 08:41:20 +0100
    Ready:          True
    Restart Count:  0
    Limits:
      memory:  128Mi
    Requests:
      cpu:        50m
      memory:     32Mi
    Environment:  <none>
    Mounts:
      /var/run/secrets/kubernetes.io/serviceaccount from kube-api-access-bzr2s (ro)

Reservierte Ressourcen eines Nodes:

kubectl describe node tuxdex-srv | grep -A 7 'Allocated resources'
Allocated resources:
  (Total limits may be over 100 percent, i.e., overcommitted.)
  Resource           Requests    Limits
  --------           --------    ------
  cpu                300m (15%)  0 (0%)
  memory             204Mi (5%)  426Mi (11%)
  ephemeral-storage  0 (0%)      0 (0%)
  hugepages-1Gi      0 (0%)      0 (0%)

Wann brauche ich das?

  • Wenn ein Pod in Pending, ContainerCreating oder ImagePullBackOff hängt
  • Um zu sehen, welches Image, welche Ressourcen und Volumes ein Pod tatsächlich hat
  • Um zu prüfen, wie viel CPU und Speicher auf einem Node reserviert ist

Zuerst die Events lesen

Der Abschnitt Events am Ende beantwortet meist die Frage: Image nicht gefunden, zu wenig Speicher auf dem Node, ein Volume, das sich nicht einhängen lässt.

Verwandte Befehle

kubectl get · kubectl events · kubectl logs · kubectl top