Entegrasyon
Loglama
Konsol, dosya ve Discord loglaması: webhook grupları, event listesi, gizlilik anahtarları ve gönderim.
Bu sayfadaki her şey config_server.lua içinde ServerConfig.Logs altında ayarlanır. Ayarlar tablosu config_server.lua sayfasındadır.
#Event'ler nereye gider
| Çıktı | Neyle kontrol edilir |
|---|---|
| Konsol | Logs.Console |
logs/fx-phone-<yyyy-mm-dd>.log |
Logs.File. Son 7 gün saklanır |
| Discord | Event'in kendi webhook'u, yoksa grubun Logs.Webhooks içindeki girdisi |
Bir event'te enabled = false onu her yerde durdurur. God adminler yönetim tabletinden, yeniden başlatmadan bütün grupları kapatabilir.
#Grup başına bir webhook
En hızlı kurulum, her alan için bir Discord kanalıdır. Discord'da görmek istediğin her grubun yanına bir webhook adresi koy, diğerlerini boş bırak:
luaWebhooks = {
phone = '',
calls = '',
messages = '',
bank = '',
invoices = '',
media = '',
social = '',
marketplace = '',
news = '',
darkchat = '',
sim = '',
shop = '',
admin = '',
},
Boş bir grup yine de konsola (Console = true ile) ve günlük dosyaya yazılır, yalnızca Discord'a gitmez.
Bir event'in grubu, adının ilk kısmına göre belirlenir:
| Grup | Event önekleri |
|---|---|
phone |
phone. |
calls |
call. |
messages |
message., group., cash. |
bank |
bank., crypto. |
invoices |
invoice. |
media |
media., airdrop. |
social |
account., post., comment., report., social. |
marketplace |
listing. |
news |
news. |
darkchat |
channel. |
sim |
sim. |
shop |
shop. |
admin |
admin. |
Başka bir öneki olan event'lerin (appstore., mail., coins., cases., wallet., live.) grubu yoktur. Konsola ve dosyaya gider, Discord'a ise yalnızca event'in kendi webhook'u varsa gider.
#Event'ler
| Alan | Event'ler |
|---|---|
| Telefon | phone.setup, phone.numberChanged, phone.wipe, phone.factoryReset, phone.unauthorized |
| Aramalar | call.started, call.ended, call.missed, call.video |
| Mesajlar | message.sent, message.deleted, group.created, group.memberAdded, group.memberRemoved, group.left, cash.sent, cash.requested, cash.accepted |
| Banka | bank.transfer, bank.invoicePaid, bank.move, bank.account, crypto.buy, crypto.sell, crypto.transfer |
| Faturalar | invoice.sent, invoice.paid, invoice.deleted |
| Medya | media.uploaded, media.deleted, airdrop.sent |
| Sosyal | account.created, account.login, account.passwordChanged, account.verified, account.unverified, post.created, post.deleted, comment.created, comment.deleted, report.created, social.match, social.goldPurchased |
| Pazar Yeri | listing.created, listing.deleted |
| Haberler | news.created, news.edited, news.deleted |
| Darkchat | channel.created, channel.joined, channel.message |
| SIM | sim.issued, sim.registered, sim.inserted, sim.ejected, sim.blocked, sim.unblocked, sim.reissued, sim.transferred |
| Mağaza | shop.purchase, shop.duty, shop.restock, shop.price |
| Yönetim | admin.opened, admin.appToggled, admin.settingChanged, admin.accountBanned, admin.accountUnbanned, admin.accountDeleted, admin.accountRestored, admin.credentialsChanged, admin.postDeleted, admin.postRestored, admin.commentDeleted, admin.listingDeleted, admin.userNumberSet, admin.userWiped, admin.userReset, admin.reportResolved, admin.channelClosed, admin.memberKicked, admin.backupCreated, admin.backupRestored, admin.simAction, admin.shopUpdated, admin.unauthorized |
| Grupsuz | appstore.review_removed, mail.sent, coins.launch, coins.trade, coins.edit, cases.publish, cases.buy, cases.store, cases.resale, wallet.give, live.start, live.stop, live.gift |
#Event başına
luaEvents = {
['message.sent'] = { enabled = false, color = BLUE }, -- off everywhere
['bank.transfer'] = { enabled = true, color = GOLD, webhook = 'your-webhook-address' }, -- its own channel
}
enabled = false, event'i konsolda, dosyada ve Discord'da durdurur. webhook, o event'i grubundan farklı bir yere gönderir. color, embed rengidir ve ondalık sayı olarak yazılır; dosya BLUE, GREEN, ORANGE, RED, PURPLE, GOLD ve GREY değerlerini tanımlar.
message.sent ve channel.message en kalabalık event'lerdir: her sohbet mesajı için bir girdi. Çoğu sunucu messages ve darkchat webhook'larını boş bırakarak bunları yalnızca dosyaya gönderir.
#Gizlilik anahtarları
| Ayar | Varsayılan | Ne yapar |
|---|---|---|
ShowIp |
false |
Dosyada IP, Discord'da spoiler olarak IP |
ShowCoords |
true |
Oyuncunun konumu |
ShowTokens |
false |
Dosyada donanım token'ları, Discord'da sayıları |
DiscordBotToken |
boş | Bir bot token'ı, logun id'lerin yanında Discord kullanıcı adlarını göstermesini sağlar. 10 dakikada bir sorgulanır |
PIN'ler, şifreler, yükleme anahtarları ve webhook adresleri asla loglanmaz. Konsolda bir webhook webhook#<id> olarak görünür.
#Bir girdide neler bulunur
Dosyadaki bir satırda zaman, event adı, bir özet cümlesi, event'in bağlam alanları ve oyuncu için bir kimlik bloğu bulunur: FiveM adı ve server id'si, karakter adı ve identifier'ı, meslek, bağlı identifier'lar, ping ve ShowCoords açıksa konum. Diğer oyuncu çevrimiçiyse ikinci bir kimlik bloğu gelir.
Discord embed'i aynı içeriği taşır: başlık, özet, Discord zaman damgası olarak tarih, bağlam alanları, değişikliklerde eski ve yeni değerler ve kimlik blokları. Etiketlemeler kapalıdır.
#Dil
Log metni locales/<code>.json içinde logs.* altından gelir. Logs.Locale = nil, Config.Locale'i kullanır. Varsayılan dili başka olan bir sunucuda logları İngilizce tutmak için Logs.Locale = 'en' ayarla.
Her event'in değiştirebileceğin logs.<event>.title ve logs.<event>.summary anahtarları vardır.
#Gönderim
- Her webhook adresi için bir kuyruk; yaklaşık 2 saniyede bir mesaj.
- Discord hız sınırları (429), Discord'un istediği süreden sonra en fazla 5 kez yeniden denenir.
- Adres başına en fazla 150 mesaj bekler. Kuyruk dolduğunda en eskisi atılır.
- Atılan mesajlar konsolda sayılır:
[fx-phone:logs] webhook#123: log dropped (HTTP 404), 3 lost so far. - Discord çalışmıyorken bile dosya yazılır.
- Yavaş bir Discord bir oyuncunun isteğini asla engellemez.
#Dosyalar
logs/fx-phone-<yyyy-mm-dd>.log, her event için bir satır, 7 gün saklanır. Taşıma raporu da logs/ içine kaydedilir.
#Denetim kaydı
Yönetim tableti işlemleri ayrıca veritabanındaki bir denetim kaydına yazılır ve Config.Admin.AuditDays gün saklanır. Bkz. Yönetim.