Wróć do bloga

Logi w aplikacji: co zapisywać, gdzie trzymać i jak długo

Co zapisywać w logach aplikacji, czego nie, gdzie je trzymać, jak długo przechowywać (także w świetle RODO) i jak ustawić alerty. Z poleceniem dla agenta AI.

Drubricks··6 min czytania

Poniedziałek rano. Dzwoni kierowniczka biura: z systemu zniknęło zlecenie dużego klienta. Otwierasz aplikację i nie wiesz, kto je usunął, kiedy ani czy ktoś w ogóle je usunął. Logi są, ale mają tylko komunikaty błędów z ostatnich dwóch dni.

Żeby logi odpowiedziały na takie pytanie, ustal kilka rzeczy przed startem aplikacji. Zapisuj zdarzenia bezpieczeństwa, błędy i zmiany danych, w formacie JSON, a w każdym wpisie: kiedy, gdzie, kto i co. Nie zapisuj haseł, tokenów, identyfikatorów sesji ani kluczy. Trzymaj logi poza serwerem aplikacji, z ograniczonym dostępem. Okres przechowywania dobierz do celu i do prawa, a dane osobowe trzymaj nie dłużej, niż to potrzebne. Na poważne zdarzenia ustaw alerty.

My, zespół Drubricks, rozumiemy przez logi zapisy zdarzeń, które aplikacja robi w trakcie działania. W aplikacji dla firmy przydają się trzy rodzaje:

  • logi błędów: co się zepsuło, w którym miejscu kodu i przy jakich danych; czyta je programista albo agent,
  • log zdarzeń (audit log): kto co zrobił w aplikacji, na przykład zalogował się, zmienił albo usunął rekord, wyeksportował dane,
  • logi serwera: żądania HTTP, czasy odpowiedzi, błędy serwera www i bazy.

Co zapisywać w logach?

Fundacja OWASP w swoim poradniku o logowaniu wymienia zdarzenia, które warto logować zawsze. Najważniejsze z nich dla aplikacji biznesowej:

  • udane i nieudane logowania,
  • odmowy dostępu, czyli próby wejścia tam, gdzie użytkownik nie ma uprawnień,
  • błędy walidacji danych wejściowych,
  • błędy aplikacji i problemy z połączeniem, na przykład z bazą,
  • start i zatrzymanie aplikacji,
  • eksport i import danych, także raporty,
  • dostęp do danych wrażliwych.

Do tego dochodzi to, co ważne dla Twojej firmy: zmiany i usunięcia rekordów, zmiany uprawnień, zmiany ustawień.

Każdy wpis według OWASP ma zapisać „kiedy, gdzie, kto i co”:

  • kiedy: data i godzina zdarzenia; OWASP zaleca format ISO 8601 z przesunięciem względem UTC, na przykład 2026-11-21T09:14:03+01:00,
  • gdzie: która aplikacja i na którym serwerze,
  • kto: zalogowany użytkownik albo proces, plus adres źródłowy,
  • co: typ zdarzenia, poziom ważności i opis.

Poziomy ważności najlepiej wziąć z gotowego standardu. Protokół syslog (RFC 5424) ma osiem poziomów, od 0 (Emergency) do 7 (Debug). Aplikacji biznesowej zwykle wystarczą cztery: Error, Warning, Info i Debug.

OWASP odradza też zwykły tekst i poleca format strukturalny, na przykład JSON. Taki wpis da się przeszukać i policzyć bez wyrażeń regularnych:

{"time":"2026-11-21T09:14:03+01:00","level":"info","event":"record.delete",
 "app":"zlecenia","user":"anna.nowak","ip":"203.0.113.24",
 "record":"order/1532","message":"Usunięto zlecenie 1532"}

To przykład ilustracyjny. Nazwy pól ustal raz i trzymaj się ich w całej aplikacji.

Czego w logach nie zapisywać

Logi trafiają w wiele miejsc: na serwer, do kopii zapasowych, do narzędzi zespołu. Według OWASP w logach zwykle nie powinny trafiać:

  • identyfikatory sesji i tokeny dostępu,
  • hasła,
  • connection stringi do bazy,
  • klucze szyfrujące i inne sekrety,
  • dane kont bankowych i kart płatniczych,
  • wrażliwe dane osobowe, na przykład dane o zdrowiu albo numery dokumentów.

Uważaj też na dane od użytkownika. Ktoś może wpisać w formularz znak nowej linii i dopisać do logu fałszywy wpis. OWASP nazywa to log injection i zaleca oczyszczanie danych zdarzenia (znaki CR, LF, separatory) oraz ograniczenie długości tego, co trafia do logu.

Osobna sprawa to dane osobowe, których nie da się uniknąć. Login, e-mail i adres IP w logu zdarzeń są potrzebne, żeby wiedzieć, kto co zrobił. Trybunał Sprawiedliwości UE uznał w sprawie Breyer, że nawet dynamiczny adres IP może być daną osobową dla operatora strony. Logi z takimi danymi podlegają więc RODO, a to wpływa na to, jak długo je trzymasz. W sprawach RODO pytaj osobę, która w firmie za nie odpowiada, albo inspektora ochrony danych, jeśli firma go ma.

Gdzie trzymać logi: poza serwerem aplikacji, z ograniczonym dostępem

Logi zapisane tylko na serwerze aplikacji znikają razem z nim. Jeśli ktoś przejmie serwer, może je też zmienić. Dlatego polecamy wysyłać logi na bieżąco w osobne miejsce: na drugi serwer albo do usługi logów u Twojego dostawcy chmury lub hostingu. Zapytaj agenta, jak wysłać tam logi z Twojej aplikacji.

OWASP dodaje kilka zasad ochrony logów. Jeśli logi trzyma hosting albo usługa zewnętrzna, część z nich spełnia ona za Ciebie, więc zapytaj o nie dostawcę:

  • wykrywaj zmiany i usunięcia wpisów,
  • jak najszybciej kopiuj logi na nośnik tylko do odczytu,
  • ograniczaj i okresowo przeglądaj uprawnienia do czytania logów, a sam dostęp do logów też loguj,
  • trzymaj logi na osobnej partycji niż system, a w bazie używaj osobnego konta tylko do zapisu logów.

Jeśli aplikacja działa na kilku serwerach, zsynchronizuj na nich czas (robi to usługa NTP; zapytaj hosting, czy jest włączona). Bez tego kolejność zdarzeń z różnych maszyn się rozjeżdża.

Sprawdź też, gdzie logi zapisuje Twój framework domyślnie. Zwykle to baza aplikacji albo plik na tym samym serwerze. Na start to wystarczy, ale log zdarzeń i tak warto wysyłać dalej.

Jak długo trzymać logi?

Jednej liczby nie ma. OWASP pisze, że na okres przechowywania mogą wpływać obowiązki prawne, regulacyjne i umowne. RODO dokłada zasadę ograniczenia przechowywania: dane, które pozwalają zidentyfikować osobę, trzymasz nie dłużej, niż to niezbędne do celu. Zatem dla każdego rodzaju logów zapisz cel i okres, a po nim usuń wpisy albo je zanonimizuj.

Jako punkt wyjścia polecamy taki podział. To nasza rekomendacja, nie wymóg prawa; sprawdź ją z umowami z klientami i ze swoimi obowiązkami prawnymi:

Logi Cel Okres (punkt wyjścia)
Wpisy na poziomie Debug (w każdym rodzaju logów) szukanie konkretnego błędu na produkcji wyłączone; włączane na kilka dni przy szukaniu błędu
Logi błędów naprawa i analiza awarii 30–90 dni
Logi serwera wydajność, ataki, awarie 30–90 dni
Log zdarzeń (audit log) kto co zrobił, spory, incydenty 12 miesięcy i dłużej, jeśli wymaga tego umowa albo prawo

Długi okres dla logu zdarzeń nie musi oznaczać długiego trzymania danych osobowych. Po okresie potrzebnym do bezpieczeństwa możesz usunąć z wpisów adres IP i e-mail, a zostawić identyfikator użytkownika, czas i operację.

Ustawienie typu „zachowaj ostatnie 1000 wpisów” liczy wpisy, a nie dni. W dniu z dużym ruchem albo z atakiem 1000 wpisów może wypełnić się w godzinę i usunąć to, czego właśnie szukasz. Dla logu zdarzeń ustaw okres w czasie, nie w liczbie wpisów.

Kto dowie się, że w logach dzieje się coś złego?

W zestawieniu OWASP Top 10 z 2021 roku ta kategoria nazywała się Security Logging and Monitoring Failures, a jej opis mówi wprost, że bez logowania i monitoringu naruszeń nie da się wykryć. W edycji 2025 nazywa się już Security Logging and Alerting Failures. Poradnik OWASP zaleca natychmiastowe powiadamianie odpowiedzialnych osób o poważniejszych zdarzeniach.

W małej firmie wystarczy kilka reguł na start:

  • seria nieudanych logowań na jedno konto albo z jednego adresu,
  • nagły wzrost błędów serwera (kody 500),
  • powtarzające się odmowy dostępu dla jednego użytkownika,
  • masowe usuwanie albo eksport rekordów.

Dla każdej reguły ustal, kto dostaje alert i gdzie: konkretna osoba, telefon albo czat zespołu.

Od czego zacząć: polityka logowania w jednym pliku

Zapisz ustalenia w repozytorium, na przykład w pliku docs/logging.md: co logujesz, czego nie, gdzie trzymasz logi, jak długo, kto ma dostęp i jakie są alerty. Wskaż go agentowi w pliku z instrukcjami projektu (na przykład CLAUDE.md albo AGENTS.md), żeby trzymał się go przy każdej zmianie. Masz też gotową odpowiedź, gdy klient zapyta o dane osobowe w logach.

Wklej agentowi to polecenie:

Przejrzyj logowanie w tej aplikacji i niczego jeszcze nie zmieniaj. Odpowiedz z nazwami plików:
1. Jakie zdarzenia są logowane? Czy są logowania udane i nieudane, odmowy dostępu,
   błędy, zmiany i usunięcia rekordów, eksporty?
2. Czy każdy wpis ma czas z UTC, użytkownika, miejsce, typ, poziom i opis? W jakim formacie?
3. Czy do logów trafiają hasła, tokeny, identyfikatory sesji, klucze albo dane kart?
4. Czy dane od użytkownika są oczyszczane przed zapisem do logu?
5. Gdzie trafiają logi i kto ma do nich dostęp?
6. Jak długo są przechowywane i co je usuwa?
7. Jakie zdarzenia wysyłają alert i do kogo?
Potem zaproponuj plik docs/logging.md z polityką logowania.

Budujemy Drubricks, darmowy starter na Drupalu do aplikacji biznesowych budowanych z agentem AI: każde utworzenie, zmiana i usunięcie rekordu trafia w nim do logu Drupala, a moduł Config Log zapisuje każdą zmianę konfiguracji. Domyślnie ten log leży w bazie aplikacji z limitem liczby wpisów, więc wysyłkę poza serwer i okres w dniach ustaw według tego wpisu.