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

قبل أن تبدأ

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

إن القليل من الإعداد يقطع شوطًا طويلًا نحو تسهيل فهم مرجع واجهة برمجة التطبيقات، والأدلة الإرشادية، ومفاهيم البنية.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • ** رمز مميز لواجهة برمجة التطبيقات الممكّنة للاستخدام**
  • معرف معرّف البث
  • نماذج سجل JSON الأساسية

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

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

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

لقد كتبت هذه المستندات مع وضع العديد من الأشخاص في الاعتبار:

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

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

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

لست بحاجة إلى أن تكون خبيراً—فهذه المستندات تفترض ذلك:

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

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

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

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

flowchart LR
    A["Cloud Apps"] --> B["Ingestion"]
    B --> C["Processing<br/>Parse • Enrich • Mask"]
    C --> D["Routing<br/>Filters • Rules • Sampling"]
    D --> E{{"Destinations"}}