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:

Wynik polecenia /spark tps: TPS, czasy trwania ticków i obciążenie procesora (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
Profiler działa w tle; spark pokazuje polecenia do wyświetlenia, zatrzymania i anulowania (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-range w pliku paper-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 ping pokazuje opóźnienie dla każdego gracza.
  • Zapomniany link do profilera. /spark profiler bez 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