Loglash

• Kirish
• Konfiguratsiya
• Mavjud kanal haydovchilari
  • Kontekstni kiritish
• Log xabarlarini yozish
  • Muayyan kanalga yozish
• Zanjir usullari
• Maxsus kanal yaratish
  • Haydovchini amalga oshirish

Kirish

Ilovaning ishlash holatini tushunish uchun Goravel kuchli log xizmatini taqdim etadi, u log xabarlari va tizim xatolarini facades.Log() orqali fayl yoki boshqa kanallarga yozishi mumkin.

Konfiguratsiya

Turli log kanallarini sozlash uchun config/logging.go faylida maxsus konfiguratsiyalar amalga oshirilishi mumkin.

Goravel sukut bo'yicha loglarni yozish uchun stack kanalidan foydalanadi, stack loglarni bir nechta kanallarga yo'naltirish imkonini beradi.

single va daily haydovchilaridagi print konfiguratsiyasi log chiqishini konsolga boshqarishi mumkin.

level konfiguratsiyasi minimal log darajasini boshqaradi. Ushbu darajadan past boʻlgan loglar filtrlangan boʻladi. Mavjud darajalar: debug (standart), info, warning, va error.

Mavjud kanal haydovchilari

Nomi	Tavsifi
stack	Bir nechta kanallarga ruxsat berish
single	Yagona log fayli
daily	Kuniga bitta log fayli
custom	Maxsus haydovchi

Kontekstni kiritish

facades.Log().WithContext(ctx)

WithContext ishlatilganda, Goravel kontekst kalit-qiymat juftliklarini log chiqishiga yozadi. GoravelAuthJwt va goravel_http_client_name kabi framework ichki kalitlari maxfiy yoki shovqinli qiymatlarni sizishning oldini olish uchun avtomatik ravishda chiqarib tashlanadi.

config/logging.go fayliga context.exclude qo‘shish orqali qo‘shimcha kontekst kalitlarini chiqarib tashlashingiz mumkin:

// config/logging.go
"context": map[string]any{
  "exclude": []any{
    "access_token",
    "secret_key",
  },
},

String yozuvlar string kontekst kalitlariga va ko‘rsatilgan nomi bo‘yicha tiplangan string kontekst kalitlariga mos keladi. Taqqoslanadigan string bo‘lmagan yozuvlar aniq kontekst kalit qiymatiga mos keladi, bu struct sentinel kalitlari uchun foydalidir. Slice yoki map kabi taqqoslab bo‘lmaydigan yozuvlar e'tiborga olinmaydi.

Log xabarlarini yozish

facades.Log().Debug(message)
facades.Log().Debugf(message, args)
facades.Log().Info(message)
facades.Log().Infof(message, args)
facades.Log().Warning(message)
facades.Log().Warningf(message, args)
facades.Log().Error(message)
facades.Log().Errorf(message, args)
facades.Log().Fatal(message)
facades.Log().Fatalf(message, args)
facades.Log().Panic(message)
facades.Log().Panicf(message, args)

Muayyan kanalga yozish

Ba'zan, siz xabarlarni ilovaning sukut bo'yicha kanalidan boshqa kanalga yozishni xohlashingiz mumkin:

facades.Log().Channel("single").Info(message)

Agar siz bir vaqtning o'zida bir nechta kanallarga yozishni istasangiz, Stack usulidan foydalanishingiz mumkin:

facades.Log().Stack([]string{"single", "slack"}).Info(message)

Zanjir usullari

Goravel qulay zanjir usullarini taqdim etadi, ular logga foydali ma'lumotlarni qo'shishni osonlashtiradi:

facades.Log().User("John").Debug(message)

Usul	Harakat
Kod	Logni tavsiflovchi kod yoki slug'ni o'rnating.
Maslahat	Tezroq tuzatish uchun maslahat o'rnating.
Ichida	Log yozuvining tegishli bo'lgan funksiya toifasi yoki domenini o'rnating.
Egasi	Ogohlantirish maqsadlari uchun foydali.
Request	Http.Request'ni ta'minlaydi.
Response	Http.Response'ni ta'minlaydi.
Teglar	Xatoni qaytaradigan funksiyani tavsiflovchi bir nechta teglarni qo'shing.
Foydalanuvchi	Log yozuvi bilan bog'liq foydalanuvchini o'rnating.
Bilan	Log yozuvi kontekstiga kalit-qiymat juftliklarini qo'shing.
WithTrace	Log yozuviga stack ma'lumotlarini qo'shing.

Maxsus kanal yaratish

Agar siz to'liq maxsus kanal aniqlashni istasangiz, config/logging.go konfiguratsiya faylida custom haydovchi turini ko'rsatishingiz mumkin. Keyin framework\contracts\log\Logger strukturini amalga oshirish uchun via opsiyasini qo'shing:

// config/logging.go
"custom": map[string]interface{}{
    "driver": "custom",
    "via":    &CustomLogger{},
},

Haydovchini amalga oshirish

framework\contracts\log\Logger interfeysini amalga oshiring.

// framework/contracts/log/Logger
package log

type Logger interface {
  // Handle pass channel config path here
  Handle(channel string) (Handler, error)
}

Siz ma'lumot uchun daily va single log haydovchilarini tekshirishingiz mumkin:

• Kunlik
• Yagona