docs: jak czytać logi i crash reporty (tydzień 3)

[iipanda]

Co to jest

Nowy artykuł walkthrough (tydzień 3) dla docs.voxelhost.pl: "Jak czytać logi i crash reporty", pierwszy artykuł w hubie "Serwer nie działa?" (kategoria "Problemy i błędy").

• Plik: docs/problemy/logi-i-crash-reporty.md
• Route: /problemy/logi-i-crash-reporty
• sidebar_position: 1
• 797 słów, polski, małe "voxelhost", bez em dashy.

Źródła (weryfikacja treści)

Fakty z panelu (dashboard source, ~/Desktop/voxelhost-dashboard) - zweryfikowane rg, uwzględniają korekty od team leada:

• Konsola (logi na żywo) = zakładka "Konsola", console V2 (app/modules/console/console-shell.tsx). Filtry poziomów Info / Ostrzeżenia / Błędy / Konsola / Bez etykiety oraz przycisk "Kopiuj widoczne": app/modules/console/console-toolbar.tsx. Command bar "Wpisz komendę" + "Wykonaj": app/modules/console/console-command-bar.tsx. Komunikat przy wyłączonym serwerze "Włącz serwer aby uzyskać dostęp do konsoli.": console-shell.tsx:47.
• Pliki (pełne pliki, pobieranie w panelu) = zakładka "Pliki", route /server/:id/files (app/modules/file-manager/). Każdy plik ma przycisk "Pobierz" (components/entry.tsx:540-544), więc logs/latest.log i crash-reports/ da się pobrać bez SFTP. BLOCKED_EXTENSIONS (entry.tsx:54-67) zawiera .gz (i .zip/.jar/...), ale nie .log - dlatego .log można otworzyć w edytorze w panelu i pobrać, a .gz tylko pobrać (przy próbie edycji toast "Edycja niedozwolona"). Pliki > 50 MB kierowane na FTP (views/directory-view.tsx:476-478).
• SFTP (duże pliki / alternatywa): host sftp://ftp.voxelhost.pl, port 22, dane w zakładce Ustawienia (sekcja FTP), hasło pokazywane raz: app/modules/settings/components/ftp-details-modal.tsx. (Uwaga: to customer-facing host z panelu; sftp.voxelhost.pl z CLAUDE.md to nazwa krawędziowa/wewnętrzna.)
• Anatomia linii logu w artykule zgodna z parserem panelu: app/modules/console/log-parser.ts (regexy [HH:MM:SS] [wątek/POZIOM]: oraz [HH:MM:SS POZIOM]:; poziomy INFO/WARN/ERROR/SEVERE/FATAL).

Wiedza ogólna o logach/crashach Minecrafta (cross-check upstream):

• Format [Server thread/LEVEL], logs/latest.log, rotacja do YYYY-MM-DD-N.log.gz, folder crash-reports/, "Caused by:", OutOfMemoryError: Java heap space, zasada pierwszego błędu / kaskady: SpigotMC / Minecraft Forum / CoalHost - wyniki wyszukiwania
• Struktura crash reportu (Description, stacktrace + łańcuch "Caused by:" gdzie najgłębszy = root cause, System Details + lista modów w Forge, pakiety non-vanilla wskazują moda): mcdoctor.ai - How To Read a Minecraft Crash Report
• "Failed to bind to port" / address already in use: Apex Hosting
• EULA (eula=false -> eula=true w eula.txt): Minecraft Forum - Failed to bind / EULA

Screenshot placeholders (do uzupełnienia)

• <!-- [screenshot: zakładka Konsola z filtrami poziomów i przyciskiem Kopiuj widoczne] -->
• <!-- [screenshot: zakładka Pliki z folderami logs/ i crash-reports/ oraz przyciskiem Pobierz] -->

TODO (niezweryfikowane)

Brak. Wcześniejszy TODO o nazwie pozycji w menu został rozwiązany po weryfikacji w źródle (zakładki "Konsola" i "Pliki").

Weryfikacja

• yarn install --frozen-lockfile -> bez zmian w yarn.lock (brak lockfile churn).
• yarn build -> SUCCESS (onBrokenLinks: throw, więc brak zepsutych linków wewnętrznych).
• Route obecny: build/problemy/logi-i-crash-reporty/index.html; wyrenderowany HTML zawiera "Konsola", "Pliki", "Pobierz", "Kopiuj widoczne", "crash-reports".
• Linki do bloga (voxelhost.pl/blog/...) i huba (docs.voxelhost.pl/problemy/) użyte jako pełne URL-e - w Docusaurus 2.x traktowane jako zewnętrzne, więc build nie failuje mimo że dziś zwrócą 404.

Linki, które dziś zwracają 404 (zamierzone)

• Blog "Optymalizacja TPS serwera Minecraft" - opublikowany razem z website blog PR (brief 17).
• Hub /problemy/ - powstaje z równoległego PR fazy 0.
• Dedykowany artykuł "ticking entity" - wspomniany tylko tekstem (bez linku), pojawi się później (tydzień 10 wg planu treści).

Merge schedule

Week 3, razem z website blog PR (brief 17). Hub pochodzi z PR fazy 0.

[iipanda]

Added panel screenshots for both placeholders: Konsola with level filters + "Kopiuj widoczne", and the Pliki logs/ folder with the file context menu (Pobierz option visible on latest.log). Note: the test server's logs/ folder had no crash-reports/ subfolder, so the screenshot shows only logs/ (worded the alt text accordingly rather than claiming crash-reports/ is visible). Build verified locally (docusaurus build exit 0, images present in output).