FiveM-logs die je kunt doorzoeken, met alerts op Discord.

Waarom Discord-kanalen een slechte plek zijn voor logs

De meeste FiveM-servers beginnen met loggen op dezelfde manier: elke resource post een embed naar een Discord-webhook, één kanaal per categorie. Op dag één werkt dat. Na drie maanden bevatten de kanalen honderdduizenden berichten, kan Discord-zoeken niet filteren op een bedrag of een license, laten webhook-ratelimits events wegvallen tijdens drukke uren, en worden screenshots bij die berichten links die verlopen.

BasiX behoudt het deel dat werkt — een melding in Discord zodra iets een mens nodig heeft — en verplaatst de registratie zelf naar een plek waar je er doorzoekend bij kunt. Je staff krijgt nog steeds een ping; ze klikken alleen door naar een zoekopdracht in plaats van te scrollen.

Events vanuit FiveM versturen

Installeer de basix-resource, zet je key in server.cfg, en roep exports.basix:info, warn, error of debug aan vanuit elke resource. Events worden gebufferd en elke twee seconden in één request verstuurd, en tot 400 worden in geheugen bewaard als de API onbereikbaar is, zodat een korte storing geen banrecord kost. De aanroepende resource wordt automatisch ingevuld.

Alles wat een HTTP-verzoek kan doen, kan ook loggen: POST https://basix.media/api/v1/logs met een dataset en tot 500 events per request. Het endpoint accepteert 240 requests per minuut per key, wat ruim voldoende is zodra events gebundeld worden.

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

Spelerslogs: één profiel per speler

Elk event dat met een player-veld wordt verstuurd, bouwt een profiel op: eerst en laatst gezien, aantal events per categorie, en identifiers gevonden in de metadata — license, license2, discord, steam, fivem, xbl, live, rockstar en citizenid. Je team kan een weergavenaam, interne notities en eigen velden toevoegen, zodat de geschiedenis van een speler die steeds wordt gerapporteerd één pagina is in plaats van een zoektocht door tien kanalen.

Categorieën, kolommen en opgeslagen weergaven

Elke dataset kan een categorie worden met een label, kleur, icoon en groep, en met kolommen gelezen uit de metadata: een economy-log kan bedrag en bron als echte kolommen tonen, een voertuiglog het kenteken. Opgeslagen weergaven bewaren een set filters — categorieën, niveaus, speler, resource, tekst en periode — en worden standaard met je team gedeeld, zodat de moderator van dienst dezelfde weergave opent die de hoofdadmin heeft gebouwd.

Discord-alerts wanneer het telt

Een alertregel gaat af wanneer een aantal matchende events binnen een tijdvenster binnenkomt — bijvoorbeeld drie warn- of error-events in de categorie economy binnen vijf minuten, met metadata source gelijk aan admin. Daarna blijft hij stil voor een afkoelperiode die je zelf kiest, zodat een piek het kanaal niet overspoelt. Alerts worden gepost naar een Discord-webhook, naar je eigen webhook-endpoints, of beide.

Alertregels zitten bij een plan: 5 op Starter, tot 100 op Ultra.

Retentie en prijs

Logs zitten in elk plan, niet als los abonnement verkocht. Ze tellen mee in dezelfde opslag als je bestanden en worden bewaard volgens de retentie van je plan: Free 3 days, Starter 30 days, Pro 90 days, Business 90 days, Ultra 180 days. Een vol quotum geeft een duidelijke foutmelding in plaats van events stilletjes te laten vallen.