Zabbix-Template für Hytale Server (Linux)

  • Hallo zusammen,

    leider konnte ich keinen anderen Platz im Forum finden, der thematisch besser passt.

    Ich habe ein Zabbix-Template für Linux Hytale Server erstellt.
    Das Template überwacht die unten aufgeführten Items.
    Alles, was die Hardware betrifft, kann problemlos mit den in Zabbix integrierten Templates überwacht werden.

    Vielleicht kann jemand von euch damit etwas anfangen 🙂

    Repository:

    GitHub - Garfieldttt/zabbix-agent-hytale-template: Zabbix Agent (active) template for monitoring a Hytale server. Discovers players, bans and whitelist entries by parsing local Hytale JSON files and exposes detailed player state metrics.
    Zabbix Agent (active) template for monitoring a Hytale server. Discovers players, bans and whitelist entries by parsing local Hytale JSON files and exposes…
    github.com

    Was wird monitorisiert:

    Server

    • Servername
    • MOTD
    • Maximale Spieleranzahl
    • Maximale Sichtweite

    Spieler

    Für jeden gefundenen Spieler (pro UUID / Player-Datei):

    • Online-Status (online/offline)
    • Last seen
    • Spielername
    • Welt (World)
    • Position (X/Y/Z)
    • GameMode (Adventure / Exploration / Creative)
    • Inventar-Übersicht (Items aus Storage / Hotbar / Tool / Armor / Utility)
    • Entdeckte Zonen (Discovered Zones)
    • Death Marker / Death Positions
    • Respawn-Punkte

    Stats / States

    • Health
    • Oxygen
    • Stamina
    • Stamina-Regen-Delay
    • Mana Charges (Magic Charges)
    • Ammo
    • Immunity
    • Gliding (aktiv / inaktiv)
    • Signature Charges
    • Signature Energy
    • (falls vorhanden) Remaining Duration eines aktiven Effekts (z. B. Buff-Dauer)

    Bans

    Für jeden Ban-Eintrag:

    • Ob / wer gebannt ist
    • Ban-Grund
    • Gebannt von
    • Ban-Typ
    • Ban-Zeitpunkt
    • Trigger/Alarm: „Spieler UUID X gebannt“

    Whitelist

    Für jeden Whitelist-Eintrag:

    • Ob / wer auf der Whitelist ist
    • Trigger/Alarm: „Spieler UUID X whitelisted“

    Enthaltene Trigger / Alarme

    • Spieler online
    • Spieler offline
    • Spieler im Creative Mode
    • Spieler gebannt
    • Spieler auf der Whitelist

  • Ich habe einen Server-Offline-Trigger erstellt, der überwacht, ob der Hytale-Server auf dem UDP-Port 5520 lauscht.
    Ist dies über einen Zeitraum von 5 Minuten nicht der Fall, wird der Trigger und in weiterer Folge ein Alarm ausgelöst.
    Der Port ist über das Host-Macro {$UDP_PORT} frei konfigurierbar.

  • Hallo @all,

    ich habe Neuigkeiten zum Zabbix-Template.

    Einige Daten ließen sich nicht über das Zabbix-Agent-(active)-Plugin erfassen.
    Daher habe ich nach einer Möglichkeit gesucht, die Plugin-Daten stattdessen über HTTP-Requests auszulesen.

    Da das bestehende Template die Daten bereits per API-Request abruft, habe ich hierfür ein separates Plugin sowie ein zusätzliches Template erstellt. Beide Templates können parallel auf demselben Server betrieben werden und funktionieren problemlos zusammen.

    Die Umsetzung erfolgt über die Plugins Nitrado WebServer und Nitrado Query.

    Repository:

    GitHub - Garfieldttt/zabbix-agent-hytale-http-template: Zabbix template to monitor Hytale servers via HTTP JSON API. Requires the Nitrado Query and Nitrado WebServer plugins.
    Zabbix template to monitor Hytale servers via HTTP JSON API. Requires the Nitrado Query and Nitrado WebServer plugins. -…
    github.com

    Damit lassen sich nun auch die Plugin-Daten vollständig erfassen.


    Überwachte Daten

    Server- und Statusdaten (HTTP-JSON-API)

    • Aktuelle Spieleranzahl (Server current players)
    • Server-Patchline (Server patchline)
    • Server-Protokoll-Version (Server protocol version)
    • Server-Revision / Build (Server revision)
    • Server-Version (Server version aktuell)
    • Server-Version (Server version verfügbar)

    Spielerinformationen

    • Aktive Spieler (Low-Level-Discovery über UUID)
    • Aktuelle Welt pro Spieler

    Plugin-Monitoring (Low-Level-Discovery)

    • Plugin geladen / nicht geladen
    • Plugin aktiviert / deaktiviert
    • Aktueller Plugin-Status
      (ENABLED, DISABLED, FAILED, UNLOADED)
    • Plugin-Version

    Trigger

    • Warnung, wenn ein Plugin nicht geladen ist
    • Warnung, wenn ein Plugin deaktiviert ist
    • Warnung bei fehlerhaftem Plugin-Status
    • Warnung wenn eine neue Server-Version verfügbar ist


    Bei Fragen oder Problemen gerne melden 🙂

    Einmal editiert, zuletzt von Garfieldtt (5. Februar 2026 um 14:31)