FabricExporter

FabricExporter предоставляет метрики вашего сервера в формате Prometheus. Для полноценного мониторинга рекомендуется использовать Prometheus для сбора данных и Grafana для их визуализации.

FabricExporter — это серверный мод для Fabric, который экспортирует метрики вашего сервера в формате Prometheus. Для работы мода необходимо предварительно установить Prometheus. Автор также рекомендует использовать Grafana для визуализации полученных данных.

Для получения метрик TPS и MSPT необходимо установить дополнительно мод Spark.

📊 Собираемые метрики

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

🚀 Быстрый старт

Настройка Prometheus

Откройте конфигурационный файл Prometheus (по умолчанию он находится в /etc/prometheus/prometheus.yml).

sudo nano /etc/prometheus/prometheus.yml

Добавьте эндпоинт FabricExporter в секцию scrape_configs. Замените 127.0.0.1 на адрес вашего сервера, а 25585 — на порт, указанный в свойстве server-port файла exporter.properties.

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

Перезапустите службу Prometheus.

sudo service prometheus restart

Импорт дашборда Grafana

Если вы используете Grafana, можно использовать готовый дашборд как шаблон (при условии создания источника данных Prometheus в Grafana):

1. Войдите в Grafana и перейдите на вкладку Create -> Import.
2. Введите 14492 в поле "Import via grafana.com" и нажмите "Load".
3. На следующей странице настройте параметры и нажмите "Import".

Настройка конфигурации

После запуска сервера FabricExporter создаст файл exporter.properties в папке config. В нем можно настроить общие параметры и параметры метрик.

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

Настройки метрик

Вы можете отключить любую метрику, зарегистрированную через MetricRegistry, в файле exporter.properties. Имена свойств состоят из префикса enable и названия метрики, где нижнее подчеркивание заменяется на дефис. Например, чтобы отключить minecraft_players_online, установите enable-players-online в значение false. Все метрики включены по умолчанию. Если вы не нашли свойства для какой-то метрики, его можно добавить вручную.

Требования проверенного файла

• По манифесту для файла fabricexporter-26.2-1.0.22.jar (Minecraft 26.2; Fabric) требуется fabric-api. Встроенных JAR-библиотек в проверенном файле нет.