التوثيقتصدير/استيراد CSV
يستخدم تصدير/استيراد CSV في المهام التالية:
- التعديل الجماعي - إضافة أجهزة ومجموعات مهام ونماذج
- المعالجة الجماعية - تحديث الأجهزة والمهام (الحدود القصوى والأسماء والفترات الزمنية ومعلمات المهام)
- المعالجة الجماعية - حذف المهام
- وظائف القوالب
- جرد مفصل بما في ذلك الحدود
يأخذ تصدير/استيراد CSV في الاعتبار مستويين فقط من المجموعات فوق الجهاز. سيتم تصدير الأجهزة والمهام الموجودة في هياكل شجرية أعمق مع مجموعتين فقط فوقها.
لاستخدام وظيفة التصدير، انتقل إلى /root/Configurations، وحدد الوظيفة المناسبة من القائمة أو انقر على أيقونة تصدير CSV:
يتم تشغيل الاستيراد والتصدير بواسطة المستخدم الذي يبدأ الإجراء أو يقوم بتحرير كائن المجدول (التصدير فقط). عند استيراد ملف CSV، يجب أن يكون بنفس التنسيق الذي تم إنشاؤه به بواسطة وظيفة التصدير.
يحتوي كل عمود على علامة (بأحرف كبيرة) في سطر الرأس لتحديد نوع العمود. يتم تعريف العلامات الموضحة في القسم التالي.
CSV - علامات المجموعة
| العلامة | الوصف |
|---|---|
| GROUP_NAME_1 | اسم المجموعة أسفل الاستيراد/التصدير الأصلي |
| اسم_المجموعة_2 | اسم المجموعة أسفل GROUP_NAME_1 (أجهزة أعلاه) |
CSV - علامات الجهاز
| العلامة | الوصف |
|---|---|
| DEVICE_NAME | اسم الجهاز. يجب ألا تكون هذه العلامة فارغة لعملية الإضافة/التحديث |
| DEVICE_TYPE | نوع الجهاز. المفاتيح الممكنة: firewall، firewall_pix، gateway، host، ids_ips، interface، other، proxy، printer، router، server، ssl، switch، vpn، wlan |
| DEVICE_ADDRESS | اسم DNS أو عنوان IP للجهاز |
| DEVICE_SUBNET_MASK | قناع الشبكة الفرعية للجهاز |
CSV - علامات المهمة
| العلامة | الوصف |
|---|---|
| JOB_NAME | اسم المهمة. يجب ألا تكون هذه العلامة فارغة لعملية الإضافة/التحديث |
| JOB_TYPE | نوع المهمة. لا يمكن تغيير هذا العنصر. المفاتيح الممكنة لعملية الإضافة: dhcp، remote_disk، dns، dns_query، fetchfile، http، ping، imap، remote_nwinterface، parsefile، pop3، remote_process، shell، smtp، snmp، sql، tcp، buslay |
| JOB_AGENT | اسم تسجيل الدخول للمجمع الذي سيقوم بتنفيذ المهمة |
| JOB_INTERVAL | الفاصل الزمني بالثواني. القيم المحتملة: 5، 10، 20، 30، 40، 50، 60 (1 دقيقة)، 120 (2 دقيقة)، 180 (3 دقائق)، 240 (4 دقائق)، 300 (5 دقائق)، 360 (6 دقائق)، 600 (10 دقائق)، 1800 (30 دقيقة)، 3600 (ساعة واحدة)، 7200 (ساعتان)، 21600 (6 ساعات)، 43200 (12 ساعة)، 86400 (يوم واحد)، 604800 (7 أيام) |
| JOB_EXECUTION | القيم المحتملة: بدأ، توقف |
| JOB_PARAMETERS | سلسلة تحتوي على جميع المعلمات اللازمة لتشغيل مهمة. يرجى ملاحظة أن \r يجب ترميزها كـ $!r!$ و \n كـ $!n!$. مثال لمهمة ICMP: interval_mode=0&packets=10&bytes=56&icmpid_random=0 |
| حدود إنذار المهمة | سلسلة حد الإنذار. مثال لمهمة ICMP: WarningCond=Or&Warning1=error_code;<>;0;1;&MajorCond=Or&Major1=packetloss;%3d;100;1; |
CSV - علامات PID
هناك العديد من علامات PID التي تحتوي على خصائص وخصائص مخصصة مخصصة للكائنات. يتم إنشاء هذه الأعمدة إذا تم تحديد المحتوى القياسي أو الكامل مع التصدير.
مثال: الرقم التسلسلي PID
CSV - علامات أخرى
| العلامة | الوصف |
|---|---|
| TEMPLATE_NAME | اسم القالب المرتبط بجهاز أو مهمة |
| TYPE | نوع الكائن (مجموعة، جهاز، مهمة)، لا يمكن تغييره |
| ID | معرف الكائن لعملية التحديث/الحذف |
| الأمر | القيم الممكنة: تجاهل: يتم تجاهل الصف (كما لو تم حذفه من ملف csv) استخدام: إذا لم يتم الإضافة/التحديث، فاستخدم كأصل لإضافة أدناه (ضروري للمهام والقوالب) add: إضافة كائن (للمهام: يجب تعريف الجهاز باستخدام الأمر add أو use أو update) update: تحديث التكوين (لا يمكن تغيير أنواع المهام) حذف: يمكن حذف المهام فقط |
CSV - تصدير
لإنشاء كائن تصدير، انتقل إلى /root/Configurations وحدد Add CSV Export:
مثال على التكوين:
| خاصية | الوصف |
|---|---|
| الاسم | اسم تكوين التصدير |
| فاصل الأعمدة | اختر أحد الخيارات التالية: ، ؛ | : أو علامة جدولة |
| أسفل المجموعة | نقطة دخول شجرة الكائنات. يتم تصدير الكائنات الموجودة أسفل هذه المجموعة. انتقل إلى المجموعة التي تحتوي على الأجهزة المراد تصديرها |
| المحتوى | يسمح بتحديد كمية البيانات المراد تصديرها. لا يتم تصدير العلامات GROUP_NAME_1 و GROUP_NAME_2 إلا إذا تم تحديد المجموعات في التكوين. لا يتم تصدير علامات الأجهزة إلا إذا تم تحديد الأجهزة. لا يتم تصدير علامات المهام إلا إذا تم تحديد المهام. إذا تم تصدير المهام فقط، تتم إضافة العلامة DEVICE_NAME لأغراض إعلامية. أساسي: يتكون من: GROUP_NAME_1، GROUP_NAME_2، DEVICE_NAME، DEVICE_TYPE، DEVICE_ADDRESS، JOB_NAME، JOB_TYPE، JOB_AGENT، JOB_INTERVAL، JOB_EXECUTION، JOB_PARAMETERS، JOB_ALARM_LIMITS، TEMPLATE_NAME، TYPE، ID، COMMAND كامل: يتكون من المحتويات الأساسية و DEVICE_SUBNET_MASK، DEVICE_SYSLOG_SOURCE، DEVICE_SYSLOG_LEVEL، DEVICE_WEB_LINK، DEVICE_REMOTE_ACCESS، بالإضافة إلى جميع علامات PID |
| المجموعات | بالنقر فوق هذا المربع، سيحتوي الملف أيضًا على اسم المجموعة التي تحتوي على الكائنات، بالإضافة إلى اسم المجموعة التابعة للمجموعة |
| الأجهزة، المهام | في هذا القسم، يمكن تقليل عدد الإدخالات في ملف CSV عن طريق تحديد مرشح كما هو موضح في مثال التكوين أعلاه |
لإنشاء ملف تصدير، انتقل إلى الكائن الجديد، وانقر فوق Generate (إنشاء) واضغط على الزر Generate (إنشاء) في اللوحة اليمنى:
بعد الإنشاء، افتح ملف CSV باستخدام Internet Explorer أو Firefox أو Excel أو أي تطبيق جداول بيانات، أو احفظه محليًا. قم بتغيير المعلمات إذا رغبت في ذلك أو اتركها كما هي.
نموذج لإخراج ملف تصدير CSV:
CSV - استيراد
انتقل إلى /root/Configurations وحدد Add CSV Import (إضافة استيراد CSV):
التكوين:
| خاصية | الوصف |
|---|---|
| الاسم | اسم تكوين استيراد CSV |
| فاصل الأعمدة | اختر أحد الخيارات التالية: ، ؛ | : أو علامة جدولة، حسب الفاصل المستخدم في الملف المراد استيراده |
| المجموعة أدناه | نقطة الدخول لشجرة الكائنات لإضافة كائنات أدناه. بالنسبة لأوامر التحديث والحذف والاستخدام، يتم استخدام النوع والمعرف في ملف CSV ويتم تجاهل إدخال التكوين هذا |
| ملف | ملف CSV المراد استيراده. يتم مسح الإدخالات الفارغة. لا يتم تعديل الإدخالات غير الموجودة للكائنات الموجودة وتُترك فارغة للكائنات المضافة |
| تحميل الملف | منطقة لتحميل ملفات الاستيراد CSV المعدة |
قبل بدء الاستيراد، يتم إجراء فحص اتساق للملف والذي يمكن بدءه يدويًا بالضغط على "فحص". يتم عرض نظرة عامة إحصائية على صفحة الاستيراد. يحتوي ملف السجل على مزيد من المعلومات لكل صف تمت معالجته.
CSV - مثال على الاستيراد
يمكن استخدام ملف CSV تم تصديره مسبقًا كقالب للاستيراد. يمكن إضافة أجهزة جديدة ووظائف ومثيلات قوالب الأجهزة أو الوظائف باستخدام التكوين الموضح أدناه. بعد التصدير، يتم تعيين جميع الأوامر افتراضيًا على تجاهل.
في المثال التالي، يجب إضافة جهازين مع وظيفتين لكل منهما أسفل المجموعة الموجودة Region Zurich أسفل مجموعة Devices. تم ترك عمود ID من الكائنات المصدرة لتحديد المجموعات الموجودة. تم تغيير عمود الأمر من تجاهل إلى استخدام للمجموعات وإضافة للأجهزة والوظائف الجديدة:
استخدم أي كائن استيراد موجود، أو أنشئ كائنًا جديدًا باستخدام Add CSV Import (إضافة استيراد CSV). يمكن استخدام نفس كائن الاستيراد لمهام استيراد مختلفة. يمكن إنشاء كائنات استيراد متعددة لإجراءات الاستيراد الآلية المستقبلية.
انقر فوق "استيراد" لفتح تكوين الاستيراد:
اسحب ملف CSV المُعد إلى منطقة تحميل الملف وانقر فوق تحقق:
إذا فشل الفحص، افتح ملف السجل الموجود أسفل قسم "تفاصيل النتيجة" وقم بتصحيح الأخطاء في ملف الاستيراد:
إذا نجح الفحص، تحقق من الكائنات المدرجة في قسم تفاصيل النتيجة وانقر فوق استيراد:
بعد اكتمال الاستيراد، يتم عرض تفاصيل النتيجة مرة أخرى:
يجب أن تظهر الكائنات الناتجة الآن أسفل مسار شجرة الإدخال المحدد:
CSV - الاستيراد باستخدام القوالب
عند استخدام استيراد CSV، يمكن استخدام عمود ملف CSV المصدر TEMPLATE_NAME لإنشاء مثيلات من القوالب الموجودة. لاحظ ما يلي بشأن استيراد القوالب:
- يتم تفسير العمود TEMPLATE_NAME فقط إذا تم استخدام الأمر add للصف المعني
- يتحقق الاستيراد من وجود قالب واحد فقط من المستوى الأعلى من النوع المناسب، وإلا فإنه يشير إلى وجود خطأ
- القوالب مدعومة للمجموعات والأجهزة والمهام
- يتم إنشاء الكائنات الجديدة كنسخ من القالب
- تتم إضافة المجموعات والأجهزة أسفل العنصر الأصلي الحالي
- تتم إضافة المهام أسفل الجهاز الحالي (آخر جهاز تمت إضافته أو تعريفه بواسطة الأمر "use")
- لا يمكن إضافة مجموعة أسفل جهاز