مراقبة تطبيقات C#: المقاييس والتنبيهات من الألف إلى الياء

مقدمة: لماذا تعتبر المراقبة أمرًا حيويًا لتطبيقات C#

في تطوير البرمجيات الحديثة، كتابة الكود ليست سوى نصف المهمة. لكي يعمل التطبيق بشكل مستقر وسريع وقابل للتنبؤ، هناك حاجة إلى مراقبة مستمرة. بالنسبة لتطبيقات C# (.NET)، التي تُستخدم غالبًا في الأنظمة المؤسسية عالية التحميل والقطاع المصرفي والتجارة الإلكترونية والخدمات السحابية، تصبح المراقبة ليست مجرد خيار بل متطلبًا إلزاميًا.

بدون مراقبة، أنت تعمل بشكل أعمى: تظل تسريبات الذاكرة غير مكتشفة حتى تعطل الخادم، وتتراكم الطلبات البطيئة، ويغادر المستخدمون إلى المنافسين. في هذه المقالة، سنشرح دورة كاملة لإعداد قابلية المراقبة (observability) لتطبيقات C#: من جمع المقاييس الأساسية إلى إعداد التنبيهات الذكية في الوقت الفعلي.

1. أساسيات المراقبة: ما المقاييس التي يجب جمعها في .NET

قبل إعداد الأدوات، من المهم فهم المقاييس المهمة حقًا لتطبيقات C#. سنقسمها إلى ثلاث مجموعات:

1.1. مقاييس النظام (مستوى البنية التحتية)

\n
• CPU و Memory — تحميل المعالج واستهلاك الذاكرة العشوائية لعملية dotnet.
\n
• GC (Garbage Collection) — تكرار ومدة عمليات جمع القمامة، حجم الأكوام (Gen0, Gen1, Gen2, LOH).
\n
• Thread Pool — عدد الخيوط النشطة والحرة والمنتظرة.
\n
• Disk I/O و Network — القراءة/الكتابة على القرص، الاتصالات الشبكية.
\n

1.2. مقاييس الأعمال (مستوى التطبيق)

\n
• Request Rate — عدد الطلبات في الثانية (RPS).
\n
• Latency — وقت الاستجابة (النسب المئوية p50, p95, p99).
\n
• Error Rate — نسبة أخطاء 4xx و 5xx.
\n
• Active Users — عدد المستخدمين النشطين في وقت واحد.
\n

1.3. مقاييس .NET Runtime

\n
• JIT Compilation — وقت ترجمة الطرق.
\n
• Assembly Loading — عدد التجميعات المحملة.
\n
• Exceptions — عدد الاستثناءات الملقاة في الثانية.
\n

لجمع هذه المقاييس في .NET، تُستخدم أداة قوية — System.Diagnostics.Metrics (API مدمج منذ .NET 6+) ومكتبة OpenTelemetry.

2. إعداد جمع المقاييس باستخدام OpenTelemetry و Prometheus

أفضل طريقة لتنظيم مراقبة تطبيق C# هي استخدام مجموعة OpenTelemetry (جمع المقاييس) + Prometheus (التخزين) + Grafana (التصور). دعنا نستعرض الإعداد خطوة بخطوة.

2.1. تثبيت حزم NuGet

أضف الحزم التالية إلى المشروع:

dotnet add package OpenTelemetry.Extensions.Hosting\ndotnet add package OpenTelemetry.Exporter.Prometheus.AspNetCore\ndotnet add package OpenTelemetry.Instrumentation.AspNetCore\ndotnet add package OpenTelemetry.Instrumentation.Runtime

2.2. التكوين في Program.cs

قم بإعداد OpenTelemetry لجمع مقاييس ASP.NET Core و .NET Runtime تلقائيًا:

using OpenTelemetry.Metrics;\n\nvar builder = WebApplication.CreateBuilder(args);\n\nbuilder.Services.AddOpenTelemetry()\n    .WithMetrics(metrics => metrics\n        .AddAspNetCoreInstrumentation() // مقاييس طلبات HTTP\n        .AddRuntimeInstrumentation()    // مقاييس GC, JIT, ThreadPool\n        .AddPrometheusExporter());      // التصدير إلى Prometheus\n\nvar app = builder.Build();\n\napp.UseOpenTelemetryPrometheusScrapingEndpoint(); // نقطة النهاية /metrics\n\napp.Run();

الآن، سيكون عنوان http://localhost:5000/metrics متاحًا كنقطة نهاية تحتوي على المقاييس بتنسيق Prometheus.

2.3. إنشاء مقاييس مخصصة

دعنا نضيف مقياس أعمال — عداد للطلبات المعالجة:

public class OrderMetrics\