--- title: "دمج بيانات كاتو مع داتادوغ" slug: "integrating-cato-data-with-datadog" updated: 2026-10-23T23:16:32Z published: 2026-10-23T23:16:32Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-datadog" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # دمج بيانات كاتو مع داتادوغ ## إجمال تتيح لك تكامل داتادوغ تحليل بيانات شبكة وأمان كاتو جنبًا إلى جنب مع البيانات من مصادر أخرى في داتادوغ. يمكنك استخدام هذه البيانات للوحات التحكم، المراقبة، التنبيهات، وتحليل السجلات دون الحاجة لنشر آليات تجميع بيانات إضافية. يرسل كاتو أحداث موجهة، وخيارات شبكة مباشرة إلى حساب داتادوغ الخاص بك. تقوم بتكوين التكامل الأصلي لداتادوغ في تطبيق إدارة كاتو (CMA). ### مصادر بيانات Datadog يمكنك تكوين التكامل لإرسال **الأحداث**, **التدفقات**, أو كلاهما. - **أحداث:** - تُنتج عندما يحدث نشاط محدد في الشبكة أو النظام (على سبيل المثال، عندما تطابق قاعدة سياسة أو اكتشاف تهديد). - تقدم رؤى متميزة في الوقت الفعلي حول أمن وتطبيق السياسات. - ترسل باستخدام مخطط الأحداث من كاتو. - **الدمج الجديد يصدر فقط الأحداث بشكل افتراضي.** - الدعم للتصفية متاح فقط للأحداث. - **التدفقات:** - تنشأ كتدفقات شبكية (5-tuple) وتُغنى بمعلومات على مستوى التطبيق كلما توفرت من محركات Cato. - تتضمن سياق التطبيق والمستخدم، بالإضافة إلى بيانات الجلسة المجمعة: البايتات، الحزم، والمدة. - يمكن أن تولد حجم بيانات أعلى بكثير من الأحداث. يعتمد الحجم الدقيق على حركة المرور. ### المتطلبات الأساسية قبل تكوين هذا التكامل، تأكد من ما يلي: - لديك إذن **المحرر** للتكاملات في قسم **الموارد** من CMA. انظر [إدارة الأدوار الإدارية باستخدام RBAC](/v1/docs/managing-admin-roles-using-rbac). - لقد استعرضت الشروط المسبقة لجميع تكاملات أحداث Cato في [البدء مع تكاملات الأحداث](/v1/docs/getting-started-with-event-integrations). - لديك حساب داتادوغ بأذونات لإنشاء مفتاح API. - لديك عنوان URL لموقع **داتادوغ** (على سبيل المثال: `datadoghq.com`, `datadoghq.eu`). ## حالات استخدام ### أحداث يمكنك إرسال أحداث كاتو إلى داتادوغ لتوحيد مراقبة الأمان وقابلية المتابعة. توفر الأحداث بيانات حول نشاط الشبكة، التهديدات، المستخدمين، الأجهزة، وحركة المرور عبر منصة كاتو. يمكن لفريقَي 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. يتم تجاهل متغيرات بيانات الاعتماد المؤقتة عند انتهاء المثال. ```bash (  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**. ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(254).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A13%3A30Z&se=2026-11-22T14%3A13%3A30Z&sr=b&sp=r&sig=MxR4i7MgFHfLNFbPDnzj9O1niJ13ji8PBXuUhfAmwYM%3D) 6. أدخل **اسمًا** لهذا التكامل (مطلوب). 7. اختياري) أدخل **وصف**. 8. أدخل **موقع داتادوغ** (على سبيل المثال: `datadoghq.com`). 9. أدخل **مفتاح API** الذي قمت بنسخه من داتادوغ. 10. تحت **مصادر البيانات**، اختر **الأحداث**، **التدفقات**، أو كلاهما. 11. اختياريًا، قم بتكوين مجموعات **فلترة الأحداث** و/أو **فلترة التدفقات** للتحكم في البيانات المُرسلة (انظر الفلاتر أدناه). 12. انقر **حفظ**. 13. إعادة تحميل الصفحة الدمج. يظهر التكامل في جدول **التكاملات المُكونة مسبقًا** مع الحالة **متصل**. ## مرشحات تستخدم الفلاتر للتحكم في أي الأحداث (والتدفقات) التي يتم تصديرها إلى داتادوغ. - تساعد في تقليل تكاليف التجميع، تقليل الضوضاء، وتركيز التحقيقات. - تسمح بتوجيه مجموعات مختلفة من الأحداث إلى منصات مختلفة. - تعرف مجموعات الفلاتر بناءً على أي **حقل حدث** أو مجموعة من الحقول. - تستخدم الشروط **داخل** كل مجموعة منطق **AND**; يتم تطبيق منطق **OR** **بين** المجموعات. ### فلترة الأحداث متوفر تحت **فلترة الأحداث** في لوحة التكامل الجديد . انقر **إضافة فلتر** لتحديد شرط، أو **إضافة مجموعة** لإنشاء مجموعة فلتر إضافية (منطق OR بين المجموعات). ### فلترة التدفقات متوفر تحت **فلترة التدفقات** عند اختيار التدفقات كمصدر بيانات. يتبع نفس منطق فلترة الأحداث. ## إصلاح المشاكل | المسألة | حل | | --- | --- | | يعرض التكامل **خطأ الاتصال** | تحقق من إدخال عنوان URL لموقع داتادوغ ومفتاح API بشكل صحيح. تأكد من أن مفتاح API لم يتم إلغائه في داتادوغ. | | لا تصل أحداث إلى داتادوغ | تحقق من تكوين فلتر الأحداث الخاص بك - الفلتر الضيق جدًا يمكن أن يستثني جميع البيانات بصمت. | | لا تصل تدفقات إلى داتادوغ | تأكد من تحديد **التدفقات** تحت مصادر البيانات، وتحقق من فلتر التدفقات بسبب الشروط المفرطة في التقييد. | | تم حفظ الدمج لكن الحالة لا تظهر **متصل** | إعادة تحميل الصفحة الدمج. إذا استمرت المشكلة، تحقق من أذونات مفتاح API الخاص بك في داتادوغ. |