Technologia

Monitoring zamówień i obsługa błędów w e-commerce

W zautomatyzowanym e-commerce błędy są nieuniknione - ważne, żeby je szybko wykrywać i naprawiać. Poznaj mechanizmy monitoringu, Dead Letter Queue i automatycznych ponowień.

Dlaczego monitoring jest krytyczny

Automatyzacja przetwarzania zamówień przynosi ogromne korzyści, ale wprowadza też nowy rodzaj ryzyka: błędy mogą wystąpić w tle, bez wiedzy sprzedawcy. Jeśli system fakturowy jest chwilowo niedostępny, dane zamówienia są niepełne lub token API wygasł - zamówienie nie zostanie przetworzone. Bez odpowiedniego monitoringu takie sytuacje mogą pozostać niezauważone przez godziny lub dni, prowadząc do opóźnień w fakturowaniu, niezadowolenia klientów i problemów podatkowych.

Dlatego profesjonalne systemy automatyzacji e-commerce, takie jak NavyFlame, wbudowują zaawansowane mechanizmy monitoringu na każdym etapie przetwarzania zamówienia - od pobrania z platformy sprzedażowej, przez walidację danych, aż po wystawienie faktury w docelowym systemie.

Jak działa Dead Letter Queue

Dead Letter Queue (DLQ) to wzorzec architektoniczny znany z systemów kolejkowych, zaadaptowany do obsługi błędów w przetwarzaniu zamówień. Gdy zamówienie nie może być poprawnie przetworzone - np. faktura nie może zostać wystawiona z powodu błędu API - system podejmuje automatyczne próby ponowienia (retry) z rosnącymi odstępami czasowymi.

Jeśli po wyczerpaniu wszystkich prób (domyślnie 3) zamówienie nadal nie może być przetworzone, trafia do DLQ. Tam jest przechowywane wraz z pełnym logiem błędów, co pozwala operatorowi szybko zdiagnozować przyczynę problemu. Po naprawieniu błędu (np. odnowieniu tokena API, uzupełnieniu danych) zamówienie można ponowić jednym kliknięciem.

Dashboard monitoringu w NavyFlame

Panel monitoringu w NavyFlame zapewnia pełny wgląd w proces przetwarzania zamówień. Na głównym dashboardzie widoczne są kluczowe metryki:

  • Liczba zamówień przetworzonych pomyślnie, w trakcie przetwarzania i oczekujących.
  • Liczba zamówień w DLQ z możliwością filtrowania po typie błędu i platformie źródłowej.
  • Historia przetwarzania - pełny audit trail każdego zamówienia z timestampami i szczegółami każdego kroku.
  • Alerty i powiadomienia - natychmiastowa informacja o nowych błędach w panelu i opcjonalnie na email.

Automatyczne ponowienia (retry)

Wiele błędów ma charakter przejściowy - tymczasowa niedostępność API, chwilowe przeciążenie serwera czy krototrwałe problemy sieciowe. Dlatego NavyFlame implementuje mechanizm automatycznych ponowień z exponential backoff: pierwsza próba po 30 sekundach, druga po 2 minutach, trzecia po 10 minutach. Ten schemat daje systemom zewnętrznym czas na powrót do normalnego działania, jednocześnie nie obciążając ich zbyt częstymi zapytaniami.

Najlepsze praktyki monitoringu

Aby w pełni wykorzystać możliwości monitoringu, warto wdrożyć kilka praktyk. Regularnie sprawdzaj zakładkę DLQ - nawet jeśli otrzymujesz powiadomienia email, codzienne przegliecie kolejki błędów pozwala wychwyc wzorce (np. powtarzające się błędy z konkretna platforma). Monitoruj także statystyki przetwarzania, aby wykrywać anomalie - nagle spadek liczby przetworzonych zamówień może wskazywać na problem z integracj. Wreszcie, aktualizuj tokeny API przed ich wygaśnięciem, korzystając z przypomnień w NavyFlame.

Najczęściej zadawane pytania

Dead Letter Queue to kolejka, do której trafiają zamówienia, które nie mogły być poprawnie przetworzone po wyczerpaniu automatycznych prób ponowienia. DLQ pozwala zidentyfikować problematyczne zamówienia, przeanalizować przyczynę błędu i ręczne ponowić przetwarzanie po naprawieniu problemu.

NavyFlame wykonuje domyślnie 3 automatyczne próby ponowienia z rosnącymi odstępami czasowymi (exponential backoff). Jeśli po trzech próbach zamówienie nadal nie może być przetworzone, trafia do DLQ z pełnym logiem błędów.

NavyFlame wysyła powiadomienia o błędach w czasie rzeczywistym - zarówno w panelu (in-app notification) jak i opcjonalnie na email. Dashboard monitoringu pokazuje aktualny stan przetwarzania, a licznik DLQ jest widoczny na głównej stronie panelu.

Tak. W zakładce Monitoring > DLQ każde zamówienie ma przycisk ponownego przetwarzania. Po naprawieniu przyczyny błędu (np. uzupełnieniu danych nabywcy, odnowieniu klucza API) możesz ponowić przetwarzanie jednym kliknięciem.

Do najczęstszych przyczyn należą: brakujące dane nabywcy (NIP, adres), wygasłe tokeny API do systemu fakturowego, przekroczenie limitu zapytań API (rate limit), tymczasowa niedostępność serwisu fakturowego oraz nieprawidłowe mapowanie stawek VAT.

Miej pełną kontrolę nad przetwarzaniem zamówień

Monitoring, DLQ i automatyczne ponowienia w standardzie.

Załóż konto