Docker stellt verschiedene Werkzeuge bereit, um die Konfiguration, den Zustand und das Laufzeitverhalten von Containern zu untersuchen. Damit lassen sich beispielsweise Startprobleme analysieren, Logmeldungen auswerten, laufende Prozesse identifizieren und Informationen über die Containerumgebung abrufen.
Die folgenden Abschnitte behandeln grundlegende Diagnosemöglichkeiten am Beispiel eines nginx-Containers. Die Erstellung und allgemeine Verwaltung von Containern wird als bekannt vorausgesetzt.
Containerkonfiguration und Zustand untersuchen
Mit docker inspect lassen sich detaillierte Informationen über einen Container abrufen. Dazu gehören unter anderem die Container-ID, das verwendete Image, der aktuelle Zustand, die Prozessinformationen, die Netzwerkkonfiguration und eingebundene Datenträger.
$ sudo docker inspect diag-nginx-01
Die Ausgabe erfolgt im JSON-Format und enthält sämtliche von Docker bereitgestellten Inspektionsdaten des Containers. Da diese sehr umfangreich sein können, lassen sich einzelne Eigenschaften gezielt abfragen.
Hierzu dient die Option --format, mit der über einen Go-Template-Ausdruck auf bestimmte Felder zugegriffen werden kann.
Beispielsweise lässt sich der aktuelle Containerzustand abfragen:
$ sudo docker inspect --format '{{.State.Status}}' diag-nginx-01
running
Der Ausdruck .State.Status greift auf das Feld Status innerhalb des Objekts State zu. Ein laufender Container liefert den Wert running, ein gestoppter Container normalerweise exited.
Ebenso lässt sich die vollständige Container-ID ermitteln:
$ sudo docker inspect --format '{{.Id}}' diag-nginx-01
ba04c9638cd3ec3bc3aac04228ceac3a32a4c1d924a6d5ea4431b7987549fdf
Zusammenfassung der wichtigsten JSON-Felder:
| JSON-Feld | Bedeutung |
|---|---|
Id | Eindeutige ID der Containerinstanz |
Name | Name des Containers |
Created | Zeitpunkt der Containererstellung |
State.Status | Aktueller Containerzustand, beispielsweise running oder exited |
State.Pid | Prozess-ID des Containerhauptprozesses auf dem Host |
State.ExitCode | Exit-Code des zuletzt beendeten Hauptprozesses |
Config.Image | Image-Referenz, mit der der Container erstellt wurde |
Config.Cmd | Konfigurierter Startbefehl |
HostConfig.RestartPolicy | Konfigurierte automatische Neustartregel |
NetworkSettings.Networks | Netzwerkzuordnung, IP-Adressen und weitere Netzwerkinformationen |
NetworkSettings.Ports | Veröffentlichte Containerports und ihre Host-Zuordnungen |
Mounts | Eingebundene Volumes und Bind Mounts |
Container-Logs auswerten
Mit docker logs lassen sich die vom Docker-Logging-Treiber erfassten Ausgaben eines Containers anzeigen. Dazu gehören insbesondere Meldungen der Anwendung, die über die Standardausgabe (stdout) und die Fehlerausgabe (stderr) ausgegeben werden.
$ sudo docker logs diag-nginx-01
Standardmäßig werden alle verfügbaren Logeinträge des Containers ausgegeben. Bei umfangreichen Logs kann die Ausgabe auf die letzten Zeilen begrenzt werden:
$ sudo docker logs --tail 20 diag-nginx-01
2026/10/25 16:52:50 [notice] 1#1: worker process 34 exited with code 0
2026/10/25 16:52:50 [notice] 1#1: exit
---snip---
/docker-entrypoint.sh: Configuration complete; ready for start up
---snap---
2026/10/25 16:53:45 [notice] 1#1: nginx/1.30.6
2026/10/25 16:53:45 [notice] 1#1: OS: Linux 6.12.113+deb13-amd64
2026/10/25 16:53:45 [notice] 1#1: start worker processes
2026/10/25 16:53:45 [notice] 1#1: start worker process 22
2026/10/25 16:53:45 [notice] 1#1: start worker process 23
2026/10/25 16:53:45 [notice] 1#1: start worker process 24
2026/10/25 16:53:45 [notice] 1#1: start worker process 25
Die Ausgabe zeigt die Beendigung des nginx-Hauptprozesses sowie die Initialisierung und den anschließenden Start des Webservers. Die Startmeldung nennt außerdem die verwendete nginx-Version.
Für die laufende Beobachtung können neue Logeinträge mit der Option -f (follow) fortlaufend angezeigt werden:
$ sudo docker logs -f --tail 20 diag-nginx-01
Die Ausgabe läuft weiter, bis sie beispielsweise mit Strg+C beendet wird. Der Container selbst bleibt dabei in Betrieb.
Die erfassten Logs bleiben bei einem einfachen Container-Neustart erhalten. Wird der Container entfernt, gehen auch seine von Docker verwalteten Containerlogs normalerweise verloren. Für eine dauerhafte Protokollierung ist daher eine geeignete externe Logspeicherung erforderlich.
Logausgaben in Echtzeit verfolgen
Mit der Option -f (follow) bleibt die Logausgabe geöffnet und zeigt neue Einträge fortlaufend an. Die Kombination mit --tail begrenzt die anfänglich ausgegebenen Einträge.
$ sudo docker logs -f --tail 5 diag-nginx-01
2026/10/25 16:53:45 [notice] 1#1: start worker process 23
2026/10/25 16:53:45 [notice] 1#1: start worker process 24
2026/10/25 16:53:45 [notice] 1#1: start worker process 25
172.17.0.1 - - [25/Oct/2026:18:19:27 +0000] "HEAD / HTTP/1.1" 200 0 "-" "curl/8.14.1" "-"
192.168.178.35 - - [25/Oct/2026:18:20:28 +0000] "GET / HTTP/1.1" 200 896 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.6 Safari/605.1.15" "-"
Der Eintrag dokumentiert eine HTTP-HEAD-Anfrage, die nginx erfolgreich mit dem Statuscode 200 beantwortet hat.
Die fortlaufende Anzeige lässt sich mit Strg+C beenden, ohne den Container zu stoppen. Diese Funktion eignet sich insbesondere dazu, Anwendungsfehler während eines Tests unmittelbar zu beobachten.
Laufende Prozesse eines Containers anzeigen
Mit docker top lassen sich die aktuell laufenden Prozesse eines Containers anzeigen. Der Befehl liefert Informationen über Prozess-IDs, Benutzer, übergeordnete Prozesse und ausgeführte Programme.
$ sudo docker top diag-nginx-01
UID PID PPID C STIME TTY TIME CMD
root 3692 3668 0 17:53 ? 00:00:00 nginx: master process nginx -g daemon off;
101 3760 3692 0 17:53 ? 00:00:00 nginx: worker process
101 3761 3692 0 17:53 ? 00:00:00 nginx: worker process
101 3762 3692 0 17:53 ? 00:00:00 nginx: worker process
101 3763 3692 0 17:53 ? 00:00:00 nginx: worker process
Die Ausgabe zeigt den nginx-Hauptprozess (Master) und vier untergeordnete Worker-Prozesse. Die Spalte PID enthält die Prozess-ID auf dem Docker-Host, während PPID (Parent Process ID) die ID des jeweiligen übergeordneten Prozesses bezeichnet.
Der Masterprozess läuft unter root, die Worker-Prozesse dagegen unter der Benutzer-ID 101. Alle vier Worker besitzen die PPID 3692 und wurden somit vom nginx-Masterprozess gestartet.
docker top ermöglicht damit eine einfache Kontrolle der laufenden Prozesse, ohne zusätzliche Werkzeuge innerhalb des Containers installieren oder ausführen zu müssen.
Befehle innerhalb eines Containers ausführen
Mit docker exec lassen sich zusätzliche Prozesse innerhalb eines bereits laufenden Containers starten. Das ermöglicht beispielsweise die Untersuchung von Prozessen, Dateien und Konfigurationen, ohne den Container neu zu starten.
Im folgenden Beispiel wird mit ps die Prozessliste innerhalb des nginx-Containers angezeigt:
$ sudo docker exec diag-nginx-01 ps
PID USER TIME COMMAND
1 root 0:00 nginx: master process nginx -g daemon off;
22 nginx 0:00 nginx: worker process
23 nginx 0:00 nginx: worker process
24 nginx 0:00 nginx: worker process
25 nginx 0:00 nginx: worker process
38 root 0:00 ps
Im Unterschied zu docker top zeigt ps hier die Prozessnummern aus Sicht des Containers an. Der nginx-Masterprozess besitzt die PID 1, obwohl derselbe Prozess auf dem Docker-Host die PID 3692 hatte.
Ursache dafür sind Linux-PID-Namespaces, die Containern eine eigene Sicht auf die Prozessverwaltung ermöglichen. Ein Prozess kann daher innerhalb und außerhalb des Containers unterschiedliche Prozessnummern besitzen.
Der zusätzliche Prozess mit der PID 38 wurde durch docker exec gestartet. Nach Abschluss von ps wird dieser Prozess wieder beendet, während nginx unverändert weiterläuft.
Gemeinsamer Linux-Kernel
Container verwenden den Linux-Kernel des Hosts. Dies lässt sich mit folgendem Befehl überprüfen:
$ sudo docker exec diag-nginx-01 uname -r
6.12.113+deb13-amd64
Interaktive Shell innerhalb eines Containers öffnen
Mit docker exec lässt sich auch eine interaktive Shell innerhalb eines laufenden Containers starten. Dadurch können Dateien, Konfigurationen und die Systemumgebung direkt untersucht werden. Nach dem Aufruf erscheint die Eingabeaufforderung des Containers: / #
$ sudo docker exec -it diag-nginx-01 /bin/sh
/ #
Die Option -i hält die Standardeingabe geöffnet, während -t ein Pseudoterminal bereitstellt. /bin/sh startet eine Shell innerhalb des Containers.
Die Linux-Distribution innerhalb des Containers lässt sich über /etc/os-release ermitteln:
/ # cat /etc/os-release
NAME="Alpine Linux"
ID=alpine
VERSION_ID=3.24.3
PRETTY_NAME="Alpine Linux v3.24"
HOME_URL="https://alpinelinux.org/"
BUG_REPORT_URL="https://gitlab.alpinelinux.org/alpine/aports/-/issues"
Während der Docker-Host Debian 13 verwendet, stammt die Benutzerlandumgebung des Containers aus Alpine Linux. Beide Systeme verwenden denselben Linux-Kernel. Mit exit wird die interaktive Shell wieder verlassen. Der Container und sein Hauptprozess laufen dabei unverändert weiter.
Befehlszeilenreferenz
Die folgende Übersicht fasst die in dieser Anleitung verwendeten Docker-Befehle zusammen.
| Befehl | Beschreibung |
|---|---|
docker inspect diag-nginx-01 | Zeigt die vollständigen Inspektionsdaten des Containers im JSON-Format. |
docker inspect --format '{{.State.Status}}' diag-nginx-01 | Gibt den aktuellen Containerzustand aus. |
docker inspect --format '{{.Id}}' diag-nginx-01 | Zeigt die vollständige Container-ID. |
docker logs diag-nginx-01 | Zeigt die verfügbaren Container-Logs. |
docker logs --tail 20 diag-nginx-01 | Zeigt die letzten 20 Logzeilen. |
docker logs -f --tail 5 diag-nginx-01 | Zeigt die letzten fünf Logzeilen und anschließend neue Einträge fortlaufend an. |
docker top diag-nginx-01 | Zeigt die laufenden Containerprozesse mit ihren Host-Prozessnummern. |
docker exec diag-nginx-01 ps | Zeigt die Prozessliste aus Sicht des Containers. |
docker exec diag-nginx-01 uname -r | Gibt die gemeinsam verwendete Linux-Kernelversion aus. |
docker exec -it diag-nginx-01 /bin/sh | Öffnet eine interaktive Shell innerhalb des Containers. |
![]()