FiveM-Logs, die Sie durchsuchen können, mit Alarmen auf Discord.

Warum Discord-Kanäle ein schlechter Ort für Logs sind

Die meisten FiveM-Server fangen auf dieselbe Art an zu loggen: Jede Ressource postet ein Embed an einen Discord-Webhook, ein Kanal pro Kategorie. Am ersten Tag funktioniert das. Im dritten Monat enthalten die Kanäle Hunderttausende Nachrichten, die Discord-Suche kann nicht nach einem Betrag oder einer Lizenz filtern, Webhook-Ratenlimits lassen in stoßreichen Stunden Events verlorengehen, und Screenshots, die an diese Nachrichten angehängt sind, werden zu ablaufenden Links.

BasiX behält den Teil, der funktioniert — eine Discord-Benachrichtigung, wenn ein Mensch eingreifen muss — und verlagert das eigentliche Protokoll an einen Ort, an dem es sich abfragen lässt. Ihr Team wird weiterhin benachrichtigt; es klickt sich nur zu einer Suche durch, statt zu scrollen.

Events aus FiveM senden

Installieren Sie die basix-Ressource, tragen Sie Ihren Key in server.cfg ein, und rufen Sie exports.basix:info, warn, error oder debug aus jeder Ressource auf. Events werden zwischengespeichert und alle zwei Sekunden in einer Anfrage gesendet, und bis zu 400 bleiben im Speicher, falls die API nicht erreichbar ist, sodass ein kurzer Ausfall keinen Bann-Eintrag verliert. Die aufrufende Ressource wird automatisch eingetragen.

Alles, was eine HTTP-Anfrage stellen kann, kann auch loggen: POST https://basix.media/api/v1/logs mit einem Dataset und bis zu 500 Events pro Anfrage. Der Endpunkt akzeptiert 240 Anfragen pro Minute und Key, was mehr als genug ist, sobald Events gebündelt werden.

exports.basix:log('info', 'Player bought a car', {
    player = GetPlayerIdentifierByType(source, 'license'),
    metadata = { model = 'sultan', price = 25000 },
})

Spieler-Logs: ein Profil pro Spieler

Jedes mit einem player-Feld gesendete Event baut ein Profil auf: erstes und letztes Auftreten, Event-Zahlen pro Kategorie und in den Metadaten gefundene Identifikatoren — license, license2, discord, steam, fivem, xbl, live, rockstar und citizenid. Ihr Team kann einen Anzeigenamen, interne Notizen und eigene Felder hinzufügen, sodass die Geschichte eines oft gemeldeten Spielers eine Seite ist statt einer Suche durch zehn Kanäle.

Kategorien, Spalten und gespeicherte Ansichten

Jedes Dataset kann zu einer Kategorie mit Bezeichnung, Farbe, Symbol und Gruppe werden, mit Spalten, die aus den Metadaten gelesen werden: Ein Wirtschafts-Log kann Betrag und Quelle als echte Spalten zeigen, ein Fahrzeug-Log das Kennzeichen. Gespeicherte Ansichten merken sich einen Satz Filter — Kategorien, Stufen, Spieler, Ressource, Text und einen Zeitraum — und werden standardmäßig mit Ihrem Team geteilt, sodass der diensthabende Moderator dieselbe Ansicht öffnet, die der Hauptadmin angelegt hat.

Discord-Alarme, wenn es wichtig ist

Eine Alarmregel schlägt an, wenn innerhalb eines Zeitfensters eine bestimmte Zahl passender Events eintrifft — zum Beispiel drei warn- oder error-Events in der Kategorie Wirtschaft binnen fünf Minuten, mit der Metadaten-Quelle gleich admin. Danach bleibt sie für eine selbst gewählte Abklingzeit still, damit ein Ausbruch den Kanal nicht überflutet. Alarme gehen an einen Discord-Webhook, an eigene Webhook-Endpunkte oder an beide.

Alarmregeln sind Teil eines Plans: 5 mit Starter, bis zu 100 mit Ultra.

Aufbewahrung und Preis

Logs sind in jedem Plan enthalten, nicht als separates Abonnement verkauft. Sie zählen zum selben Speicher wie Ihre Dateien und werden gemäß der Aufbewahrungsfrist Ihres Plans gespeichert: Free 3 days, Starter 30 days, Pro 90 days, Business 90 days, Ultra 180 days. Ein volles Kontingent antwortet mit einem expliziten Fehler statt Events still zu verwerfen.