Dziennik audytu¶
local-shell-mcp zapisuje ustrukturyzowane wpisy audytu, aby ułatwić odtworzenie działań podłączonego client.
Domyślna ścieżka:
Co jest rejestrowane¶
Wpisy audytu obejmują zdarzenia takie jak:
- Początek/koniec tool call.
- Metadane wykonywania poleceń.
- Timeouty i obsłużone błędy.
- Rejestracja remote worker i aktywność jobów.
- Tworzenie i unieważnianie file links.
- Zdarzenia związane z uwierzytelnianiem, gdy ma to zastosowanie.
Wrażliwe argumenty są redagowane, jeśli serwer potrafi je rozpoznać.
Odczyt dziennika¶
Użyj narzędzia MCP:
Lub sprawdź plik bezpośrednio:
Zastosowanie operacyjne¶
Dzienniki audytu są szczególnie przydatne do:
- Przeglądania poleceń, które zmieniły pliki.
- Sprawdzania, czy użyto remote worker.
- Diagnozowania nieoczekiwanych awarii.
- Wykrywania przypadkowego ujawnienia file links.
- Wspierania incident response po błędzie publicznego deployment.
Retencja¶
Aktywny audit.jsonl jest domyślnie ograniczony do 20 MB przez LOCAL_SHELL_MCP_MAX_AUDIT_LOG_BYTES. Podczas obsługi retention starsze rekordy są przenoszone do samodzielnych archiwów Zstandard audit-archive/*.jsonl.zst zamiast usuwane; duże zewnętrzne audit payloads są również dołączane do archiwum przed usunięciem z hot store.
Skompresowane archiwa mają osobny limit LOCAL_SHELL_MCP_MAX_AUDIT_ARCHIVE_BYTES, domyślnie 512 MB. Po jego przekroczeniu najstarsze archiwa są usuwane jako pierwsze. Wartość 0 wyłącza długoterminową kompresowaną retencję. Web UI, zapytania Activity/Audit i audit_tail czytają wyłącznie aktywny hot log. Skompresowane archiwa są cold storage do retencji lub eksportu i nie są automatycznie dekompresowane przez zwykłe zapytania UI.
Ograniczenia¶
Dziennik audytu nie jest sandboxem. Pomaga w śledzeniu działań, ale nie zapobiega wykonywaniu przez podłączony model operacji w granicach skonfigurowanych uprawnień.