Logs

Die Hermes-Logs zeigen technische Protokolle zur Kommunikation mit Hermes und helfen bei Fehlern rund um Anmeldung, Labelerstellung und Retouren.

Zweck und Datenbasis

Die Logseite verwendet den allgemeinen Daily-Log-Viewer fuer den Hermes-Logbereich. Angezeigt werden Textdateien mit dem Prefix hermeslog. Der Viewer laedt vorhandene Dateien, bietet eine Dateiauswahl an und zeigt den Inhalt maskiert als Textvorschau.

• Logbereich: Hermes.
• Dateimuster: hermeslog*.txt.
• Aufbewahrung: Standardmaessig 14 Tage im zentralen API-Logmanager.
• Bereinigung: Alte Daily-Logs werden ueber die zentrale Logbereinigung entfernt.

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.

Auswahl und Abrufen

Die Seite enthaelt ein GET-Formular mit Dateiauswahl und Abrufen-Schaltflaeche. Die Hermes-Navigation bleibt ueber versteckte Formularwerte erhalten.

• Logdatei: Auswahlfeld fuer vorhandene Hermes-Logdateien. Jede Option zeigt Dateiname und ungefaehre Groesse in KB.
• Keine Logdatei vorhanden: Platzhalteroption, wenn der Logmanager keine passende Datei findet.
• Abrufen: Laedt die gewaehlte Datei neu und zeigt die aktuelle Vorschau.
• Standardauswahl: Ohne ausgewaehlte Datei verwendet der Viewer die erste gefundene Logdatei. Wird ein unbekannter Dateiname angefordert, faellt der Viewer ebenfalls auf die erste vorhandene Datei zurueck.
• Sicherheitslogik: Der angeforderte Dateiname wird auf den Basisnamen reduziert. Dadurch kann die Auswahl nicht auf beliebige Pfade ausserhalb der gefundenen Logliste zeigen.

Anzeige der Logdatei

Nach dem Abrufen zeigt der Viewer Metadaten und darunter den maskierten Loginhalt in einem scrollbaren Textbereich.

• Ausgewaehlt: Name der aktuell angezeigten Logdatei.
• Geaendert: letzter Aenderungszeitpunkt der Datei.
• Groesse: Dateigroesse gerundet in KB.
• Inhalt: Textvorschau mit maximaler Hoehe, automatischem Scrollen und Zeilenumbruch.
• Grosse Dateien: Bei sehr grossen Logs liest der Viewer nur die letzten rund 200 KB und stellt einen Kuerzungshinweis voran.

Maskierung und sensible Daten

Der Logmanager maskiert Inhalte bereits beim Schreiben und erneut vor der Anzeige. Dadurch sollen Zugangsdaten, Tokens und vergleichbare Secrets nicht im Klartext sichtbar werden.

• Authorization-Header mit Bearer oder Basic werden maskiert.
• API-Keys, Tokens, Client-Secrets, Passwoerter, Signaturen und Codes werden in Querystrings, JSON-Text und Array-Ausgaben maskiert.
• Cookie- und Set-Cookie-Header werden maskiert.
• Die Anzeige bleibt trotzdem ein technisches Fehlerprotokoll und sollte nur fuer berechtigte Backendnutzung verwendet werden.

Welche Hermes-Aktionen Logs schreiben

• Anmeldung: Die Hermes-Klasse protokolliert Anfragen an die OAuth-Anmeldung oder den Refresh-Ablauf. Bei Fehlern werden die Tokenwerte intern geleert, damit spaetere Anfragen neu starten koennen.
• Labelerstellung: Beim Erzeugen eines Versandlabels protokolliert das Backend Anfrage, Header, HTTP-Status und Hermes-Antwort.
• Retourenlabel: Beim Erzeugen eines Retourenlabels wird der gleiche Logmechanismus mit dem Retouren-Endpunkt verwendet.
• Fehlermeldungen: Antworten mit Fehlerfeldern oder Ergebniscode-Liste werden im Log sichtbar und zusaetzlich in der Hermes-Klasse als Fehlertext gesammelt.

Einordnung bei Fehlern

1. Nach einem fehlgeschlagenen Hermes-Vorgang die neueste Logdatei abrufen.
2. Den passenden Zeitpunkt, die Methode, den Request-Block, den ResponseHeader und den Response-Block suchen.
3. Bei Anmeldefehlern auf Fehlerfelder und Token-Refresh-Hinweise achten.
4. Bei Label- oder Retourenfehlern Hermes-Ergebniscodes, HTTP-Status und fehlende Sendungsnummer pruefen.
5. Wenn kein Eintrag vorhanden ist, zuerst Hermes-App, Rechte, Labeldruck-Aktivierung und Transportdienst der Versandart pruefen.