السجلّات مفيدة فقط إذا استطعت الاستعلام عنها. وبضعة أعراف تحوّل جدارًا من النصوص إلى سِجِلٍّ قابل للبحث لسلوك الإنتاج.
البنية قبل النصوص
الحقول المنظّمة تتفوّق على الرسائل الحرّة. فمفاتيح ثابتة مثل service وroute وstatus تتيح لك الترشيح بدقة بدل البحث النصّي.
سجلّ منظّم
level=info service=api-gateway route=/api/v1/projects status=200 ms=42
level=warn service=postgres-primary query=users.find ms=412
level=error service=billing-service trace_id=astk_trace_92jx status=500
احمل معرّف التتبّع دائمًا
معرّف التتبّع على كل سطر سجلّ هو أثمن حقل منفرد — فهو يربط السجلّ بمسار الطلب الكامل.
سجّل القرارات، لا الضجيج
سجّل النقاط التي يتفرّع عندها السلوك أو يفشل. فالتسجيل التشخيصي الكثيف يدفن السطور المهمّة.