1. Home
  2. Linux
  3. Docker
  4. Container untersuchen und analysieren

Container untersuchen und analysieren

Lesedauer: 9 Minuten

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

Dem sudo docker inspect Kommando wird der Name des zu untersuchenden Containers übergeben. Dieser Artikel basiert auf einem vorhandenen Nginx-Container 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-FeldBedeutung
IdEindeutige ID der Containerinstanz
NameName des Containers
CreatedZeitpunkt der Containererstellung
State.StatusAktueller Containerzustand, beispielsweise running oder exited
State.PidProzess-ID des Containerhauptprozesses auf dem Host
State.ExitCodeExit-Code des zuletzt beendeten Hauptprozesses
Config.ImageImage-Referenz, mit der der Container erstellt wurde
Config.CmdKonfigurierter Startbefehl
HostConfig.RestartPolicyKonfigurierte automatische Neustartregel
NetworkSettings.NetworksNetzwerkzuordnung, IP-Adressen und weitere Netzwerkinformationen
NetworkSettings.PortsVeröffentlichte Containerports und ihre Host-Zuordnungen
MountsEingebundene 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.

Hinweis: docker logs zeigt nicht zwangsläufig sämtliche Protokolle einer Anwendung. Schreibt diese ausschließlich in eigene Logdateien innerhalb des Containers, erscheinen diese Inhalte nicht automatisch in der Ausgabe. Die Verfügbarkeit der Logs hängt außerdem vom konfigurierten Logging-Treiber ab.

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" "-"

Die Logeinträge dokumentieren eine lokale HTTP-HEAD-Anfrage per curl sowie einen externen HTTP-GET-Aufruf per Webbrowser. Beide Anfragen wurden von nginx erfolgreich mit dem Statuscode 200 beantwortet.

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.

Die angezeigten Prozesse sind reguläre Linux-Prozesse des Hosts. Docker führt sie jedoch innerhalb einer isolierten Containerumgebung aus. Die Prozessnummern innerhalb des Containers können deshalb von den auf dem Host angezeigten IDs abweichen.

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

Obwohl das verwendete nginx-Image auf Alpine Linux basiert, wird die Kernelversion des Debian-13-Hosts angezeigt. Container besitzen somit keinen eigenen Betriebssystemkernel wie klassische virtuelle Maschinen, sondern verwenden den Kernel des Hosts gemeinsam.

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.

Hinweis: Nicht jedes Container-Image enthält eine Shell. Insbesondere minimalistische oder sogenannte distroless Images können ohne /bin/sh ausgeliefert werden. Außerdem hängen die verfügbaren Befehle und Berechtigungen vom jeweiligen Image und der Containerkonfiguration ab.

Befehlszeilenreferenz

Die folgende Übersicht fasst die in dieser Anleitung verwendeten Docker-Befehle zusammen.

BefehlBeschreibung
docker inspect diag-nginx-01Zeigt die vollständigen Inspektionsdaten des Containers im JSON-Format.
docker inspect --format '{{.State.Status}}' diag-nginx-01Gibt den aktuellen Containerzustand aus.
docker inspect --format '{{.Id}}' diag-nginx-01Zeigt die vollständige Container-ID.
docker logs diag-nginx-01Zeigt die verfügbaren Container-Logs.
docker logs --tail 20 diag-nginx-01Zeigt die letzten 20 Logzeilen.
docker logs -f --tail 5 diag-nginx-01Zeigt die letzten fünf Logzeilen und anschließend neue Einträge fortlaufend an.
docker top diag-nginx-01Zeigt die laufenden Containerprozesse mit ihren Host-Prozessnummern.
docker exec diag-nginx-01 psZeigt die Prozessliste aus Sicht des Containers.
docker exec diag-nginx-01 uname -rGibt die gemeinsam verwendete Linux-Kernelversion aus.
docker exec -it diag-nginx-01 /bin/shÖffnet eine interaktive Shell innerhalb des Containers.

Die Befehle können bei entsprechender Berechtigung direkt ausgeführt werden. Andernfalls ist ihnen sudo voranzustellen. Die verwendeten Containernamen beziehen sich auf das Praxisbeispiel und müssen gegebenenfalls angepasst werden.

Innerhalb der interaktiven Container-Shell kann mit cat /etc/os-release die Linux-Distribution der Benutzerlandumgebung ermittelt werden. Mit exit wird die Shell wieder verlassen, ohne den Container zu beenden.

Loading

Updated on 30. Oktober 2026
Was this article helpful?

Related Articles