Logs

Im Bereich Logs prüfst du die Amazon-SP-API-Protokolle, wenn Verbindung, Autorisierung, Bestellimport, Berichte oder Feed-Rückmeldungen nachvollzogen werden sollen.

Inhaltsverzeichnis
Die Loganzeige ist ein Analysewerkzeug. Einstellungen, Importschritte, Produktzuordnungen und Feed-Aktionen werden auf den passenden Amazon-Unterseiten gesteuert.

Wann die Logs helfen

Die Seite sammelt die technischen Rückmeldungen der Amazon-SP-API in Tagesdateien. Diese Übersicht ist besonders hilfreich, wenn ein Prozess zwar gestartet wurde, das Ergebnis im Backend aber nicht eindeutig ist.

  • Verbindung und Autorisierung: Prüfe, ob Token-Abruf, Signatur, Anfrage und Antwort plausibel zusammenpassen.
  • Bestellimport: Nutze die Antworten, um leere Importläufe, abgelehnte Anfragen oder unerwartete Statuswerte einzuordnen.
  • Berichte: Kontrolliere, ob Berichtsanforderungen erstellt, abgefragt und zurückgemeldet wurden.
  • Feeds: Vergleiche Feed-Anfragen und Antworten, wenn Bestands- oder Preisupdates nicht wie erwartet ankommen.
  • Fehleranalyse: Lies HTTP-Status, ResponseHeader und Antworttext gemeinsam, statt nur die sichtbare Backend-Meldung zu bewerten.

Logdatei auswählen und abrufen

Oberhalb der Vorschau steht ein kurzes Formular. Es lädt keine Amazon-Daten neu, sondern wählt nur aus, welche vorhandene Logdatei angezeigt wird.

  • Logdatei: Das Auswahlfeld enthält alle vorhandenen Amazon-SP-API-Logdateien. Die aktuellste Datei steht zuerst. Jede Option zeigt zusätzlich die Dateigröße in KB.
  • Abrufen: Der Button lädt die ausgewählte Datei erneut in die Vorschau. Die Navigation zum Amazon-Logbereich bleibt dabei erhalten.
  • Keine Logdatei vorhanden: Wenn noch kein Amazon-SP-API-Aufruf geloggt wurde oder alte Dateien bereits bereinigt wurden, zeigt das Auswahlfeld diesen Zustand direkt an.

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.

Vorschau lesen

Nach dem Abruf zeigt die Seite zuerst die ausgewählte Datei mit Änderungszeitpunkt und Größe. Darunter folgt die Logvorschau in einem scrollbaren Textbereich.

  • Ausgewählt: Bestätigt, welche Tagesdatei gerade geöffnet ist. Das ist wichtig, wenn mehrere Import- oder Feedtage verglichen werden.
  • Geändert: Zeigt den letzten Schreibzeitpunkt der Datei. So erkennst du, ob nach einem Testlauf wirklich ein neuer Eintrag entstanden ist.
  • Größe: Hilft beim Einschätzen, ob eine Datei nur wenige Einträge oder sehr viele API-Antworten enthält.
  • Vorschau: Sehr große Dateien werden am Anfang gekürzt; angezeigt wird dann der neuere Teil der Datei. Der Hinweis am Anfang der Vorschau macht diese Kürzung sichtbar.

Aufbau eines Logeintrags

Amazon-SP-API-Aufrufe werden als technische Anfrage-Antwort-Blöcke geschrieben. Ein neuer Block ist durch eine Trennzeile erkennbar.

  • Zeitpunkt, Methode und Ziel: Die erste Zeile zeigt Datum, Uhrzeit, Anfrageart und das aufgerufene API-Ziel.
  • Header: Enthält die gesendeten Kopfzeilen. Diese Angaben helfen bei Autorisierungs- und Signaturproblemen.
  • Request: Zeigt die übergebenen Daten, zum Beispiel Berichtsanfragen, Feed-Nachrichten oder Suchparameter.
  • ResponseHeader: Enthält die Rückgabe-Kopfzeilen der API. Diese sind bei Rate-Limits, Weiterleitungen oder Ablehnungen hilfreich.
  • Response: Zeigt HTTP-Status und Antwortinhalt. Prüfe diesen Abschnitt zuerst, wenn das Backend nur eine allgemeine Fehlermeldung anzeigt.

Sensible Daten und Aufbewahrung

  • Maskierung: Autorisierungsdaten, Token, Secrets, Passwörter, Signaturen, API-Keys und Cookies werden für die Anzeige maskiert.
  • Schreibschutz: Die Seite zeigt Logdateien nur an. Bearbeiten- und Löschaktionen gibt es hier nicht; die ausgewählte Logdatei kann jedoch heruntergeladen werden.
  • Aufbewahrung: Alte Tagesdateien werden zentral über den täglichen Schnittstellen-Log-Cleanup bereinigt. Standardmäßig bleiben diese Dateien 14 Tage erhalten.
  • Fehlender Eintrag: Wenn nach einer Aktion kein neuer Logeintrag erscheint, wurde möglicherweise kein Amazon-SP-API-Aufruf ausgelöst oder die Aktion ist vorher im Backend abgebrochen.

Praktisches Vorgehen bei Fehlern

  1. Führe die betroffene Amazon-Aktion erneut aus, zum Beispiel Import, Bericht prüfen oder Feed aktualisieren.
  2. Öffne danach die neueste Logdatei und kontrolliere den Änderungszeitpunkt.
  3. Springe in der Vorschau zum letzten Eintrag und prüfe zuerst den Response-Abschnitt.
  4. Vergleiche Anfrageart und Request-Daten mit der Aktion, die du gerade ausgelöst hast.
  5. Nutze die passende Amazon-Unterseite, um Einstellungen oder Prozessschritte zu korrigieren.

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.