HTTP mit curl debuggen: ausführliche Ausgabe, Zeitaufschlüsselung und erzwungene Verbindung

Ziel

Drei Fragen mit einem einzigen Werkzeug und ohne Browser beantworten: Was hat der Server empfangen und zurückgegeben, wie lange hat jede Phase gedauert, und verhält sich ein bestimmtes Backend gleich wie das, zu dem der Name aufgelöst wird?

Voraussetzungen

curl, die URL sowie alle Header oder Zugangsdaten, die die Anfrage benötigt. Eine sichere Methode für Produktionsziele (-I für HEAD oder GET auf schreibgeschützten Endpunkten).

Schritte

1. Den Dialog sichtbar machen: curl -v URL gibt Anfrage- und Antwort-Header sowie Verbindungsdetails auf stderr aus; --trace-ascii - gibt zusätzlich die Bodys aus, und --trace-time versieht jede Zeile mit einem Zeitstempel. Das Handbuch warnt, dass Traces Zugangsdaten enthalten können, also vor dem Teilen schwärzen.
2. Header vom Body trennen: -D - schreibt die Antwort-Header nach stdout, -o /dev/null verwirft den Body, -sS blendet die Fortschrittsanzeige aus, behält aber Fehlermeldungen bei.
3. Die langsame Phase mit -w (--write-out) lokalisieren. Das Handbuch definiert die Zeitvariablen als Sekunden seit dem Start: time_namelookup (Namensauflösung abgeschlossen), time_connect (TCP verbunden), time_appconnect (TLS-Handshake abgeschlossen), time_pretransfer, time_starttransfer (erstes Byte empfangen, was die Verarbeitungszeit des Servers einschliesst) und time_total. Beispiel: curl -sS -o /dev/null -w 'dns %{time_namelookup} tcp %{time_connect} tls %{time_appconnect} ttfb %{time_starttransfer} total %{time_total} code %{response_code}\n' URL. Für Dauern je Phase benachbarte Werte voneinander abziehen und mehrmals wiederholen, da der erste Durchlauf kalte Caches enthält.
4. Einen bestimmten Server hinter einem Load-Balancer ansprechen oder vor einer DNS-Änderung testen: --resolve host:port:addr liefert die Adresse für diesen Host und Port (das Handbuch nennt es eine /etc/hosts auf der Kommandozeile), sodass SNI, Zertifikatsprüfung und der Host-Header korrekt bleiben. --connect-to HOST1:PORT1:HOST2:PORT2 leitet nur die TCP-Verbindung um und lässt die für TLS und die Anfrage verwendeten Namen unverändert.
5. Fehlschläge in Skripten sichtbar machen: --fail-with-body liefert bei Status 400 und höher den Exit-Code 22 und speichert dabei dennoch den Body (-f verwirft ihn); --max-time begrenzt den gesamten Vorgang; --retry N wiederholt transiente Fehler.
6. Festlegen, was verglichen wird: --http1.1 oder --http2 wählt das Protokoll; --compressed fordert eine komprimierte Antwort mit den von curl unterstützten Algorithmen an und entpackt sie; --json sendet einen JSON-Body mit den passenden Headern.

Erwartetes Ergebnis

Ein reproduzierbarer Befehl, dessen Ausgabe die genaue Anfrage, den Antwortstatus und die Header sowie eine Zeitaufschlüsselung zeigt, die auf DNS, TCP, TLS, Serververarbeitung oder Übertragung hinweist.

Grenzen und Prüfbasis

Die Optionssemantik folgt dem zitierten Handbuch; bei mehreren Optionen ist die curl-Version angegeben, die sie eingeführt hat, daher die installierte Version prüfen. Die Zeiten beschreiben die Sicht eines einzelnen Clients, einschliesslich seines eigenen Resolver-Caches und Netzwerkpfads; es handelt sich nicht um serverseitige Messungen. Es werden keine Zahlen behauptet.