قبل البدء - قابلية المراقبة المتوازية للسحابة والذكاء الاصطناعي

تغطي هذه الصفحة المتطلبات الأساسية والأدوات والنموذج المفاهيمي الذي ستحتاجه قبل البدء في الاطلاع على وثائق خطوط الأنابيب والقابلية للمراقبة. سواء كنت تقوم بإعداد استيعاب السجلات في Datadog، أو تتبع استدعاءات نموذج اللغة الكبير (LLM) في Galileo، أو كليهما، فابدأ من هنا.

ما يغطيه هذا القسم

تغطي هذه الوثائق سير عملين متكاملين للقابلية للمراقبة:

1. استيعاب السجلات التشغيلية وتوجيهها باستخدام Datadog

   • استيعاب سجلات JSON من التطبيقات السحابية عبر واجهة برمجة التطبيقات (API) لاستيعاب السجلات في Datadog، وتطبيق معالجات خطوط الأنابيب، وتوجيه البيانات إلى وجهات لاحقة.

2. تتبع وتقييم LLM باستخدام Galileo

   • قم بتجهيز الخدمات المدعومة بالذكاء الاصطناعي باستخدام مجموعة أدوات تطوير البرامج (SDK) الخاصة بـ Galileo لالتقاط التتبعات، والفترات الزمنية، ومقاييس التقييم لكل استدعاء LLM.

اتبع الوثائق بالترتيب الموصى به:

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

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

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

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

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

توجيه سجلات تطبيقات السحابة باستخدام Datadog و Galileo

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

لاستيعاب سجلات Datadog

• cURL أو Postman—استخدم هذه الأدوات لإرسال طلبات واجهة برمجة التطبيقات (API) إلى واجهة برمجة تطبيقات استيعاب سجلات Datadog.
• محطة طرفية أو شل—تعمل أنظمة macOS وLinux وWindows PowerShell جميعها.
• jq (اختياري ولكن موصى به)—استخدم هذه الأداة للتحقق من صحة حمولات JSON قبل إرسالها.

لتتبع Galileo LLM

• Python 3.8+ أو Node.js 18+—تدعم حزمة تطوير البرامج (SDK) الخاصة بـ Galileo كلا البيئتين.

• pip أو npm—استخدم هذه الأدوات لتثبيت حزمة تطوير البرامج (SDK).

  Python

  pip install galileo

  TypeScript

  npm install galileo

• محرر أكواد، ويفضل VS Code (Cursor، Antigravity، أو Codex هي بدائل مقبولة).

بيانات الاعتماد المطلوبة

Datadog

بيانات الاعتماد	مكان العثور عليها
مفتاح API	Datadog → إعدادات المؤسسة → مفاتيح API
عنوان موقع Datadog	يعتمد على منطقتك، على سبيل المثال، datadoghq.com (الولايات المتحدة) أو datadoghq.eu (الاتحاد الأوروبي). انظر مواقع Datadog

Galileo

بيانات الاعتماد	مكان العثور عليها
مفتاح API	app.galileo.ai → الإعدادات → مفاتيح API
اسم المشروع	يتم إنشاؤه عند إعداد مشروع جديد في Galileo
اسم دفق السجلات	يتم إنشاؤه لكل بيئة، مثل dev أو staging أو production.

انظر أين أجد مفاتيح مشروعي؟ في وثائق Galileo.

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

الشخصية	الاستخدام الأساسي
مهندسو المنصات	إنشاء وصيانة خطوط أنابيب سجلات Datadog القابلة للتوسع
مهندسو موثوقية المواقع (SRE) و DevOps	توحيد السجلات وتقليل الضوضاء وإعداد التوجيه والتنبيهات
مهندسو الذكاء الاصطناعي والتعلم الآلي (ML)	تجهيز خدمات LLM وتقييم جودة النماذج باستخدام Galileo
مهندسو الأمن	توجيه سجلات التدقيق والمصادقة إلى وجهات إدارة المعلومات والأحداث الأمنية (SIEM)
المطورون	إرسال سجلات التطبيقات وتتبع استدعاءات LLM دون معرفة عميقة بالبنية التحتية

ما يجب أن تعرفه مسبقًا

تفترض هذه الوثائق ما يلي:

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

إذا لم تكن قد أرسلت طلب POST من قبل، فإن الدليل العملي يرشدك خلال العملية خطوة بخطوة.

النموذج المفاهيمي

تتبع جميع سير العمل في هذا القسم نموذج قابلية المراقبة ذي المسارين:

صورة Mermaid

كود Mermaid

flowchart LR
    A["تطبيق سحابي"] -->|HTTP POST| B["واجهة برمجة<br/>استيعاب السجلات"]
    B --> C["خط الأنابيب<br/> • تحليل<br/> • إثراء<br/> • توجيه"]
    C --> D{{"الوجهات<br/> • S3<br/> • SIEM<br/> • تنبيهات"}}

    A -->|SDK لـ Galileo| E["تدفق سجلات<br/>Galileo"]
    E --> F["وكيل ذكاء<br/>اصطناعي Galileo"]
    F --> G{{"مقاييس<br/>وتقييم"}}

ASCII

       [تطبيق سحابي]
      /               \
|HTTP POST|      |SDK Galileo|
     v                 v
 [واجهة برمجة]     [تدفق سجلات]
 [استيعاب سجلات]   [Galileo]
     |                 |
     v                 v
 [خط الأنابيب]     [وكيل ذكاء]
 • تحليل           [اصطناعي]
 • إثراء               |
 • توجيه               v
     |           [مقاييس و]
     v           [تقييم   ]
 [الوجهات]
 • S3
 • SIEM
 • تنبيهات

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

Galileo يتولى قياس الأداء بالذكاء الاصطناعي، بما في ذلك مدخلات ومخرجات LLM وزمن الاستجابة لكل فترة ونتائج التقييم.

ويوفران معًا رؤية شاملة لكامل المكونات عبر طبقتي التطبيق السحابي الحديث.