Logs

Logs im Backend

Die DHL-Logs zeigen technische Anfragen und Antworten der DHL-Schnittstelle und helfen bei der Fehlersuche rund um Labelerstellung und Stornierung.

Inhaltsverzeichnis

Wofuer die Logs genutzt werden

Bei jeder DHL-Kommunikation kann das Backend einen Logeintrag schreiben. Ein Eintrag enthaelt Zeitpunkt, Methode, Ziel, Anfrage, Antwortkopf und Antwortinhalt. Dadurch laesst sich nachvollziehen, ob eine Labelerstellung, Stornierung oder sonstige DHL-Anfrage erfolgreich war oder mit einer DHL-Meldung abgebrochen wurde.

Die Loganzeige maskiert sensible Werte zusaetzlich vor der Ausgabe. Dazu gehoeren unter anderem Autorisierung, API-Schluessel, Tokens, Passwoerter, Cookies und vergleichbare Secrets.

Logdatei auswaehlen

Die Seite nutzt den Daily-Log-Viewer fuer den DHL-Logbereich.

  • Logdatei: Auswahl der vorhandenen DHL-Logdateien. Wenn keine Datei vorhanden ist, zeigt die Auswahl einen entsprechenden Hinweis.
  • Abrufen: Laedt die gewaehlte Logdatei neu und zeigt deren Inhalt an.
  • Standardauswahl: Ohne manuelle Auswahl wird die neueste vorhandene DHL-Logdatei angezeigt.

Die Auswahl enthaelt pro Datei den Dateinamen und die gerundete Groesse in KB. Die Logdateien werden nach Aktualitaet sortiert.

Datei herunterladen: In der Metazeile der ausgewaehlten Logdatei steht zusaetzlich ein Downloadlink. Damit kann die aktuell angezeigte Tagesdatei auf dem eigenen Rechner gespeichert werden, ohne die Loganzeige zu verlassen.

Angezeigte Informationen

Nach dem Abrufen zeigt der Viewer oberhalb des Inhalts drei technische Angaben zur gewaehlten Datei:

  • Ausgewaehlt: Name der aktuell geladenen Logdatei.
  • Geaendert: Zeitpunkt der letzten Aenderung.
  • Groesse: Gerundete Dateigroesse in KB.

Darunter erscheint der Loginhalt in einem scrollbaren Textbereich. Lange Dateien werden nicht vollstaendig geladen, sondern auf die letzten rund 200 KB begrenzt. In diesem Fall steht am Anfang der Anzeige ein Hinweis, dass die Vorschau gekuerzt wurde.

Inhalte eines Logeintrags

  • Zeitpunkt und Methode: Datum, Uhrzeit und technische Methode der Anfrage.
  • Ziel: Der vom HTTP-Client verwendete Zielbezug der Anfrage.
  • Header: Gesendete Header, nach Maskierung sensibler Werte.
  • Request: Nutzdaten, die an DHL uebergeben wurden.
  • ResponseHeader: Antwortkopf der DHL-Kommunikation.
  • Response: Antwortstatus und Antwortdaten. Hier stehen haeufig Validierungsfehler, fehlende Pflichtdaten oder erfolgreiche Rueckgabewerte.
Auch mit Maskierung koennen Logeintraege fachliche Bestell-, Empfaenger- oder Versanddaten enthalten. Logs sollten nur fuer berechtigte technische Pruefungen genutzt werden.

Fehleranalyse

  1. Die neueste Logdatei laden und den Zeitpunkt des fehlgeschlagenen Labelversuchs suchen.
  2. Im Response-Abschnitt nach DHL-Status, Validierungsmeldungen oder fehlenden Eigenschaften suchen.
  3. Bei Nachnahme, Exportdokumenten oder Retouren die zugehoerigen Request-Daten gegen die DHL-Einstellungen und die Bestellung pruefen.
  4. Wenn die Vorschau gekuerzt ist, den Vorgang zeitlich eingrenzen oder eine kleinere Logdatei auswaehlen.

War diese Seite hilfreich?

Hilf uns, das Handbuch weiter zu verbessern. Wenn etwas fehlt oder unverständlich ist, kannst Du direkt einen kurzen Kommentar senden.