Zum Hauptinhalt springen

Protokoll-Import

Diese Seite erklärt, wie Protokolldaten vom Spielserver in dzbot gelangen, warum Verzögerungen auftreten können und welche Funktionen von diesen Daten abhängen.

Was „Protokoll-Import" bedeutet​

dzbot liest Server-Protokolldateien von Nitrado und wandelt sie in strukturierte Ereignisse um.

Diese Ereignisse werden dann plattformweit genutzt (z. B. im Log Explorer, bei der Kartenaktivität, im Kill-/Schadensfeed und anderen Automatisierungsfunktionen).

So funktioniert der Ablauf (vereinfacht)​

  1. Ein Spielereignis geschieht auf deinem Server.
  2. Nitrado schreibt dieses Ereignis in die Server-Protokolldateien.
  3. dzbot prüft diese Protokolldateien in einem wiederkehrenden Intervall.
  4. Neue bzw. geänderte Inhalte werden importiert und verarbeitet.
  5. Funktionen, die auf Protokolldaten basieren, werden nach der Verarbeitung aktualisiert.

In Produktivumgebungen läuft die Importprüfung sehr häufig (in der Regel jede Minute).

Warum Daten verzögert erscheinen können​

Dieses System arbeitet nahezu in Echtzeit, aber nicht sofort.

Häufige Ursachen für Verzögerungen:

  • Nitrado-/Quelldaten sind möglicherweise nicht sofort verfügbar
  • Neue Protokollzeilen können später als das eigentliche Spielereignis eintreffen
  • Stoßzeiten können die Verarbeitungsverzögerung erhöhen

Was das in der Praxis bedeutet:

  • Viele Aktualisierungen erscheinen schnell
  • Verzögerungen von 10–20 Minuten sind in manchen Situationen normal
  • Verzögerungen von 30–60 Minuten können auftreten, besonders bei hoher Last oder Verzögerungen beim Upstream

Warte bei Nachforschungen kurz, bevor du davon ausgehst, dass Daten fehlen.

Grundlagen zur Datenaktualität​

  • „Zuletzt aktualisiert" gibt an, wann dzbot die Daten empfangen/verarbeitet hat.
  • Das bedeutet nicht zwingend, dass das Ereignis gerade eben stattgefunden hat.
  • Sehr aktuelle Zeitfenster können unvollständig sein, da späte Einträge noch eintreffen.

Warum das für den täglichen Betrieb wichtig ist​

Wenn Protokolle verzögert sind, können alle protokollgesteuerten Funktionen ebenfalls verzögert wirken.

Das ist ein erwartetes Verhalten und korrigiert sich in der Regel, sobald neue Importe abgeschlossen sind.

Funktionen, die vom Protokoll-Import abhängen​

Die folgenden Bereiche nutzen importierte Protokolldaten direkt:

  • Admin Log Explorer
  • Eingebetteter Log Explorer in Spielerdetails
  • Ergebnisansichten von Protokollanfragen
  • Kill Feed und Schadensfeed
  • Kartenaktivitätsebenen (Spielerpositionen, Kopfgeld-Zielpositionen und verwandte Overlays)
  • Spielerrouten und Kontaktanalyse in Admin-Spielerdetails
  • Positionsbasierte Onboarding-Prüfungen und Spieler-Sync-Verhalten
  • Koordinatenauswahl-Quelle „Aus Platzierungen"
  • Aktionen, die bei importierten Protokollereignissen auslösen
  • Basis-Alarm-Zeitlinien und Kontext nahegelegener Aktivitäten

Betriebliche Erwartungen für Admins​

  • Nutze importierte Protokolle als Grundlage für Audit- und Überprüfungsabläufe.
  • Bei aktuellen Vorfällen: kurz warten und dann erneut prüfen.
  • Bei Moderationsentscheidungen lieber ein etwas größeres Zeitfenster wählen, um Importverzögerungen zu berücksichtigen.

Verwandte Dokumentation​