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.