Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

← Wszystkie artykuły

Jak logować błędy i monitorować własne automatyzacje

Zielone znaczniki w szeregu z żółtym okręgiem w miejscu brakującego zdarzenia

Automatyzacja może przestać działać bez spektakularnego błędu. Cron nie uruchomi skryptu, import zapisze zero rekordów albo proces utknie przed wysłaniem powiadomienia. Jeżeli sprawdzasz wyłącznie, czy serwer odpowiada, taka awaria pozostanie niewidoczna.

Monitoring automatyzacji powinien odpowiadać na trzy pytania: czy zadanie ruszyło, czy zakończyło się poprawnie i czy wykonało oczekiwaną pracę. Logi pomagają później ustalić przyczynę. Alert powinien dotrzeć wystarczająco wcześnie, żeby dało się zareagować.

Zacznij od definicji sukcesu

„Proces zakończył się kodem zero” jest dobrym sygnałem technicznym, ale nie zawsze pełną definicją sukcesu. Import może poprawnie przetworzyć pustą odpowiedź, choć dostawca zwykle zwraca dane. Backup może utworzyć plik, którego nikt nie próbował odtworzyć.

Dla każdego zadania zapisz prosty kontrakt:

Zadanie Sygnał techniczny Kontrola rezultatu
Import zamówień poprawne zakończenie procesu zapisany zakres danych i liczba zmian
Backup bazy eksport bez błędu poprawne archiwum i okresowe odtworzenie
Pobieranie raportu odpowiedź HTTP zgodna z umową właściwy okres raportu i format
Synchronizacja ukończony przebieg brak zaległych elementów ponad próg

Próg nie musi być uniwersalny. Zero nowych zamówień może być normalne w nocy, a niepokojące w ciągu dnia. Najpierw poznaj rytm procesu, dopiero potem ustaw alarm.

Jedno uruchomienie, jeden identyfikator

Gdy kilka przebiegów zapisuje komunikaty w tym samym miejscu, sam czas nie wystarcza do ich rozdzielenia. Dodaj run_id i zachowuj go od rozpoczęcia do zakończenia zadania.

Przydatny minimalny zestaw pól to czas UTC, nazwa zadania, identyfikator uruchomienia, zdarzenie, czas trwania i liczba przetworzonych elementów. Kod błędu lub typ wyjątku często pozwala sklasyfikować problem bez kopiowania całej odpowiedzi API.

Poniższy przykład zapisuje po jednym obiekcie JSON na linię. Dzięki temu log można czytać ręcznie albo przetwarzać programowo. Zapisz go jako job.py:

import json
import sys
import time
import uuid
from datetime import datetime, timezone

run_id = str(uuid.uuid4())
started = time.monotonic()
def emit(event, **fields):
    print(json.dumps({'timestamp': datetime.now(timezone.utc).isoformat(),
                      'job': 'demo-import', 'run_id': run_id,
                      'event': event, **fields}), flush=True)
emit('started')
try:
    if '--fail' in sys.argv:
        raise ValueError('Synthetic failure')
    processed = 2  # Demonstracja, nie rzeczywisty import.
except Exception as error:
    emit('failed', error_type=type(error).__name__,
         duration_ms=round((time.monotonic() - started) * 1000))
    raise SystemExit(1)
else:
    emit('succeeded', processed=processed,
         duration_ms=round((time.monotonic() - started) * 1000))

To demonstracja obsługi wyniku. Wartość processed = 2 jest jawnie syntetyczna i nie oznacza rzeczywistego importu. W swojej aplikacji podstaw liczbę elementów faktycznie zapisanych po zatwierdzeniu operacji.

Sprawdź sukces i błąd osobno

Uruchom dwa warianty:

python3 job.py
echo $?
python3 job.py --fail
echo $?

Pierwszy powinien zapisać started oraz succeeded i zwrócić kod 0. Drugi zapisze started oraz failed, a kod zakończenia wyniesie 1. W każdym przebiegu oba wpisy mają wspólny run_id.

Te dwa scenariusze zostały wykonane podczas przygotowania artykułu. Sprawdzono JSON, wspólny identyfikator i kody procesu. Nie testowano dostarczania zewnętrznych powiadomień, więc ten przykład nie potwierdza jeszcze działania całej ścieżki alarmowania.

Format JSON ułatwia filtrowanie, ale nie rozwiązuje samodzielnie rotacji, uprawnień ani wysyłki logów. W większym programie moduł logging pozwala rozdzielić tworzenie zdarzeń od obsługi ich miejsca docelowego.

Brak uruchomienia również musi wywołać alarm

Skrypt nie zapisze wyjątku, jeżeli w ogóle nie wystartuje. Dlatego potrzebujesz kontroli ostatniego sukcesu niezależnej od samego zadania.

Załóżmy, że import ma działać co godzinę. Ustal dopuszczalne opóźnienie na podstawie czasu wykonania i potrzeb projektu. Osobny obserwator powinien sprawdzać wiek ostatniego poprawnego zakończenia, a nie samą obecność pliku logu.

Nie umieszczaj całej kontroli na tym samym hoście, jeżeli chcesz wykryć także utratę tego hosta. Sygnał „żyję” wysłany do niezależnego monitora może ujawnić awarię, której lokalny cron nie zgłosi.

Podstawy harmonogramu znajdziesz w poradniku crona. Dostępność strony lub endpointu możesz śledzić przez Uptime Kuma, ale pamiętaj, że odpowiedź strony nie dowodzi sukcesu importu w tle.

Retry nie powinno ukrywać problemu

Ponowienie chwilowego błędu bywa właściwe, lecz każde podejście powinno pozostawić ślad. Dodaj numer próby i powiąż go z tym samym zadaniem logicznym.

Rozróżniaj stan „ponawiam” od „zakończyłem niepowodzeniem”. Alarmowanie po każdej sekundowej przerwie może zalać odbiorcę. Brak alarmu po wyczerpaniu prób jest równie niebezpieczny dla procesu.

Przy operacjach zapisujących dane uwzględnij idempotencję. Timeout nie dowodzi, że zewnętrzny serwer niczego nie zrobił. Szczegóły opisuje poradnik o ponawianiu automatyzacji.

Jeżeli źródłem problemu jest limit zapytań, zwiększanie liczby prób bez opóźnienia tylko pogorszy sytuację. Najpierw sprawdź obsługę rate limit API.

Co powinno znaleźć się w powiadomieniu

Dobre powiadomienie pozwala rozpocząć diagnozę bez otwierania pięciu paneli. Wystarczą nazwa zadania, środowisko, czas ostatniego sukcesu, identyfikator przebiegu i krótka kategoria błędu.

Nie wysyłaj w nim tokenów, pełnych rekordów klientów ani całego wejściowego dokumentu. Link do zabezpieczonego widoku logów jest zwykle praktyczniejszy niż kopiowanie poufnej odpowiedzi.

Ustal też, co zamyka incydent. Po odzyskaniu działania można wysłać jedną informację o powrocie do normy. Wciąż trwająca awaria nie powinna generować nowej identycznej wiadomości co minutę.

Przykład kanału znajdziesz w powiadomieniach serwerowych przez Telegram. Najpierw przetestuj go kontrolowanym błędem i potwierdź odbiór w miejscu, które rzeczywiście obserwujesz.

Retencja i ochrona logów

Logi również zajmują dysk. Ustal limit rozmiaru lub czasu przechowywania oraz sprawdź zachowanie po jego przekroczeniu. Rotacja plików powinna odpowiadać sposobowi zapisu procesu, żeby program nie pisał nadal do niewidocznego starego pliku.

Ogranicz dostęp do logów. Pomijanie haseł w jednym komunikacie nie wystarczy, jeżeli biblioteka później wypisuje cały nagłówek Authorization. Przejrzyj również wyjątki, parametry adresów URL i tryb debug.

Przy backupie połącz monitorowanie procesu z kontrolą odtwarzania opisaną w skrypcie kopii bazy. Alert „plik utworzony” powinien mieć węższe znaczenie niż „dane można odzyskać”.

Najczęstsze pytania

Czy wystarczy zapisywać wyjątki?

Nie. Potrzebujesz także informacji o starcie, sukcesie i braku oczekiwanego uruchomienia.

Czy każdy błąd wymaga wiadomości?

Nie. Możesz łączyć powtarzające się zdarzenia i alarmować po wyczerpaniu prób, zgodnie z wymaganym czasem reakcji.

Czy kod zero oznacza poprawny import?

Potwierdza deklarowany sukces programu. Kontrakt powinien dodatkowo sprawdzać rezultat, na przykład zatwierdzenie zapisu.

Czy monitoring na tym samym VPS wykryje jego utratę?

Nie wyśle skutecznie powiadomienia, jeśli sam przestanie działać. Kontrola braku sygnału powinna mieć niezależne miejsce wykonania.

Źródła

Data publikacji: 12.11.2026.

KP
O AUTORZE

Krystian Proć

Tworzę narzędzia do pracy z danymi, systemy backendowe i automatyzacje. Pracuję z SQL, PHP, TypeScriptem i Dockerem; rozwijam m.in. dragon-island.com. AI pomaga mi przyspieszać pracę, a architekturę, weryfikację i decyzje techniczne biorę na siebie. Na Trybie Technicznym dzielę się doświadczeniami z budowania i utrzymywania własnych projektów.

Dyskusja

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *