دمج بيانات كاتو مع داتادوغ

Prev Next

إجمال

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

يرسل كاتو أحداث موجهة، وخيارات شبكة مباشرة إلى حساب داتادوغ الخاص بك. تقوم بتكوين التكامل الأصلي لداتادوغ في تطبيق إدارة كاتو (CMA).

مصادر بيانات Datadog

يمكنك تكوين التكامل لإرسال الأحداث, التدفقات, أو كلاهما.

  • أحداث:

    • تُنتج عندما يحدث نشاط محدد في الشبكة أو النظام (على سبيل المثال، عندما تطابق قاعدة سياسة أو اكتشاف تهديد).

    • تقدم رؤى متميزة في الوقت الفعلي حول أمن وتطبيق السياسات.

    • ترسل باستخدام مخطط الأحداث من كاتو.

    • الدمج الجديد يصدر فقط الأحداث بشكل افتراضي.

    • الدعم للتصفية متاح فقط للأحداث.

  • التدفقات:

    • تنشأ كتدفقات شبكية (5-tuple) وتُغنى بمعلومات على مستوى التطبيق كلما توفرت من محركات Cato.

    • تتضمن سياق التطبيق والمستخدم، بالإضافة إلى بيانات الجلسة المجمعة: البايتات، الحزم، والمدة.

    • يمكن أن تولد حجم بيانات أعلى بكثير من الأحداث. يعتمد الحجم الدقيق على حركة المرور.

المتطلبات الأساسية

قبل تكوين هذا التكامل، تأكد من ما يلي:

حالات استخدام

أحداث

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

التدفقات

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

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

إنشاء تكامل Datadog

لإرسال أحداث وتدفقات كاتو إلى داتادوغ، ستقوم بإنشاء تكامل في CMA باستخدام مفتاح API من داتادوغ.

الخطوة 1: الحصول على مفتاح API لداتادوغ

  1. تسجيل الدخول إلى حسابك في داتادوغ.

  2. انتقل إلى إعدادات المؤسسة > مفاتيح API.

  3. انقر مفتاح جديد, أدخل اسم وصفي (على سبيل المثال، تكامل كاتو), وانقر إنشاء مفتاح.

  4. انسخ واحفظ قيمة مفتاح API. لن يتم عرضها مرة أخرى.

  5. لاحظ موقع داتادوغ الخاص بك (ظاهر في URL، على سبيل المثال، datadoghq.com).

الخطوة 2: الاختبار باستخدام curl

قبل تكوين التكامل في CMA, تحقق من عمل مفتاح API ونقاط دخول التجميع الخاصة بداتادوغ عن طريق إرسال سجل اختبار بشكل مباشر من سطر الأوامر. هذا يعزل أي مشاكل في جانب البائع (المصادقة، النقطة الطرفية، قبول الحمولة) قبل التعامل مع CMA.

تستخدم API تجميع سجلات داتادوغ DD-API-KEY لتوثيق الوصول. يقوم كاتو بتعيين حقل المصدر إلى كاتو ويستخدم علامة مصدر_البيانات لتمييز الأحداث عن التدفقات في مستكشف سجلات داتادوغ.

مثال — داتادوغ (موقع الولايات المتحدة):


قم بتشغيل المثال بالكامل في شاشة Bash تفاعلية (قم بتشغيل bash أولاً إذا لزم الأمر). أدخل بيانات الاعتماد عند المطالبات المخفية؛ لا تقم بإدراجها في الأمر. المثال يعطل تتبع الشاشة ويمرر رؤوس المصادقة عبر الإدخال القياسي باستخدام --header @-، مما يحافظ على بيانات الاعتماد خارج السجل التاريخي للشاشة ومعلمات أوامر curl. يتم تجاهل متغيرات بيانات الاعتماد المؤقتة عند انتهاء المثال.

(
  set +axv
  set -euo pipefail
  unset CATO_TEST_API_KEY
  IFS= read -r -s -p 'مفتاح API لDatadog: ' CATO_TEST_API_KEY
  built-in printf '\n' >&2
  case "$CATO_TEST_API_KEY" in
    ''|*$'\r'*) built-in printf 'أدخل بيانات اعتماد غير فارغة بدون علامات العودة.\n' >&2; exit 1 ;;
  esac

  built-in printf '%s\n' "DD-API-KEY: ${CATO_TEST_API_KEY}" | \
    curl -q -X POST "https://http-intake.logs.datadoghq.com/v1/input" \
  --header @- \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "ddsource": "cato",
      "ddtags": "env:staging,version:5.1",
      "message": { "message":"اختبار حدث من curl","event_type":"اختبار","timestamp":"2026-07-05T12:00:00Z" }
    }
  ]'
)
  1. استخدم عنوان URL الخاص بالاستيعاب الذي يتطابق مع موقع Datadog الخاص بك، وأدخل مفتاح API الذي تم الحصول عليه في المرحلة ١ عند المطالبة المخفية.
    الاستجابة الناجحة تُرجِع HTTP 202 Accepted.

  2. تحقق من ظهور السجل في Datadog تحت السجلات > البحث، مع التصفية حسب source:cato.

الخطوة 3: تكوين التكامل في CMA

  1. من قائمة التنقل في CMA، اذهب إلى الموارد > التكاملات.

  2. افتح علامة التبويب التكاملات المكونة وانقر على جديد.

  3. في لوحة التكامل الجديد، اختر داتادوغ من القائمة المنسدلة للتكامل.

  4. تحت القدرة، اختر تصدير البيانات.

  5. في قائمة المصادقة المنسدلة، اختر مصادقة مفتاح API لـ Datadog.

  6. أدخل اسمًا لهذا التكامل (مطلوب).

  7. اختياري) أدخل وصف.

  8. أدخل موقع داتادوغ (على سبيل المثال: datadoghq.com).

  9. أدخل مفتاح API الذي قمت بنسخه من داتادوغ.

  10. تحت مصادر البيانات، اختر الأحداث، التدفقات، أو كلاهما.

  11. اختياريًا، قم بتكوين مجموعات فلترة الأحداث و/أو فلترة التدفقات للتحكم في البيانات المُرسلة (انظر الفلاتر أدناه).

  12. انقر حفظ.

  13. إعادة تحميل الصفحة الدمج. يظهر التكامل في جدول التكاملات المُكونة مسبقًا مع الحالة متصل.

مرشحات

تستخدم الفلاتر للتحكم في أي الأحداث (والتدفقات) التي يتم تصديرها إلى داتادوغ.

  • تساعد في تقليل تكاليف التجميع، تقليل الضوضاء، وتركيز التحقيقات.

  • تسمح بتوجيه مجموعات مختلفة من الأحداث إلى منصات مختلفة.

  • تعرف مجموعات الفلاتر بناءً على أي حقل حدث أو مجموعة من الحقول.

  • تستخدم الشروط داخل كل مجموعة منطق AND; يتم تطبيق منطق OR بين المجموعات.

فلترة الأحداث

متوفر تحت فلترة الأحداث في لوحة التكامل الجديد . انقر إضافة فلتر لتحديد شرط، أو إضافة مجموعة لإنشاء مجموعة فلتر إضافية (منطق OR بين المجموعات).

فلترة التدفقات

متوفر تحت فلترة التدفقات عند اختيار التدفقات كمصدر بيانات. يتبع نفس منطق فلترة الأحداث.

إصلاح المشاكل

المسألة

حل

يعرض التكامل خطأ الاتصال

تحقق من إدخال عنوان URL لموقع داتادوغ ومفتاح API بشكل صحيح. تأكد من أن مفتاح API لم يتم إلغائه في داتادوغ.

لا تصل أحداث إلى داتادوغ

تحقق من تكوين فلتر الأحداث الخاص بك - الفلتر الضيق جدًا يمكن أن يستثني جميع البيانات بصمت.

لا تصل تدفقات إلى داتادوغ

تأكد من تحديد التدفقات تحت مصادر البيانات، وتحقق من فلتر التدفقات بسبب الشروط المفرطة في التقييد.

تم حفظ الدمج لكن الحالة لا تظهر متصل

إعادة تحميل الصفحة الدمج. إذا استمرت المشكلة، تحقق من أذونات مفتاح API الخاص بك في داتادوغ.