FabricExporter

FabricExporter - это серверный мод для Fabric, который решает давнюю проблему админов: как в реальном времени отслеживать состояние сервера, не залезая в логи и не используя сторонние костыли. Мод выгружает основные метрики твоего сервера в формате, понятном Prometheus - популярной системе сбора и анализа метрик.

Если ты когда-нибудь ловил лаги на своем сервере и хотел понять, что конкретно их вызывает (просадки TPS, перегрузка чанков, утечка энтити), то этот мод - твой must-have. А в паре с Grafana ты сможешь построить красивые графики и дашборды, чтобы видеть здоровье сервера на таймлайне.

---

Какие метрики собирает мод

FabricExporter умеет вытаскивать данные двумя способами: напрямую из Minecraft и через мод Spark (для TPS и MSPT). Вот полный список (все метрики можно отключить в конфиге):

Prometheus имя	Описание	Свойство конфига	Откуда
minecraft_loaded_chunks	Количество загруженных чанков сейчас	enable-loaded-chunks	Minecraft
minecraft_total_loaded_chunks	Общее количество загруженных чанков	enable-total-loaded-chunks	Minecraft
minecraft_mspt	Миллисекунды на тик (MSPT)	enable-mspt	Spark
minecraft_tps	Тиков в секунду (TPS)	enable-tps	Spark
minecraft_players_online	Игроков онлайн	enable-players-online	FabricExporter
minecraft_entities	Загруженных энтити	enable-entities	FabricExporter
minecraft_handshakes	Количество рукопожатий (handshake)	enable-handshakes	FabricExporter

Важно: метрики от Spark потребуют установки самого Spark на сервер. Без него они не работают - просто отключи их в конфиге, если Spark не используешь.

---

Как это настроить

Всё настраивается через файл config/exporter.properties, который мод создаст при первом запуске. Там два блока настроек: общие и для каждой метрики.

Общие настройки

Параметр	Описание	По умолчанию
server-port	Порт, на котором мод будет отдавать метрики	25585
update-interval	Интервал обновления метрик (в миллисекундах)	1000
use-spark	Использовать Spark (true/false)	true

По умолчанию мод ждёт запросов на порту 25585. Если у тебя этот порт занят или закрыт, просто поменяй значение.

Отключение конкретных метрик

Чтобы отключить ненужную метрику, добавь в конфиг строку вида enable-{имя-метрики}=false. Имена свойств легко понять из таблицы выше - например, enable-players-online отключает метрику minecraft_players_online. Все метрики по дефолту включены.

---

Установка и запуск

1. Скачай jar-файл мода (совместим с Fabric, версии Minecraft - актуальные релизы).
2. Положи его в папку mods на сервере.
3. Запусти сервер - сгенерируется конфиг config/exporter.properties.
4. Убедись, что порт, указанный в server-port, открыт для твоего Prometheus.
5. Перезапусти сервер, если вносил изменения в конфиг.

Подключение Prometheus

В файле prometheus.yml в секции scrape_configs добавь такой блок:

- job_name: 'fabric'
  static_configs:
    - targets: ['127.0.0.1:25585']

Замени 127.0.0.1 на реальный адрес твоего сервера, а 25585 - на порт из конфига. После этого перезапусти Prometheus.

Дашборд в Grafana

Хочешь видеть всё на красивых графиках? Для Grafana есть готовый дашборд с ID 14492. Импортируй его через Create → Import, и ты сразу получишь визуализацию TPS, MSPT, онлайна и загрузки чанков. Удобная штука, когда нужно быстро оценить состояние сервера.

---

Итог

FabricExporter - простой и лёгкий мод, который закроет дыру в мониторинге твоего Fabric-сервера. Если ты уже используешь Prometheus и Grafana, внедрение займёт пару минут. А без них - отличный повод попробовать эту связку. На слабом железе метрики почти не потребляют ресурсы, так что смело ставь на любой сервер.

Единственный нюанс - Spark нужен только для TPS/MSPT. Если тебе достаточно онлайна и чанков, можно обойтись без него. В любом случае, контроль над производительностью теперь под контролем.