Błędy i kody odpowiedzi API
Druga warstwa to zliczanie błędów w każdym przebiegu: odpowiedzi 401 i 403, limitów 429, błędów 5xx i odrzuconych rekordów. Pojedynczy błąd sieci nie jest powodem do alarmu, bo integracja i tak ponowi zapytanie. Liczy się odsetek błędów w oknie czasowym albo seria błędów tego samego typu. Błąd autoryzacji to wyjątek - powinien alarmować od razu, bo sam z siebie nie zniknie. Jak szczegółowo czytać kody odpowiedzi przy awarii, opisujemy we wpisie integracja przestała działać - lista kontrolna diagnozy.
Opóźnienie i zaległości w kolejce
Trzecia warstwa mierzy, jak daleko integracja jest w tyle. Najprostsze miary to wiek najstarszego nieprzetworzonego elementu w kolejce i czas od ostatniego pobrania zamówień. Przy Allegro można porównać identyfikator ostatniego zdarzenia zamówień zwracany przez punkt event-stats z identyfikatorem ostatniego zdarzenia przetworzonego przez integrację (stan na lipiec 2026 - sprawdź aktualną dokumentację Allegro API). Rosnąca różnica oznacza, że integracja nie nadąża albo stoi, nawet jeśli nie zgłasza błędów.
Metryki biznesowe
Czwarta warstwa patrzy na wynik: ile zamówień przyszło z każdego kanału w ostatniej godzinie, ile powstało faktur i etykiet, ile ofert zmieniło stan. Alarm uruchamia się, gdy wartość odbiega od normy dla danej pory, np. zero zamówień z Allegro w godzinie, w której zwykle jest ich kilkanaście. Ta warstwa wyłapuje błędy logiki, mapowania i filtrów, których nie widać w kodach odpowiedzi. Szczególnie przydaje się przy stanach magazynowych, o czym piszemy we wpisie synchronizacja stanów magazynowych między sklepem a marketplace.
Uzupełnieniem metryk jest codzienne uzgadnianie liczb między systemami. Raz na dobę skrypt porównuje liczbę zamówień z poprzedniego dnia w marketplace, w sklepie i w ERP, a także liczbę opłaconych zamówień z liczbą wystawionych dokumentów. Różnica nie zawsze oznacza awarię, bo część zamówień mogła zostać anulowana, ale każda niewyjaśniona rozbieżność powinna trafić do kogoś do sprawdzenia. Takie uzgadnianie wyłapuje pojedyncze zgubione rekordy, których nie widać w metrykach godzinowych.
Jak ustawić alerty o błędach integracji, żeby nie przegapić awarii
Próg alertu dla błędów najlepiej opierać na odsetku, a nie na liczbie bezwzględnej. Dziesięć błędów na tysiąc zapytań to szum, dziesięć błędów na dwanaście zapytań to awaria. Przykładowe wyliczenie wygląda tak:
[#chart:wpr77b]
Same progi to połowa pracy. Druga połowa to sposób, w jaki alert trafia do ludzi. Dobre zasady, które stosujemy przy wdrożeniach:
Konkretny adresat - alert trafia do osoby lub dyżuru z nazwiska, a nie na wspólną skrzynkę, którą nikt nie czyta po godzinach.
Niezależny kanał - powiadomienie idzie poza serwer sklepu, np. na komunikator lub SMS, bo poczta na tym samym serwerze padnie razem z nim.
Pełny kontekst - treść mówi, która integracja, które konto i od kiedy, oraz podaje link do logów.
Eskalacja - jeśli nikt nie potwierdzi alertu w ustalonym czasie, powiadomienie trafia do kolejnej osoby.
Grupowanie - ten sam problem generuje jeden alert z licznikiem, a nie sto osobnych wiadomości.
Powiadomienie o powrocie - zespół wie, kiedy integracja znowu działa, i może sprawdzić zaległości.
[#przyklad] Przykład dobrego alertu: „Integracja zamówień Allegro, konto sklep_glowny: brak udanego pobrania od 45 minut, ostatni błąd 401 przy odświeżeniu tokenu o 9:12. Logi: link. Dyżur: Anna, eskalacja do Piotra po 30 minutach”. Z takiej wiadomości wiadomo, co się stało, kogo dotyczy i od czego zacząć.
Alerty, które pomagają, i alerty, które szkodzą
Zbyt czuły monitoring jest prawie tak groźny jak jego brak. Gdy zespół dostaje kilkanaście alarmów dziennie, z których większość nic nie znaczy, przestaje je czytać i przegapia ten jeden prawdziwy. Granicę między użytecznym a szkodliwym alertem pokazuje porównanie:
[#chart:wpr77c]
Raz w miesiącu warto przejrzeć listę alertów z ostatnich tygodni. Każdy alarm, który nie wymagał działania, to kandydat do zmiany progu, połączenia z innym albo usunięcia. Każda awaria, o której zespół dowiedział się od klienta, to sygnał, że brakuje reguły. Taki przegląd zajmuje zwykle kilkanaście minut, a z czasem sprawia, że każdy alert, który przychodzi do zespołu, naprawdę wymaga reakcji.
Wbudowane mechanizmy platform - na co można liczyć
Platformy mają własne zabezpieczenia, ale nie zastąpią monitoringu po stronie sklepu. WooCommerce zapisuje dostarczenia webhooków w logach i automatycznie wyłącza webhook po ponad pięciu kolejnych nieudanych próbach. Shopify ponawia nieudane wywołania do ośmiu razy w ciągu czterech godzin, a gdy błędy się utrzymują, usuwa subskrypcję i pokazuje statystyki dostarczeń w panelu deweloperskim. Allegro nie wysyła powiadomień o nowych zamówieniach na adres sklepu - integracja sama odpytuje dziennik zdarzeń, więc o jej zatrzymaniu nikt z Allegro nie poinformuje (stan na lipiec 2026 - sprawdź aktualną dokumentację platform). Wyłączony webhook albo zatrzymane odpytywanie wykryje tylko Twój heartbeat lub metryka biznesowa.
Podobnie jest z tokenami. Przy integracjach z Allegro warto monitorować datę ostatniego udanego odświeżenia tokenu każdego konta, bo utrata autoryzacji to jedna z najczęstszych przyczyn przestojów. Zasady odświeżania opisujemy we wpisie token API Allegro - jak go odnawiać.
Logi integracji - fundament każdego monitoringu
Alert mówi, że coś się stało. Log mówi, co dokładnie. Bez czytelnych logów nawet najlepiej ustawiony alarm kończy się godzinami zgadywania. Każdy wpis w logu integracji powinien zawierać kilka stałych elementów:
czas zdarzenia z datą i strefą czasową,
nazwę integracji i konta, którego dotyczy operacja,
identyfikator zamówienia, produktu lub zdarzenia, żeby dało się prześledzić jego drogę,
kod odpowiedzi i treść błędu zwróconą przez API,
wynik operacji: sukces, ponowienie, odrzucenie.
Logi nie powinny zawierać tokenów, kluczy API ani pełnych danych osobowych klientów, jeśli nie są potrzebne do diagnozy. Czas przechowywania logów warto dopasować do tego, jak szybko wykrywasz problemy - jeśli awarie zauważasz po tygodniu, logi z trzech dni nie wystarczą.
Monitoring automatyzacji w Make, n8n i integratorach
Część przepływów w sklepach działa w narzędziach do automatyzacji albo w integratorach sprzedaży. Mają one własne historie wykonań i powiadomienia o błędach, ale ich zakres i ustawienia różnią się między narzędziami i planami. Sprawdź, czy błąd scenariusza wysyła powiadomienie do właściwej osoby, i dodaj metrykę biznesową po stronie sklepu, która pokaże, że przepływ przestał dostarczać dane, nawet jeśli samo narzędzie nie zgłasza błędu.
Monitoring integracji przed szczytem sprzedaży
Przed dużymi kampaniami progi ustawione na zwykły ruch przestają pasować. Liczba zamówień na godzinę rośnie kilkukrotnie, więc alarm o spadku sprzedaży trzeba przeliczyć, a kolejki będą naturalnie dłuższe. Warto wcześniej sprawdzić, czy alerty docierają do osób, które będą dyżurować w dniu kampanii, i czy ktoś ma dostęp do logów wszystkich integracji krytycznych. Monitoring sprawdzony na spokojnym ruchu to dopiero połowa przygotowań.
Monitoring integracji krok po kroku - od czego zacząć
Sklep, który dziś nie ma żadnego monitoringu integracji, nie musi wdrażać wszystkiego naraz. Rozsądna kolejność wygląda tak:
Spisz przepływy krytyczne: zamówienia z każdego kanału, stany, płatności, etykiety, faktury.
Dla każdego przepływu wskaż osobę odpowiedzialną i zastępcę.
Dodaj heartbeat do zadań cyklicznych i ustaw margines dopasowany do ich harmonogramu.
Zapisuj błędy z kodem odpowiedzi i nazwą konta, a alert ustaw na serię błędów lub błąd autoryzacji.
Dodaj jedną metrykę biznesową na kanał, np. liczbę zamówień w godzinie porównaną z tą samą godziną tydzień wcześniej.
Przetestuj alert: zatrzymaj zadanie na środowisku testowym i sprawdź, czy powiadomienie dotarło do właściwej osoby.
Co miesiąc przeglądaj alerty i dostrajaj progi.
Jak Vinson pomaga z monitoringiem integracji
Projektujemy i wdrażamy monitoring integracji sklepów z marketplace, ERP, kurierami i płatnościami. Dodajemy heartbeat do zadań, porządkujemy logi, ustawiamy progi i kanały alertów oraz metryki biznesowe dopasowane do rytmu sprzedaży sklepu. Przy integracjach napisanych przez innych wykonawców zaczynamy od przeglądu, który pokazuje, czego dziś nie widać. Szczegóły znajdziesz na stronie Wsparcie programistyczne dla e-commerce.
Najczęściej zadawane pytania
Czym różni się monitoring integracji od monitoringu dostępności sklepu?
Monitoring dostępności sprawdza z zewnątrz, czy strona sklepu odpowiada. Monitoring integracji sprawdza, czy dane między systemami płyną na czas i bez błędów. Strona może działać bez zarzutu, a zamówienia z marketplace mogą w tym czasie w ogóle nie spływać.
Co to jest heartbeat w monitoringu?
Heartbeat to sygnał, który zadanie wysyła do usługi monitorującej po każdym udanym przebiegu. Gdy sygnał nie przyjdzie w zaplanowanym czasie powiększonym o margines, usługa wysyła alert. Dzięki temu wykrywa się zadania, które przestały się uruchamiać i nie zostawiają żadnych logów.
Jak ustawić alert, żeby nie było fałszywych alarmów?
Opieraj progi na odsetku błędów w oknie czasowym lub serii błędów, a nie na pojedynczym zdarzeniu. Porównuj metryki biznesowe z tą samą porą w poprzednim tygodniu. Grupuj powtarzające się alerty i regularnie usuwaj reguły, które nie prowadzą do żadnego działania.
Czy Allegro powiadamia, gdy integracja przestanie pobierać zamówienia?
Nie. Integracja sama odpytuje dziennik zdarzeń zamówień w API Allegro, więc jej zatrzymanie musi wykryć monitoring po stronie sklepu (stan na lipiec 2026 - sprawdź aktualną dokumentację Allegro API). Najlepiej sprawdzają się heartbeat zadania i alarm, gdy z danego konta nie przychodzą zamówienia w zwykłych godzinach sprzedaży. Warto też pilnować daty ostatniego udanego odświeżenia tokenu każdego konta.
Gdzie wysyłać alerty o błędach integracji?
Do konkretnej osoby lub dyżuru, kanałem niezależnym od serwera sklepu, np. przez komunikator zespołu lub SMS. Alert przychodzący tylko na pocztę na tym samym serwerze może nie dotrzeć dokładnie wtedy, gdy jest najbardziej potrzebny.
Dobry monitoring integracji sprawia, że o awarii dowiadujesz się z alertu w kilka minut, a nie od klienta po kilku dniach. Heartbeat, kontrola błędów, opóźnień i liczby zamówień to niewielki koszt w porównaniu z przestojem w szczycie sprzedaży. Jeśli chcesz wdrożyć taki monitoring w swoim sklepie, sprawdź wsparcie programistyczne Vinson.
