Logs

Logs im Backend

DG-Transporte Logs enthalten technische Tagesprotokolle der Schnittstellenaufrufe. Die Protokolle helfen beim Prüfen von Labelbuchungen, Schnittstellenantworten und Fehlern im Versandprozess.

Inhaltsverzeichnis

Aufgabe der Seite

Die Logseite nutzt den allgemeinen Daily-Log-Viewer für den Logbereich DG Transporte. Der Viewer zeigt vorhandene Tagesdateien, erlaubt die Auswahl einer Datei und rendert eine maskierte Vorschau.

  • Logbereich: Die Seite ist fest auf DG-Transporte-Logs eingestellt.
  • Dateityp: Berücksichtigt werden Textdateien mit dem DG-Transporte-Logprefix.
  • Voraussetzung: Logdateien entstehen erst, wenn DG-Transporte-API-Aufrufe protokolliert wurden.
  • Keine Bearbeitung: Die Seite ändert keine Logeinträge, startet keine Labelbuchung und löscht keine Logdatei.

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.

Formular und Auswahl

Das Formular besteht aus der Dateiauswahl und dem Button Abrufen. Versteckte Formularwerte halten die Navigation im DG-Transporte-Reiter.

  • Logdatei: Auswahl der verfügbaren DG-Transporte-Logdateien. Jede Option zeigt Dateiname und gerundete Größe.
  • Keine Logdatei vorhanden: Wird angezeigt, wenn der Logbereich noch keine passende Datei enthält.
  • Abrufen: Lädt die gewählte Datei erneut und zeigt deren Vorschau.
  • Sicherheitslogik: Der ausgewählte Dateiname wird serverseitig auf den Basenamen reduziert und anschließend nur gegen gefundene Logdateien aus dem definierten Bereich abgeglichen.

Metadaten und Vorschau

Nach der Auswahl zeigt der Viewer eine kurze Metadatenzeile und darunter die Logvorschau.

  • Ausgewählt: Zeigt den Namen der aktuell geöffneten Logdatei.
  • Geändert: Zeigt den letzten Änderungszeitpunkt der Datei.
  • Größe: Zeigt die gerundete Dateigröße in Kilobyte.
  • Vorschau: Wird in einem scrollbaren Textbereich angezeigt und bewahrt Zeilenumbrüche.
  • Große Dateien: Bei sehr großen Dateien liest der Viewer nur den letzten Teil und kennzeichnet die gekürzte Anzeige.

Maskierung sensibler Werte

Vor der Anzeige maskiert das Backend sensible Werte im Loginhalt. Dadurch können Logs im Backend geprüft werden, ohne Zugangsdaten unnötig offenzulegen.

  • Autorisierung: Bearer- und Basic-Autorisierungswerte werden maskiert.
  • API-Schlüssel und Tokens: API-Key-, Token-, Secret-, Signatur- und Code-Werte werden in Querystrings, JSON und Array-Ausgaben maskiert.
  • Passwörter: Passwortfelder werden maskiert.
  • Cookies: Cookie- und Set-Cookie-Header werden maskiert.

Herkunft der Einträge

Die Einträge entstehen bei der DG-Transporte-Labelbuchung. Nach dem Login und der Buchungsanfrage schreibt das Backend einen Tageslogeintrag.

  • Methode und Ziel: Der Logeintrag enthält die verwendete Methode und die technische Zielinformation der Anfrage.
  • Header: Gesendete und empfangene Header werden protokolliert, soweit der Schnittstellenclient diese Daten bereitstellt.
  • Request: Enthält die übergebenen Buchungsdaten, vor der Anzeige mit Maskierung.
  • Response: Enthält Antwortdaten und gegebenenfalls HTTP-Statusinformationen.
Die Maskierung reduziert das Risiko beim Prüfen von Logs, ersetzt aber keine fachliche Fehleranalyse. Für Supportfälle sollten nur die nötigen Ausschnitte weitergegeben werden.

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.