Zum Hauptinhalt springen

Log-Explorer

Diese Seite dokumentiert den vollständigen Workflow für den Log-Explorer im Admin-Bereich:

  • Log-Explorer-Seite im Admin
  • Eingebetteter Log-Explorer in den Spieler-Details
  • Workflow für Log-Anfragen

Hinweis zur Datenquelle: Alle Ergebnisse hier basieren auf importierten Server-Logs. Für die Aktualisierungslogik und erwartete Verzögerungen siehe Logs-Import-Konzept.

Zugriffsanforderungen​

Benötigte Berechtigungen in diesem Bereich:

  • logs.view -> Log-Explorer öffnen und nutzen
  • log_requests.view -> Log-Anfragen öffnen und Details ansehen
  • log_requests.create -> Neue Log-Anfragen erstellen
  • log_requests.approve -> Anfragen prüfen, genehmigen und ablehnen

Hinweise zum Zugriffsumfang:

  • Spieler-Details einsehen (einschließlich der eingebetteten Logs-Registerkarte) erfordert zusätzlich players.view.
  • Anfragendetails nach der Erstellung öffnen erfordert log_requests.view.
  • Ohne log_requests.approve sind Anfragendetails auf eigene Anfragen beschränkt.

Log-Explorer-Seite​

Navigationspfad:

  • Server-Admin -> Log-Explorer

Verfügbare Filter​

  • Position (X, Z) mit Radius-Abstand (siehe Koordinaten)
  • Zeitfenster (Startzeit, Endzeit)
  • Log-Typen (Mehrfachauswahl)
  • Spieler (Mehrfachauswahl)

Regel für Positionsfilter:

  • Positionsfilterung wird nur angewendet, wenn sowohl X als auch Z gesetzt sind.
  • Wenn der Abstand leer ist, während X und Z gesetzt sind, beträgt der Standardabstand 100.

Ergebnisanzeige​

Jede Zeile enthält:

  • Zeit
  • Spieler
  • Typ
  • Ereignisdetails
  • Position (verlinkter Kartenstandort, wenn Koordinaten existieren)

Datenfenster und Seitenwechsel​

  • Standard-Startzeit sind die letzten 7 Tage.
  • Endzeit ist optional.
  • Standard-Seitengröße beträgt 50 Einträge.
  • Maximale Seitengröße beträgt 250 Einträge.

Eingebetteter Log-Explorer in den Spieler-Details​

Navigationspfad:

  • Server-Admin -> Spieler -> Spieler öffnen -> Log-Einträge-Registerkarte

Wann diese Registerkarte angezeigt wird​

Die Registerkarte erscheint nur, wenn alle Bedingungen erfüllt sind:

  • logs.view ist gewährt
  • Server-Abonnement ist aktiv
  • Es existiert mindestens ein zugehöriger Benutzername für die Log-Filterung

Umfang der zugehörigen Benutzernamen​

Eingebettete Spieler-Logs sind auf zugehörige Benutzernamen beschränkt, basierend auf:

  • dem Spielernamen
  • Benutzernamen von Spielern, die über gemeinsame Geräte verknüpft sind

Spielerfilter-Optionen in dieser Registerkarte sind auf diesen Satz von zugehörigen Benutzernamen begrenzt.

Eingebettete Filter und Ergebnisse​

Die eingebettete Ansicht unterstützt dasselbe Filtermodell wie der globale Log-Explorer:

  • Position + Abstand
  • Zeitfenster
  • Typen
  • Spieler (beschränkt auf zugehörige Benutzernamen)

Wenn kein Spielerfilter ausgewählt ist, verwendet die eingebettete Ansicht alle zugehörigen Benutzernamen.

Regel für Positionsfilter:

  • Positionsfilterung wird nur angewendet, wenn sowohl X als auch Z gesetzt sind.
  • Wenn der Abstand leer ist, während X und Z gesetzt sind, beträgt der Standardabstand 100.

Eingebettetes Datenfenster und Seitenwechsel​

  • Standard-Startzeit sind die letzten 7 Tage.
  • Endzeit ist optional.
  • Standard-Seitengröße beträgt 50 Einträge.
  • Maximale Seitengröße beträgt 250 Einträge.

Log-Anfragen​

Navigationspfad:

  • Server-Admin -> Log-Anfragen

Verhalten der Anfrageliste​

  • Benutzer mit log_requests.view können die Seite öffnen.
  • Benutzer mit log_requests.approve sehen alle Anfragen sowie einen dedizierten Block ausstehender Genehmigungen.
  • Benutzer ohne log_requests.approve sehen nur ihre eigenen Anfragen.
  • Anfragen-Status: ausstehend, genehmigt, abgelehnt.

Eine Anfrage erstellen​

Erfordert log_requests.create.

Um die erstellte Anfragendetailseite direkt nach dem Absenden zu öffnen, ist auch log_requests.view erforderlich.

Formularfelder für Anfragen:

  • Grund (erforderlich)
  • Startzeit und Endzeit (erforderlich)
  • Optionaler Discord-Kanal
  • Optionaler Positions- + Abstand-Filter
  • Optionaler Typen-Filter
  • Optionaler Spieler-Filter

Regel für Positionsfilter:

  • Abstand wird nur gespeichert, wenn sowohl X als auch Z gesetzt sind.

Regeln für Zeitangaben:

  • Ende muss nach Start liegen.
  • Maximales Fenster beträgt 48 Stunden.

Anfragendetails und Überprüfung​

Die Anfragendetailseite zeigt:

  • Status, Antragsteller, Erstellzeit
  • Angefragtes Zeitfenster
  • Geprüft von / Prüfzeit (nach Überprüfung)
  • Optionaler Positionsfilter und Abstand
  • Grund
  • Optionaler Discord-Kanal
  • Optionaler Prüfer-Hinweis

Überprüfungsaktionen (erfordert log_requests.approve):

  • Anfrage genehmigen
  • Anfrage ablehnen
  • Filter vor Genehmigung aktualisieren (Zeit, Position/Abstand, Typen, Spieler)
  • Prüfer-Hinweis setzen

Genehmigungsupdate-Regeln:

  • Positionsfilter-Update erfordert sowohl X als auch Z.
  • Löschen des Positionsfilters erfordert leere Felder.

Nur ausstehende Anfragen können genehmigt oder abgelehnt werden.

Logs in Anfragedetails​

  • Logs werden nur angezeigt, wenn der Anfragenstatus genehmigt ist.
  • Ausstehende/abgelehnte Anfragen geben keine Log-Ergebnisse preis.
  • Genehmigte Anfragen verwenden die gespeicherten Anfragenfilter, um die Ergebnismenge zu erstellen.
  • Ergebnistabellen verwenden dieselbe Ereignisdetailanzeige wie der Haupt-Log-Explorer.

Verwandte Dokumentation​