Logs

Logs im Backend

Die BJS-Logs zeigen technische Tagesprotokolle der Bertram-Juwelier-Service-Schnittstelle. Die Protokolle helfen beim Pruefen von Versandarten, Abholzeitfenstern, Labelerzeugung und Stornierungen.

Inhaltsverzeichnis

Logbereich und Dateien

Der Logviewer ist fest auf den Bereich bjslog eingestellt. Das Backend sucht Tagesdateien mit diesem Prefix und der Dateiendung txt. Die neueste passende Datei wird automatisch vorausgewaehlt.

Die allgemeine Aufbewahrung fuer diese Tageslogs betraegt vierzehn Tage, sofern kein spezieller Wert fuer einen Logbereich gesetzt ist. Alte Dateien werden beim Log-Cleanup anhand von Prefix, Dateiendung und Alter entfernt.

Wenn noch keine BJS-Logdatei vorhanden ist, zeigt die Seite statt der Vorschau eine Meldung. Das ist normal, solange noch kein BJS-API-Aufruf protokolliert wurde.

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 Abrufen

  • Logdatei: Auswahl der verfuegbaren BJS-Logdateien. Jede Option zeigt Dateiname und gerundete Groesse.
  • Abrufen: laedt die gewaehlte Datei und haelt die Navigation ueber versteckte Werte im BJS-Reiter Logs.

Die Dateiauswahl wird serverseitig gegen die gefundenen Logdateien geprueft. Wenn keine gueltige Auswahl vorhanden ist, nutzt der Viewer die neueste Datei.

Vorschau und Metadaten

Oberhalb der Vorschau stehen ausgewaehlter Dateiname, letzter Aenderungszeitpunkt und gerundete Dateigroesse. Der Inhalt wird in einem scrollbaren Textbereich angezeigt.

Bei grossen Dateien zeigt der Viewer nur den letzten Abschnitt der Datei und kennzeichnet die gekuerzte Anzeige. So bleibt die Seite auch bei vielen BJS-Aufrufen bedienbar.

Maskierung und typische Inhalte

BJS schreibt Logeintraege beim Abrufen der Versandarten, beim Abrufen von Abholzeitfenstern, beim Erstellen von Sendungen und beim Stornieren von Sendungen. Ein Eintrag enthaelt Methode, Ziel, Requestdaten, Response-Header, HTTP-Status und Response-Inhalt.

Vor der Anzeige maskiert das Backend sensible Werte wie Autorisierungsheader, API-Keys, Token, Passwortfelder, Secrets, Cookies und vergleichbare Zugangsdaten.

Logs koennen fachliche Bestell- und Versanddaten enthalten. Fuer Supportfaelle sollten nur die notwendigen 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.