Asosiy xulosa
Har yozuvni tashxis savoliga bogʻlang: qaysi amal ishlamadi, qaysi xizmat taʼsirlandi va qachon? Parol, token va keraksiz shaxsiy maʼlumotlarni jurnallarga kiritmang.
Jurnal qaysi savolga javob berishi kerak?
Ilova jurnali dastur ishlashida yaratilgan vaqt belgili hodisalarni qayd etadi. Ishga tushish va oʻchish, soʻrov natijalari, kutilmagan xatolar, tashqi xizmatlarga muvaffaqiyatsiz chaqiruvlar va sozlama oʻzgarishlari turli tekshiruv savollariga javob beradi. OT va server jurnallari atrofdagi muhitni ifodalaydi; ilova jurnallari esa ilova nima qilmoqchi boʻlganini tushuntirishi mumkin.
Amal
Soʻrov, vazifa yoki integratsiyaning boshlanishi va natijasi.
Xato
Foydalanuvchiga taʼsir qiladigan istisno, ishlamagan bogʻliqlik yoki nosozlik.
Oʻzgarish
Yangi versiya, sozlama yoki imtiyoz oʻzgarishining vaqti va bajaruvchisi.
Hodisani tushuntiradigan maydonlarni tanlang
Izchil maydonlar yozuvlarni qidirish va solishtirishni osonlashtiradi. Koʻpincha vaqt, daraja, xizmat va muhit, hodisa turi, natija, qisqa xabar, soʻrov yoki kuzatuv identifikatori va xavfsiz boʻlsa xato kodi foydali. Xizmatlararo hodisalarni solishtirishda soatlarni sinxronlang va vaqt mintaqasini aniq koʻrsating. Har yozuv barcha mumkin boʻlgan tafsilotlarni olishi shart emas.
Vaqt va manba
UTC yoki aniq vaqt mintaqasi; xizmat, versiya va muhit.
Hodisa va natija
Barqaror hodisa nomi, natija va tanlangan jurnal darajasi.
Oʻzaro bogʻlash
Soʻrov IDsi va mavjud boʻlsa trace/span IDlari; identifikatorning oʻzi sir yoki hisob tafsiloti boʻlmasligi kerak.
Darajalarni izchil qoʻllang
Daraja yozuv qanchalik shoshilinch eʼtibor talab qilishini bildiradi, ammo nomlar va aniq maʼnolar jurnallash kutubxonasiga bogʻliq. Jamoa uchun qisqa lugʻatni kelishing: qoʻshimcha ishlab chiqish tafsiloti uchun DEBUG, odatiy bosqichlar uchun INFO, kutilmagan, ammo tiklanadigan holatga WARN, muvaffaqiyatsiz amalga ERROR va jiddiy qism nosozligiga CRITICAL/FATAL. Xizmatlar orasidagi nomuvofiq darajalar ogohlantirish qoidalarini zaiflashtiradi.
DEBUG / TRACE
Batafsil tashxis; ishlab chiqarish muhitida hajm va sezgir maydonlarni cheklang.
INFO / WARN
Odatiy rivojlanish va hali nosozlik boʻlmagan kuzatiladigan holatlarni ifodalaydi.
ERROR / CRITICAL
Funksiya ishlamasa yoki taʼsir kengroq boʻlsa, eskalatsiyani qoʻllaydi.
Tuzilmali yozuvlarni oʻqishga qulay saqlang
JSON kabi tuzilmali format har hodisaga izchil kalitlar berib, matn qidiruvi va maydon boʻyicha filtrlash yoki bogʻlashni taʼminlaydi. Xizmatlar boʻylab maydon nomlari va turlarini izchil saqlang. Qisqa xabar ishlating, xato turi va amal kontekstini alohida maydonlarga qoʻying, foydali boʻlsa toʻliq chaqiruv steki izini saqlang. JSONL — har satrda bitta JSON obyekti boʻlgan keng tarqalgan format.
{"timestamp":"2026-10-09T08:30:00Z","level":"ERROR","service":"billing-api","event":"payment_authorization_failed","request_id":"req-7f21","error_code":"upstream_timeout"}
Sirlar va keraksiz shaxsiy maʼlumotlarni kiritmang
Soʻrov kontenti, URL parametrlari, kukilar, tokenlar, parollar va toʻliq foydalanuvchi tafsilotlari beixtiyor jurnallarga kirishi mumkin. Sezgir qiymatlarni yigʻish nuqtasida olib tashlang yoki niqoblang, faqat belgilangan maqsad uchun kerakli maydonlarni saqlang. Uzatish va saqlashda kirishni nazorat qiling, imtiyozlarni cheklang va oʻzgarish tarixini saqlang.
Har bir hodisani qayd etish kerakmi?
Yoʻq. Muhim amallar va tekshiruv savollarini tanlang; ortiqcha shovqin foydali yozuvlarni yashirishi mumkin.
Daraja nomlari hamma joyda bir xilmi?
Yoʻq. Kutubxona va platformalar farq qiladi; maʼno va moslash qoidalaringizni hujjatlashtiring.