Logi FiveM, które możesz przeszukiwać, z alertami na Discordzie.

Czemu kanały Discord są słabym miejscem na logi

Większość serwerów FiveM zaczyna logować w ten sam sposób: każdy resource wysyła embed na webhook Discord, jeden kanał na kategorię. Działa pierwszego dnia. Po trzech miesiącach kanały mają setki tysięcy wiadomości, wyszukiwanie Discorda nie umie filtrować po kwocie czy licencji, limity webhooka gubią zdarzenia w godzinach szczytu, a screenshoty dołączone do tych wiadomości zmieniają się w linki, które wygasają.

BasiX zachowuje tę część, która działa — powiadomienie na Discordzie, gdy potrzebny jest człowiek — a sam zapis przenosi tam, gdzie można go przeszukać. Twój staff wciąż otrzymuje ping; klika dalej do wyszukiwania, a nie przewija.

Wysyłanie zdarzeń z FiveM

Zainstaluj resource basix, ustaw swój klucz w server.cfg i wywołuj exports.basix:info, warn, error lub debug z każdego resource. Zdarzenia są buforowane i wysyłane co dwie sekundy w jednym żądaniu, a do 400 trzymanych jest w pamięci, jeśli API jest nieosiągalne, więc krótka przerwa nie gubi zapisu o banie. Wywołujący resource jest wypełniany automatycznie.

Wszystko, co może wykonać żądanie HTTP, może też logować: POST https://basix.media/api/v1/logs z dataset i do 500 zdarzeń na żądanie. Endpoint przyjmuje 240 żądań na minutę na klucz, co wystarcza, gdy zdarzenia są grupowane w partie.

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

Logi gracza: jeden profil na gracza

Każde zdarzenie wysłane z polem player tworzy profil: pierwsze i ostatnie wystąpienie, liczby zdarzeń na kategorię oraz identyfikatory znalezione w metadata — license, license2, discord, steam, fivem, xbl, live, rockstar i citizenid. Twój zespół może dodać nazwę wyświetlaną, wewnętrzne notatki i własne pola, więc historia gracza, który wciąż jest zgłaszany, to jedna strona, a nie wyszukiwanie w dziesięciu kanałach.

Kategorie, kolumny i zapisane widoki

Każdy dataset może stać się kategorią z etykietą, kolorem, ikoną i grupą oraz z kolumnami odczytywanymi z metadata: log ekonomii może pokazywać amount i source jako prawdziwe kolumny, log pojazdów — numer rejestracyjny. Zapisane widoki przechowują zestaw filtrów — kategorie, poziomy, gracza, resource, tekst i zakres czasu — i domyślnie są udostępniane twojemu zespołowi, więc moderator na zmianie otwiera ten sam widok, który zbudował główny admin.

Alerty na Discord, gdy to ma znaczenie

Reguła alertu uruchamia się, gdy liczba zdarzeń spełniających warunki napłynie w danym okresie — na przykład trzy zdarzenia warn lub error w kategorii ekonomii w ciągu pięciu minut, z metadata source równym admin. Potem milczy przez wybrany przez ciebie cooldown, więc nagły wysyp nie zalewa kanału. Alerty trafiają na webhook Discord, na twoje własne endpointy webhook albo na oba.

Reguły alertów są częścią planu: 5 na planie Starter, do 100 na najwyższym.

Retencja i cena

Logi są wliczone w każdy plan, nie sprzedawane jako osobna subskrypcja. Wliczają się w to samo miejsce co twoje pliki i są przechowywane przez okres retencji twojego planu: Free 3 days, Starter 30 days, Pro 90 days, Business 90 days, Ultra 180 days. Pełny limit odpowiada jawnym błędem, a nie cichym odrzucaniem zdarzeń.