PerfTriage

⚡ PerfTriage – автоматическая диагностика лагов для серверов на Fabric

Ловите лаги в момент их появления — автоматически

PerfTriage — это лёгкий мод для диагностики лагов на стороне сервера для Fabric. Во время обычной игры он молчит. Когда на сервере начинаются затяжные скачки MSPT, он автоматически снимает структурированный диагностический снимок того, что было загружено, где это сосредоточено и какие чанки наиболее подозрительны. Он создан для одного практического вопроса:

Когда случился лаг, что именно происходило?

Зачем ставить PerfTriage?

Большинство серверных лагов происходит не тогда, когда вы активно профилируете. К тому моменту, как игроки сообщают:

• «сервер завис»
• «что-то не так в одной области»
• «TPS снова упал» …момент часто уже упущен. PerfTriage создан именно для этой проблемы. Вместо того чтобы работать как тяжёлый постоянно включённый профилировщик, он ждёт значимых скачков лага, а затем записывает сфокусированный отчёт, чтобы у вас остались доказательства после инцидента.

---

Что отслеживает PerfTriage

PerfTriage мониторит:

• Затяжные скачки MSPT
• Автоматическое восстановление после лага
• Ограничение частоты дампов на основе кулдауна
• Жёсткую защиту бюджета сканирования При срабатывании он генерирует структурированный отчёт с:

Анализ тиков

• Статистика MSPT по окну (avg / p95 / max)
• Длительность сэмплирования
• Использование бюджета
• Статус усечения сканирования

Снимок мира

• Количество загруженных чанков по измерениям
• Всего сущностей / блочных сущностей
• Топ типов сущностей
• Топ типов блочных сущностей

Анализ горячих точек

• Доминирующий тип сущностей
• Доминирующий тип блочных сущностей
• Концентрация на уровне чанков
• Средняя популяция за тик
• Информация о бюджете
• Флаг возможности сканирования чанков Отчёты записываются асинхронно в:

config/perftriage/reports/

В обоих форматах:

• .txt для людей
• .json для инструментов

---

Почему горячие чанки важны

Лаги часто вызваны локальной концентрацией, а не только глобальной нагрузкой. Типичные примеры:

• Затопление предметами / мобами / лодками
• Redstone-механизмы
• Фермы мобов
• Скалк-фермы
• Чанк-лоадеры
• Некорректно работающие конструкции, сосредоточенные в нескольких чанках PerfTriage сообщает не только что было загружено. Он сообщает где была концентрация. Это значит, что вы можете:
• телепортироваться прямо к проблемной области
• осмотреть затронутые чанки
• убрать источник
• сразу проверить улучшение

---

PerfTriage против spark

PerfTriage — не замена полноценным профилировщикам вроде spark. Они решают разные задачи.

Инструмент	Лучше всего подходит для	Типичный сценарий
PerfTriage	Автоматического отлова инцидентов с лагами	Установить и ждать скачков
spark	Глубокого профилирования и поиска причины	Запускать вручную при необходимости
Оба вместе	Сначала поймать, потом исследовать	Лучший общий сценарий

PerfTriage — для автоматической фиксации инцидентов. spark — для более глубокого профилирования, когда вы уже знаете, где искать. Поэтому они хорошо работают вместе.

Кому стоит это установить?

PerfTriage особенно полезен для:

• владельцев серверов, которые замечают лаги только после жалоб игроков
• админов, которым нужны координаты чанков, а не просто «сервер тормозит»
• продакшн-серверов, где постоянно включённое профилирование нежелательно
• серверов с периодическими лагами, которые сложно воспроизвести вручную

---

Что делает его особенным?

PerfTriage не инструментирует функции тиков непрерывно. Вместо этого он фокусируется на:

• активации только во время значимых лагов
• использовании строгих бюджетов сканирования и сэмплирования
• избегании тяжёлых фоновых накладных расходов
• создании детерминированных снимков
• локализации на уровне чанков Это делает его подходящим для реальных серверов, где важна стабильность.

---

Команды

Ручной дамп

/perftriage dump now

Статус

/perftriage status

Отображает:

• текущую статистику окна MSPT
• оставшийся кулдаун
• путь к последнему отчёту
• состояние восстановления

---

Пример вывода горячих точек

entity_hot_type: minecraft:acacia_boat
entity_hot_chunks_topN:
  - -4,-4: 35320
  - -4,-3: 35280
  - -5,-3: 31600

Это означает, что большая часть обнаруженной популяции горячей точки сосредоточена в этих чанках.

Совместимость

• Fabric Loader 0.18+
• Minecraft 1.21.4
• Сторона сервера

---

Философия

PerfTriage фокусируется на:

• низких накладных расходах
• детерминированной диагностике
• автоматической работе
• безопасности для продакшна Он создан, чтобы помочь вам сохранить доказательства, когда случаются лаги, вместо того чтобы заставлять вас гадать после факта.

---

Планы

• Поддержка нескольких версий (1.20.x / 1.21.x)
• Опциональная разбивка Top-K типов по чанкам
• Настраиваемые пороги
• Агрегация индекса отчётов
• Опциональный режим интеграции с профилировщиком

---

Лицензия

MIT

Создан для реальных серверов. Спроектирован для реальных лагов.

Этот мод обновляется еженедельно, возможно один или два раза в неделю.