ما هو التوصيف (Observability) ولماذا يعتبر مهمًا في تصميم الأنظمة؟

Question

Accepted Answer

**التوصيف (Observability)** هو القدرة على فهم الحالة الداخلية للنظام من خلال مخرجاته الخارجية — عبر **السجلات (logs)**، **المقاييس (metrics)**، و**التتبع (traces)**. وهو ضروري لتشغيل الأنظمة وتصحيح الأخطاء والحفاظ عليها (خاصة الأنظمة الموزعة)، حيث لا يمكنك إدارة ما لا تستطيع رؤيته.

## الأركان الثلاثة للتوصيف

```text
LOGS → timestamped records of events (what happened) → detailed, for debugging specific issues
METRICS → numerical measurements over time (CPU, latency, request rate, error rate) →
  aggregate health/performance; dashboards; alerting
TRACES → follow a request's path through the system (across services) → understand flows,
  find bottlenecks/failures in DISTRIBUTED systems (which service was slow?)
→ together: understand WHAT happened, the OVERALL state, and the PATH of requests.
```

## لماذا يعتبر التوصيف مهمًا

```text
✓ You can't operate/debug what you can't SEE → essential for understanding system behavior
✓ DETECT problems → metrics + alerting catch issues (before/as users hit them)
✓ DEBUG → logs and traces find root causes (especially in distributed systems where a
  request crosses many services — hard to debug without tracing)
✓ UNDERSTAND performance → find bottlenecks, optimize
✓ Maintain RELIABILITY → observability enables fast detection and resolution (lower MTTR)
```

## التوصيف مقابل المراقبة

```text
MONITORING → watching KNOWN metrics/conditions (predefined dashboards, alerts) → "is it
  working?"
OBSERVABILITY → ability to ASK NEW questions / explore the unknown → "WHY is it behaving
  this way?" (debug novel/unexpected issues)
→ observability is broader → understand system behavior, including unforeseen problems
✓ practices: structured logging, distributed tracing (OpenTelemetry), good metrics, alerting
```

## لماذا يهمك الأمر

فهم التوصيف يعتبر معرفة على مستوى عالٍ لأن **تشغيل والحفاظ على الأنظمة يتطلب فهم سلوكها**، والتوصيف ضروري لذلك (خاصة في الأنظمة الموزعة)، لذا فهو جانب أساسي من تصميم أنظمة قابلة للتشغيل.

التوصيف — فهم الحالة الداخلية للنظام من خلال مخرجاته الخارجية — ضروري لأن **لا يمكنك إدارة أو تشغيل أو تصحيح ما لا تستطيع رؤيته**، مما يجعله حاسمًا لتشغيل الأنظمة بشكل موثوق.

فهم **الأركان الثلاثة** — **السجلات (logs)** (سجلات الأحداث للتصحيح التفصيلي)، **المقاييس (metrics)** (القياسات الرقمية لصحة النظام الإجمالية والرسوم البيانية والتنبيهات)، و**التتبع (traces)** (تتبع مسار الطلب عبر الخدمات) — وكيف تسمح مجتمعة بفهم ما حدث والحالة الإجمالية وتدفقات الطلبات، هو المعرفة الأساسية. **التتبع** مهم بشكل خاص في الأنظمة الموزعة، حيث يعبر الطلب العديد من الخدمات وعملية تصحيح الأخطاء صعبة جدًا بدون تتبع المسار لاكتشاف أي خدمة كانت بطيئة أو فشلت.

فهم **لماذا يعتبر التوصيف مهمًا** — كونه ضروريًا لتشغيل وتصحيح الأنظمة، واكتشاف المشاكل (المقاييس والتنبيهات تكتشف المشاكل)، وتصحيح الأسباب الجذرية (السجلات والتتبع، خاصة في الأنظمة الموزعة)، وفهم الأداء، وتمكين الكشف والحل السريع (انخفاض MTTR للموثوقية) — يوضح دوره التشغيلي الحاسم.

فهم **التوصيف مقابل المراقبة** — مراقبة الحالات المعروفة ("هل يعمل؟") مقابل التوصيف الذي يمكّن من طرح أسئلة جديدة واستكشاف المجهول ("لماذا يتصرف بهذه الطريقة؟"، تصحيح المشاكل الجديدة) — يعكس المفهوم الأعمق للقدرة على فهم المشاكل التي لم نتوقعها، وهو مهم للأنظمة المعقدة.

تصميم الأنظمة مع مراعاة التوصيف (السجلات المنظمة، التتبع الموزع، المقاييس الجيدة، التنبيهات) ضروري للأنظمة القابلة للتشغيل والصيانة.

بما أن تشغيل والحفاظ على الأنظمة يتطلب فهم سلوكها والتوصيف (السجلات والمقاييس والتتبع) ضروري لذلك — خاصة في الأنظمة الموزعة حيث تصحيح الأخطاء صعب بدونه — وبما أنه يمكّن من اكتشاف وتصحيح وحل المشاكل بسرعة، فإن فهم التوصيف يعتبر معرفة على مستوى عالٍ — ضروري لتشغيل والحفاظ على الأنظمة بشكل موثوق، جانب أساسي من تصميم أنظمة قابلة للتشغيل (خاصة الأنظمة الموزعة حيث يكون التتبع حاسمًا)، وينعكس النضج التشغيلي المتوقع للأدوار الراقية الذين يصممون أنظمة يجب أن تُفهم وتُصحح وتُبقى موثوقة في الإنتاج.