إنتقل إلى المحتوى الرئيسي

قبل البدء

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

القليل من التحضير يساعد كثيرًا في تسهيل فهم مرجع API وأدلة الإرشادات ومفاهيم البنية.

ما ستتعلمه في هذا القسم​

يغطي قسم الوثائق هذا:

  1. المفاهيم الأساسية
    فهم تدفقات الأحداث وطبقات المعالجة والتوجيه والوجهات.

  2. آليات الاستيعاب
    كيفية إرسال السجلات والمقاييس مباشرة إلى خط أنابيب باستخدام API عالي الإنتاجية.

  3. سير العمل العملي
    كيفية توجيه سجلات التطبيقات السحابية والتحقق من الاستيعاب وتسليم البيانات إلى وجهات مختلفة.

إذا كنت ترغب في استكشاف المستندات بالترتيب الموصى به:

ابدأ بالمفاهيم​

تدفقات الأحداث وخطوط أنابيب المراقبة

ثم تعلم واجهة برمجة التطبيقات للاستيعاب​

استيعاب الأحداث باستخدام واجهة برمجة التطبيقات للاستيعاب المتدفق

ثم اتبع الدليل العملي​

توجيه سجلات التطبيقات السحابية إلى خط أنابيب

الأدوات التي ستحتاجها​

ستستفيد إلى أقصى حد من الأمثلة إذا كان لديك ما يلي مثبتًا:

  • cURL أو Postman
    إرسال طلبات واجهة برمجة التطبيقات (API) وتجربة الاستيعاب.
  • محرر أكواد، ويفضل أن يكون VS Code
    لتحرير عينات حمولات JSON.
  • محطة طرفية أو غلاف
    macOS أو Linux أو Windows PowerShell تعمل جميعها.
  • متصفح
    لعرض الأحداث الحية وقواعد التوجيه ومخططات خطوط الأنابيب بمجرد تنفيذها.

لا يلزم وجود أي من هذه الأدوات لقراءة المستندات، ولكنها تتيح لك الاستفادة من التجربة العملية الكاملة.

الوصول وبيانات الاعتماد التي قد تحتاجها​

بعض الأمثلة المرجعية:

  • رمز API ممكّن للاستيعاب
  • معرف دفق (Stream ID)
  • عينات سجل JSON أساسية

تمثل هذه المتطلبات القياسية في خطوط أنابيب الأحداث، على الرغم من أن هذه الحافظة لا تعتمد على واجهة API خلفية فعلية.

تعامل معها على أنها عناصر نائبة واقعية قد تصادفها في منصة قابلية المراقبة الحقيقية.

لمن هذه الوثائق​

كتبت هذه الوثائق مع وضع عدة شخصيات في الاعتبار:

الشخصيةالاحتياجات
مهندسو المنصاتإنشاء سير عمل قابل للتوسع للاستيعاب والتوجيه
SREs / DevOpsتطبيع السجلات وتقليل الضوضاء وإنشاء لوحات معلومات
مهندسو الأمانتوجيه سجلات المصادقة والتدقيق إلى SIEM
المطورونإرسال سجلات التطبيقات والمقاييس إلى خطوط الأنابيب
المهندسون المعماريونفهم تدفق البيانات من البداية إلى النهاية وأنماط التصميم

إذا كنت تعمل في أي من هذه المجالات أو بالقرب منها، فأنت في المكان الصحيح.

ما يجب أن تعرفه بالفعل​

لا تحتاج إلى أن تكون خبيرًا — تفترض هذه الوثائق ما يلي:

  • معرفة أساسية بـ JSON
  • الراحة في تشغيل أوامر سطر الأوامر الأساسية
  • معرفة عامة بالسجلات أو الأحداث أو المقاييس
  • فهم عالي المستوى لبيئات السحابة أو الخدمات الصغيرة

إذا كنت لا تعرف ما هو طلب POST، فلا مشكلة — سترشدك الأدلة إلى ذلك.

نموذج مفاهيمي يجب أخذه في الاعتبار​

تتبع معظم الأمثلة تدفقًا مثل هذا:

flowchart LR
    A["تطبيقات السحابة"] --> B["الاستيعاب"]
    B --> C["المعالجة<br/>التحليل • الإثراء • الإخفاء"]
    C --> D["التوجيه<br/>المرشحات • القواعد • العينات"]
    D --> E{{"الوجهات"}}