spark to profiler dla serwerów Minecraft. Gdy serwer się zacina, spark w kilka sekund pokaże ci, czy spada tickrate, które pluginy lub farmy pochłaniają czas oraz czy procesor albo pamięć są na granicy możliwości. Z tego poradnika poznasz trzy polecenia, których naprawdę potrzebujesz, i dowiesz się, jak czytać liczby. Zrzuty ekranu pochodzą z serwera testowego z Paper 1.21.4.
Instalacja
spark działa jako plugin na Paper i Spigot oraz jako mod na Fabric, NeoForge i Forge. W panelu znajdziesz go w sekcji Plugins → Browser. Nie wymaga żadnej konfiguracji. Polecenia powinny być dostępne dla grupy moderatorów; odpowiada za nie uprawnienie spark. Jak je nadać, przeczytasz w poradniku LuckPerms: konfiguracja uprawnień.
Pierwszy rzut oka: TPS i czas trwania ticka
/spark tps wyświetla trzy wiersze:
(Enlarge image)- TPS (ticki na sekundę) z ostatnich 5 sekund, 10 sekund oraz 1, 5 i 15 minut. Maksimum to 20,0. Przy wartości około 19 gracze jeszcze niczego nie zauważają, poniżej 15 zwierzęta poruszają się skokowo, a poniżej 10 gra na serwerze staje się niemożliwa.
- Czas trwania ticka jako minimum, mediana, 95. percentyl i maksimum w milisekundach. Aby utrzymać 20 TPS, tick może trwać najwyżej 50 ms. Na zrzucie mediana wynosi 2,4 ms, więc serwer ma duży zapas. Kluczowy jest 95. percentyl: jeśli zbliża się do 50 ms, pojawiają się przycięcia, mimo że średnia wygląda dobrze.
- Obciążenie procesora osobno dla systemu (cała maszyna) i procesu (tylko twój serwer). W przypadku wynajmowanego serwera ważna jest wartość dla procesu.
/spark healthreport zbiera te same wartości wraz z danymi o pamięci i dysku w jednym raporcie.
Profiler: co pochłania czas?
Gdy TPS spada, uruchom profiler:
/spark profiler start
spark potwierdza uruchomienie i dalej działa w tle. Pozwól mu pracować co najmniej minutę, gdy problem występuje, a następnie wpisz:
/spark profiler stop
(Enlarge image)Po zatrzymaniu spark przesyła raport na spark.lucko.me i wyświetla link. Raport nie zawiera nazw graczy, adresów IP ani wiadomości z czatu, tylko drzewa wywołań procesu Java. /spark profiler open otwiera go już w trakcie działania, a /spark profiler cancel odrzuca go bez przesyłania.
W raporcie rozwijaj drzewo od góry. Oto co zwykle w nim znajdziesz:
- Ticki bytów określonego typu: farma z setkami zwierząt lub przedmiotów. Zmniejsz farmę albo ogranicz jej obciążenie za pomocą
entity-activation-rangew plikupaper-world-defaults.yml. - Plugin w nasłuchiwaczu zdarzeń: zaktualizuj plugin, sprawdź jego konfigurację albo zastąp go innym.
- Ładowanie chunków przez szybko latających graczy: zmniejsz zasięg widzenia albo wygeneruj świat wcześniej za pomocą Chunky.
- Zegary redstone: układ, który nigdy się nie zatrzymuje. Poproś gracza, aby go wyłączył.
Garbage Collection i pamięć
/spark gc pokazuje, jak często i na jak długo zatrzymuje się mechanizm oczyszczania pamięci w Javie. Wiele długich przerw oznacza zbyt mało RAM-u albo wyciek pamięci w którymś pluginie. /spark heapsummary wyświetla listę typów obiektów zajmujących pamięć. Zanim dokupisz RAM, warto tu zajrzeć: często problem rozwiązuje aktualizacja pluginu.
Typowe błędy
- TPS 20, a mimo to lagi. Problem leży po stronie klienta lub sieci.
/spark pingpokazuje opóźnienie dla każdego gracza. - Zapomniany link do profilera.
/spark profilerbez argumentów pokazuje status; po zatrzymaniu link znajdziesz także w konsoli serwera. - Liczby bez porównania. Sama wartość TPS niewiele mówi. Zrób raz pomiar na pustym serwerze, aby mieć punkt odniesienia.
Powiązane poradniki
Wcześniejsze wygenerowanie świata zdejmuje z serwera ciężar ładowania chunków: Chunky: wstępne generowanie świata. O tym, jak panel zgłasza utrzymująco się niski TPS, przeczytasz w poradniku Lagi serwera Minecraft: TPS i Watchdog.
Źródła
- Dokumentacja spark: https://spark.lucko.me/docs/
- Polecenia: https://spark.lucko.me/docs/Command-Usage
- Odczytywanie raportów profilera: https://spark.lucko.me/docs/guides/Finding-lag-spikes