ZYAD Docs

Analytics einrichten — Server mit dem Dashboard verbinden

Diese Anleitung verbindet deinen DayZ-Server mit dem ZYAD Dashboard, damit Events (Glücksrad-Gewinne, Boss-Kills, …) als Statistiken auf zyadmods.de auftauchen. Dauer: ca. 5 Minuten.

Voraussetzungen

1

Im Dashboard anmelden

Öffne das ZYAD Dashboard und klicke auf „Über Steam anmelden“. Du wirst zu Steam weitergeleitet, meldest dich dort an (die Anmeldung passiert komplett bei Steam) und landest zurück im Dashboard.

2

Server anlegen — ServerId & API-Key erhalten

Gehe auf die Seite „Server“ → „+ Server anlegen“ (Name frei wählbar). Das Dashboard erzeugt automatisch:

  • eine ServerId (z. B. srv_a1b2c3d4)
  • einen API-Key (z. B. zyad_live_…)
⚠ Der API-Key wird aus Sicherheitsgründen nur dieses eine Mal angezeigt — wir speichern nur einen Hash. Kopiere direkt den fertigen analytics.json-Schnipsel, der darunter steht. Key verloren? Kein Problem: „Key rotieren“ erzeugt einen neuen (der alte wird dabei ungültig).
3

analytics.json auf dem Server eintragen

Die Datei liegt im Server-Profil unter:

<Profil-Ordner>/ZYAD/Core/analytics.json

ZYADCore legt sie beim ersten Serverstart automatisch als Vorlage an (mit "Enabled": 0). So sieht die komplette Datei aus — anpassen musst du nur die ersten drei Felder, der Rest sind sinnvolle Standardwerte:

{
    "Enabled": 1,
    "ServerId": "srv_DEINE_ID",
    "ApiKey": "zyad_live_DEIN_KEY",
    "UploadIntervalSec": 20,
    "MaxBatchSize": 100,
    "MaxQueueSize": 2000,
    "MaxDiskFiles": 200,
    "SelfTestOnBoot": 0,
    "DebugLogging": 0
}
FeldBedeutung
Enabled1 = Senden aktiv, 0 = komplett aus (Standard bei neuer Datei).
ServerIdDie srv_…-Kennung aus dem Dashboard (die Zeichenkette — nicht irgendeine Zahl).
ApiKeyDein geheimer Key. Niemals ins Modpack/Workshop oder öffentlich teilen — er gehört nur in diese Server-Datei.
UploadIntervalSecSendetakt in Sekunden (15–30 empfohlen).
MaxBatchSizemaximale Events pro Sendung.
MaxQueueSizemaximale Events im Speicher-Puffer.
MaxDiskFilesZwischenspeicher-Dateien bei API-Ausfall (Events gehen nicht verloren).
SelfTestOnBoot1 = Test-Event beim Serverstart — praktisch beim Einrichten, danach wieder auf 0.
DebugLogging1 = ausführliches Log für die Fehlersuche.

Eine URL steht bewusst nicht in der Datei — die API-Adresse ist fest im Mod hinterlegt (falls deine Datei aus einer älteren Version noch ApiUrl/ApiPath enthält: einfach löschen, die Werte werden ignoriert).

4

Server neu starten und prüfen

Starte den DayZ-Server neu. Danach zwei schnelle Checks:

  • Server-Log: Im Analytics-Log unter <Profil-Ordner>/ZYAD/Core/logs/ sollten [Uploader] … SUCCESS-Zeilen auftauchen (mit SelfTestOnBoot: 1 schon wenige Sekunden nach dem Start).
  • Dashboard: Auf der Seite „Server“ füllt sich die Spalte „Letzter Upload“ — das ist das Lebenszeichen deiner Verbindung.

Sobald auf dem Server etwas passiert (Glücksrad, Boss-Kill, …), erscheinen die Events in „Übersicht“, „Events“ und „Auswertungen“.

Beim Start meldet dein Server außerdem einmalig, welche ZYAD-Versionen dort laufen. Auf der Seite „Server“ siehst du dadurch sofort, ob Workshop-Mod und Serverteil zusammenpassen — siehe Versionen. Das Ereignis enthält keine Spielerdaten.
5

In-Game steuern (optional)

Im Spiel öffnest du als Admin das ZYAD Admin Center (Standard-Taste Pos1/Home, umbelegbar in der DayZ-Steuerung) → Button „Analytics“:

  • Haupt-Schalter: Senden komplett an/aus — live, ohne Neustart.
  • Pro Modul: einzelne Quellen stummschalten (z. B. Events nicht senden, Trader & Raid Bases schon).

ServerId, API-Key und URL bleiben bewusst nur in der analytics.json auf dem Server — das In-Game-Menü zeigt sie nie an.

Fehlerbehebung

Das Analytics-Log (<Profil-Ordner>/ZYAD/Core/logs/) nennt bei Fehlversuchen einen code. Die häufigsten Fälle:

Symptom / CodeUrsacheLösung
code=5 (≈ 401) API-Key falsch oder inzwischen rotiert. Key im Dashboard neu erzeugen („Key rotieren“) und in die analytics.json übernehmen.
code=6 / code=7 Verbindungs-/Adressfehler. Sollte mit aktueller Mod-Version nicht mehr auftreten (die API-Adresse ist fest im Mod) — deutet auf eine veraltete ZYADCore-Version hin. ZYADCore auf den neuesten Stand bringen; tritt es weiter auf, Internet-/Firewall-Freigabe des Servers für ausgehendes HTTPS prüfen.
Log: „inactive / disabled“ Enabled: 0 oder noch Platzhalter-Werte in der Datei. Echte ServerId + Key eintragen und Enabled: 1 setzen, Server neu starten.
„Letzter Upload“ bleibt leer Server im Dashboard auf inaktiv gestellt, oder es passiert schlicht nichts Sendenswertes. Server-Status im Dashboard prüfen; testweise SelfTestOnBoot: 1 setzen und neu starten.
Kurzzeitiger API-/Internet-Ausfall — Nichts tun: Events werden auf dem Server zwischengespeichert (RAM + Disk) und nach dem Ausfall automatisch nachgeliefert.

Sicherheit — kurz erklärt

Start · Impressum · Datenschutz · Nutzungsbedingungen