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.
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.