observability instrumentation

You can't improve what you can't measure. You can't debug what you can't observe.

❌ Log spamming: Logging everything (noise overwhelms signal) ❌ Unstructured logs: String concatenation instead of structured fields ❌ Synchronous logging: Blocking on log writes (use async handlers) ❌ Missing context: Logs without request ID or user context ❌ Metrics explosion: Too many unique label combinations (cardinality issues)

Status: ✅ Production-ready | 23-46x speedup | 90-95% transferable | Validated in meta-cc

منهجية شاملة لقابلية المراقبة تنفذ ثلاث ركائز (السجلات والمقاييس والتتبعات) مع تسجيل منظم باستخدام Go slog ومقاييس على طراز Prometheus وأنماط التتبع الموزعة. يُستخدم عند إضافة إمكانية المراقبة من البداية، أو السجلات غير المنظمة أو غير الكافية، أو عدم جمع المقاييس، أو صعوبة تصحيح أخطاء الإنتاج، أو الحاجة إلى مراقبة الأداء. يوفر أنماط تسجيل منظمة (التسجيل السياقي، ومستويات السجل DEBUG/INFO/WARN/ERROR، ونشر معرف الطلب)، وأدوات المقاييس (أنماط العداد/المقياس/الرسم البياني، وعرض Prometheus)، وإعداد التتبع (إنشاء الامتداد، ونشر السياق، واستراتيجيات أخذ العينات)، وأفضل ممارسات Go slog (تنسيق JSON، وإدارة السمات، وتكوين المعالج). تم التحقق من صحته في meta-cc مع تسريع 23-46x مقابل التسجيل المخصص، وقابلية النقل بنسبة 90-95% عبر اللغات (الشعار خاص بـ Go ولكن الأنماط عالمية). المصدر: zpankz/mcp-skillset.