O spark é o profiler para servidores Minecraft. Quando o servidor começa a engasgar, o spark diz-te em segundos se a tickrate está a sofrer, que plugins ou farms estão a consumir o tempo e se o CPU ou a memória estão no limite. Este guia mostra os três comandos de que realmente precisas e como interpretar os números. As capturas de ecrã foram feitas num servidor de teste com Paper 1.21.4.

Instalação

O spark funciona como plugin em Paper e Spigot e como mod em Fabric, NeoForge e Forge. No painel, encontras o spark em Plugins → Browser. Não precisa de configuração. Os comandos devem ficar reservados ao grupo de moderação; o nó de permissão chama-se spark. Para saberes como o atribuir, consulta LuckPerms: configurar as permissões.

Primeira análise: TPS e duração dos ticks

/spark tps mostra três linhas:

Resultado de /spark tps: TPS, durações dos ticks e utilização do CPU (Enlarge image)
  • TPS (ticks por segundo) nos últimos 5 segundos, 10 segundos, 1, 5 e 15 minutos. O máximo é 20,0. A partir de cerca de 19, os jogadores ainda não notam nada; abaixo de 15, os animais movem-se aos solavancos; abaixo de 10, o servidor torna-se injogável.
  • Duração dos ticks como mínimo, mediana, percentil 95 e máximo, em milissegundos. Um tick pode durar até 50 ms para se manterem as 20 TPS. Na imagem, a mediana está nos 2,4 ms, por isso o servidor tem muita margem. O valor decisivo é o percentil 95: se estiver perto dos 50 ms, surgem engasgos, mesmo que a média pareça boa.
  • Utilização do CPU, separada em sistema (a máquina inteira) e processo (apenas o teu servidor). Num servidor alugado, o valor que importa é o do processo.

/spark healthreport reúne os mesmos valores, juntamente com a memória e o disco, num único relatório.

O profiler: o que está a consumir o tempo?

Quando as TPS caem, inicia o profiler:

/spark profiler start

O spark confirma o início e continua a correr em segundo plano. Deixa-o a correr durante pelo menos um minuto enquanto o problema ocorre e depois executa:

/spark profiler stop
O profiler corre em segundo plano; o spark mostra os comandos para ver, parar e cancelar (Enlarge image)

Ao parar, o spark carrega o relatório para spark.lucko.me e devolve uma ligação. O relatório não contém nomes de jogadores, endereços IP nem mensagens de chat, apenas árvores de chamadas do processo Java. /spark profiler open abre-o ainda durante a execução e /spark profiler cancel descarta-o sem o carregar.

No relatório, expande a árvore a partir do topo. O que costumas encontrar:

  • Ticks de entidades de um determinado tipo: uma farm com centenas de animais ou itens. Reduz a farm ou acalma-a com entity-activation-range em paper-world-defaults.yml.
  • Um plugin num event listener: atualiza o plugin, verifica a configuração ou substitui-o.
  • Carregamento de chunks causado por jogadores que voam depressa: reduz a distância de visão ou pré-gera o mundo com o Chunky.
  • Relógios de redstone: um circuito que nunca para. Pede ao jogador que o desligue.

Garbage collection e memória

/spark gc mostra com que frequência e durante quanto tempo a recolha de lixo do Java faz pausas. Muitas pausas longas significam falta de RAM ou uma fuga de memória num plugin. /spark heapsummary lista os tipos de objetos que ocupam a memória. Antes de contratares mais RAM, vale a pena dar uma vista de olhos aqui: muitas vezes, uma atualização de um plugin resolve o problema.

Erros comuns

  • TPS a 20, mas continua a haver lag. O problema está no cliente ou na rede. /spark ping mostra a latência de cada jogador.
  • Esqueceste-te da ligação do profiler. /spark profiler sem argumentos mostra o estado; depois de parares o profiler, a ligação também aparece na consola do servidor.
  • Números sem comparação. Um valor de TPS, por si só, diz pouco. Faz uma medição com o servidor vazio para teres uma referência.

Guias relacionados

Gerar um mundo antecipadamente poupa ao servidor o carregamento de chunks: Chunky: pré-gerar o mundo. O guia Lag no servidor Minecraft: TPS e Watchdog descreve como o painel assinala TPS baixas de forma persistente.

Fontes