C# Academy · درس

الركائز الثلاث لقابلية المراقبة

افهموا آثار التتبع والمقاييس والسجلات

الدرس 1 من 413 خطوة

الركائز الثلاث لقابلية المراقبة درس مجاني في C# Academy على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في C# Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة C# Academy 4 دروس في المجموع.

ما هي قابلية المراقبة؟

قابلية المراقبة هي القدرة على فهم الحالة الداخلية لنظام ما من البيانات التي يصدرها. وبالنسبة إلى خدمة قيد التشغيل، فهي تجيب عن الأسئلة التالية: هل الخدمة سليمة؟ ولماذا هي بطيئة؟ وما الذي فشل؟ وترتكز على ثلاثة أعمدة: التتبعات والمقاييس والسجلات.

ما هو OpenTelemetry؟

OpenTelemetry أو OTel هو معيار ومجموعة مكتبات محايدة تجاه المورّد لإنشاء بيانات القياس عن بُعد وتصديرها. ومن خلال عملية تهيئة واحدة، يمكنكم إرسال البيانات إلى خلفيات متعددة مثل Jaeger وPrometheus وGrafana.

dotnet add package OpenTelemetry.Extensions.Hosting

العمود الأول: السجلات

السجلات هي سجلات مؤرخة لأحداث منفصلة، مثل «سجّل المستخدم 42 الدخول» أو «فشلت عملية الدفع». وتوفر سياقًا تفصيليًا مقروءًا للبشر، لكنها قد تكون كثيرة الضجيج ويصعب تجميعها بمفردها.

logger.LogInformation("Order {OrderId} placed by {UserId}", orderId, userId);

العمود الثاني: المقاييس

المقاييس هي قياسات رقمية مجمّعة بمرور الوقت، مثل عدد الطلبات ومعدل الأخطاء والنسب المئوية لزمن الاستجابة واستخدام وحدة المعالجة المركزية. وتتميز بانخفاض تكلفة تخزينها، كما أنها مثالية للوحات المعلومات والتنبيهات.

العمود الثالث: التتبعات

تتبع التتبعات طلبًا واحدًا أثناء مروره عبر خدماتكم، وتقسمه إلى فترات زمنية. وتكشف أين يُستنفد الوقت وأي تبعية تسببت في التباطؤ.

كيف تتكامل الأعمدة معًا

تخبركم المقاييس بأن هناك مشكلة، مثل ارتفاع معدل الأخطاء. وتخبركم التتبعات بمكانها، مثل خدمة الدفع. أما السجلات فتخبركم بسببها، مثل مرجع فارغ لطلب محدد. وتشكل هذه العناصر معًا قصة متكاملة لتصحيح الأخطاء.

الترابط هو المفتاح

تظهر القوة الحقيقية من خلال الترابط. إذ يتيح معرّف التتبع المشترك، المضاف إلى السجلات والفترات، الانتقال من تنبيه مقياس إلى التتبع الدقيق وسجلات طلب واحد فاشل.

الإشارات في OpenTelemetry

يطلق OTel على هذه الأعمدة اسم الإشارات. وتربطها .NET بالبدائيات المألوفة: تستخدم التتبعات Activity/ActivitySource، وتستخدم المقاييس Meter، وتستخدم السجلات ILogger.

إضافة OpenTelemetry إلى مضيف

يمكنكم تفعيل الإشارات باستخدام AddOpenTelemetry() وتهيئة التتبع والمقاييس. وسنتناول كلًا منها بالتفصيل في الدروس التالية.

builder.Services.AddOpenTelemetry()
    .WithTracing(tracing => { })
    .WithMetrics(metrics => { });

سمات الموارد

يصف المورد الكيان الذي ينتج بيانات القياس عن بُعد، مثل اسم الخدمة وإصدارها وبيئتها. ويسمح تعيينه بشكل متسق للأنظمة الخلفية بتجميع بياناتكم وتصفيتها بشكل صحيح.

builder.Services.AddOpenTelemetry()
    .ConfigureResource(r => r.AddService(
        serviceName: "checkout-api",
        serviceVersion: "1.4.0"));

القياس التلقائي مقابل اليدوي

يوفّر OTel قياسًا تلقائيًا لـ ASP.NET Core وHttpClient وغيرهما، بالإضافة إلى القياس اليدوي الذي تضيفون فيه نطاقات ومقاييس خاصة بكم للحصول على رؤى مرتبطة بالعمل.

اختبار سريع

اختبروا الركائز الثلاث.

مراجعة

تستند قابلية المراقبة إلى ثلاث ركائز: السجلات (الأحداث، أي السبب)، والمقاييس (الأرقام المجمعة، أي ما حدث)، وآثار التتبع (النطاقات لكل طلب، أي المكان). ويُعد OpenTelemetry المعيار المحايد تجاه المورّدين الذي يصدر الركائز الثلاث على شكل إشارات، ويطابقها في .NET مع Activity وMeter وILogger. ويربطها معًا استخدام معرّفات التتبع وتعيين مورد بشكل صحيح.

البدء مجانًا

تعلم C# مع معلم ذكاء اصطناعي — مجانًا

اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.

الدورات
93
الدروس
346

الأسئلة الشائعة

هل درس «الركائز الثلاث لقابلية المراقبة» مجاني؟

نعم — نص درس «الركائز الثلاث لقابلية المراقبة» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة C# Academy، انتقل إلى CoddyKit PRO. تتضمن دورة C# Academy 4 دروس في المجموع.

ماذا ستتعلم في «الركائز الثلاث لقابلية المراقبة»؟

افهموا آثار التتبع والمقاييس والسجلات تتمرن على C# Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ C# Academy؟

لا تُشترط خبرة سابقة. C# Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.

كم من الوقت يستغرق درس «الركائز الثلاث لقابلية المراقبة»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس C# Academy هذا؟

نعم. كل درس في C# Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. الركائز الثلاث لقابلية المراقبة
  2. التتبع الموزّع
  3. جمع المقاييس
  4. التصدير إلى الأنظمة الخلفية
← العودة إلى C# Academy