Logging
Gestructureerde logs die je bij het volgende incident meteen kunt doorzoeken
Console-scrollback verdwijnt bij een restart. Platte logbestanden verdrinken in ruis. FiveGateway vangt gestructureerde logevents op uit je FiveM-resources met getypte velden, categorieën en Discord-routing, zodat je 'wat gebeurde er voor de crash' kunt beantwoorden zonder SSH.
Elke log-entry in FiveGateway heeft meer structuur dan een regel op de console. Je stuurt vanuit elke resource een event met een categorienaam, een severity en een set getypte velden: speleridentifier, voertuigmodel, item-SKU, wat er voor dat event toe doet. Het dashboard indexeert die velden, zodat 'laat elke voertuig-spawn zien van license:abc123 in de afgelopen 24 uur' één filter is in plaats van een grep-pipeline.
Categorieën vormen de routing-eenheid. Je definieert ze in het dashboard, wijst een veldschema toe en koppelt een webhook. Een store-purchase-categorie kan naar je sales-kanaal in Discord, een fail2ban-categorie naar moderatie, en een crash-categorie zowel naar Discord als naar een eigen Slack-endpoint. Omdat categorieën één keer zijn ingesteld en hergebruikt worden, blijft je resource-code kort: verstuur het event, het dashboard regelt wie het ziet.
Historie is waar gestructureerde logs pas echt lonen. Nadat een griefer is gebanned trek je het spelerprofiel open, filter je zijn entries per categorie en heb je de hele volgorde: wanneer hij joinde, wat hij spawnde, welke chat hij stuurde, wanneer de warn viel en wanneer de ban landde. Op serverniveau werkt het net zo. Filter op errors van het laatste uur na een restart en je ziet de echte oorzaak, niet de 800 debugregels eromheen.
Omdat logs getypt zijn, zijn ze exporteerbaar. Elke gefilterde weergave wordt een CSV-download waar product-, community- of compliance-teams buiten de tool mee verder kunnen. Dezelfde events kun je ook per categorie via een webhook naar je eigen analytics-stack sturen als je langer wilt bewaren dan je planretentie toestaat.
Bouw je een nieuwe integratie, begin dan bij het Lua-snippet in de setup-guide van het dashboard. Het levert één FiveGateway.Log-functie die een categorie, severity en metadata-tabel aanneemt. Plak het in elke bestaande resource zonder je scripts opnieuw in te delen.
Server-admins die gewend zijn aan console-prints of platte filewrites merken het verschil snel. In plaats van een log schrijven, vergeten en later grep'en, schrijf je een doorzoekbaar event met een intentie: deze categorie, deze severity, deze speler. Het resultaat: snellere incidentreviews, betere audit trails bij donatiegeschillen en moderatiebeslissingen die appeals overleven omdat je je werk kunt laten zien.
Zo werkt het
- 1
Definieer categorieën
Maak een logcategorie aan in het dashboard, kies de veldtypes en koppel optioneel een Discord- of eigen webhook-URL.
- 2
Stuur events uit Lua
Gebruik de FiveGateway.Log-functie in je resources. Geef de categorie, severity en een getypte metadata-tabel mee. De call is async en niet-blokkerend.
- 3
Zoek, filter en exporteer
Open de logs-weergave, filter op categorie, speler, severity of tijdvak, en exporteer het resultaat als CSV voor offline review.