EQL: لغة استعلام SKOOR Engine

يمكن البحث عن الكائنات أو تصفية قائمة الكائنات المرئية حاليًا باستخدام لغة استعلام SKOOR Engine (EQL). يكون سطر الأوامر مخفيًا افتراضيًا، ولكن يمكن فتحه/إغلاقه بالنقر فوق الزر EQL في الزاوية السفلية اليمنى من جزء النافذة الأيسر أو الأيمن حسب السياق:


تم تنفيذ سطر أوامر EQL في عرض التكوين، ولكن يمكن استخدامه أيضًا ضمن البحث في عرض المسؤول. على سبيل المثال، لعرض كافة مهام ICMP الموجودة أسفل الكائن الحالي، أدخل استعلام EQL التالي في حقل إدخال الاستعلام:

بناء الجملة

COMMAND Object-type WHERE variable Operator value [AND|OR variable Operator value]

COMMAND

GET / CHECK / START / STOP / DELETE / SET / RESET

Object-type

device, job, SLO, ... أو * لأي نوع

WHERE 

كلمة مفتاحية

Variable

تتطلب المتغيرات التالية سلسلة نصية كقيمة: Name، وsubtype، وaddress، وnetmask، و property("propertyname")
يتطلب المتغير التالي قيمة رقمية: id
يتطلب المتغير التالي حالة كقيمة: state

Operator

=، !=، ~=، ^=، إلخ (انظر أدناه)

Value

سلسلة نصية (مع علامتي اقتباس "...")، أو رقم (بدون علامتي اقتباس)، أو حالة (بدون علامتي اقتباس).
يتم تحليل السلاسل النصية (الموضوعة بين علامتي اقتباس) مثل سلاسل لغة C ويجب استخدام أحرف الهروب معها بالطريقة نفسها. يجب إدخال التعبير النمطي "\d{2}$" بالشكل "\\d{2}$". كما يمكن استخدام \n و\b وما إلى ذلك (يُستخدم "\n" لتمثيل "newline").

AND / OR

كلمة مفتاحية لشروط WHERE المتعددة

أوامر EQL

GET

سرد الكائنات

أوامر EQL إضافية للمهام

الأمر

الوظيفة

CHECK

تنفيذ عملية check now على المهام

START

بدء المهمة (المهام)

STOP

إيقاف المهمة (المهام)

DELETE

حذف المهمة (المهام) (للمستخدمين من نوع Administrator فقط)

SET TO OK

تعيين حالة المهمة (المهام) إلى OK

SET TO WARNING

تعيين حالة المهمة (المهام) إلى Warning

SET TO MINOR

تعيين حالة المهمة (المهام) إلى Minor

SET TO NO DATA

تعيين حالة المهمة (المهام) إلى No Data

SET TO MAJOR

تعيين حالة المهمة (المهام) إلى Major

SET TO UNDEFINED

تعيين حالة المهمة (المهام) إلى Undefined

SET TO MAINTENANCE OK

تعيين حالة المهمة (المهام) إلى Maintenance OK

SET TO MAINTENANCE WARNING

تعيين حالة المهمة (المهام) إلى Maintenance Warning

SET TO MAINTENANCE MINOR

تعيين حالة المهمة (المهام) إلى Maintenance Minor

SET TO MAINTENANCE NO DATA

تعيين حالة المهمة (المهام) إلى Maintenance No Data

SET TO MAINTENANCE MAJOR

تعيين حالة المهمة (المهام) إلى Maintenance Major

RESET

إعادة تعيين حالة المهمة (المهام) إلى حالتها الأصلية


إذا عثر استعلام الأمر CHECK على أكثر من 50 مهمة، فسينفذ عملية check now على أول 50 مهمة ويجدول بقية المهام التي تم العثور عليها ليتم فحصها في الخلفية لتجنب مزامنة عدد كبير جدًا من المهام.

بعد تشغيل الأمر مثل CHECK job WHERE subtype="icmp"، يتغير سطر الأوامر تلقائيًا إلى GET job WHERE subtype="icmp".

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

معاملات EQL

=

يساوي

!=

لا يساوي

>=

أكبر من أو يساوي

>

أكبر من

<=

أقل من أو يساوي

<

أقل من

معاملات إضافية للسلاسل النصية

~=

يطابق

^=

يبدأ بـ

~~

يحتوي على

$=

ينتهي بـ

!~

لا يطابق

!^

لا يبدأ بـ

!!

لا يحتوي على

!$

لا ينتهي بـ

معاملات إضافية للخصائص

is defined

is not defined

معاملات إضافية للمهام وScheduler

is stopped

متوقف

is not stopped

تم بدؤه

أمثلة EQL

الأمر

الوظيفة

GET *

كافة الكائنات (افتراضي)

GET job

كافة المهام

GET device

كافة الأجهزة

GET * where id = 10

كافة الكائنات ذات id 10

GET * WHERE name = "foo"

كافة الكائنات ذات name "foo"

GET job WHERE name ^= "client-"

كافة  المهام التي يبدأ name الخاص بها بـ "client"

GET job WHERE name $= "-snmp"

كافة المهام التي ينتهي name الخاص بها بـ "-snmp"

GET job WHERE state != ok

كافة المهام التي ليست حالتها OK

GET slo WHERE name ~~ "DNS"

كافة كائنات SLO حيث يحتوي name على "DNS"

GET job WHERE subtype = "icmp"

كافة مهام ICMP

GET job WHERE execution is not stopped

كافة المهام التي تم بدؤها حاليًا

GET job WHERE name ~~ "Mail" AND subtype = "Imap"

كافة مهام IMAP التي يحتوي name الخاص بها على "Mail"

GET device WHERE address = "10.1.0.155"

كافة الأجهزة ذات address "10.1.0.155"

GET device WHERE address ^= "10.1.1"

كافة الأجهزة التي يبدأ فيها حقل address بـ "10.1.1"

GET device WHERE state = no data

 كافة الأجهزة في حالة No Data

GET device WHERE name ~= "\\d{2}$"

كافة الأجهزة التي يطابق فيها name التعبير النمطي

GET slo WHERE state = minor OR state = major 

كافة كائنات SLO في الحالة Minor أو Major

GET device WHERE property("owner") = "Joe" 

كافة الأجهزة التي تطابق فيها الخاصية owner القيمة "Joe"

GET job WHERE property("service_kpi") IS DEFINED

كافة المهام التي تم تعيين الخاصية service_kpi لها

GET device WHERE property("Green, Blue or Red") = "Red"

كافة الأجهزة

GET scheduler WHERE execution is stopped

كافة عناصر Scheduler المتوقفة

START job WHERE subtype = icmp

بدء كافة مهام ICMP

STOP job WHERE name ^= "server"

إيقاف كافة المهام التي يبدأ اسمها بـ "server"

SET TO OK job WHERE subtype = "execute"

تعيين كافة مهام execute إلى الحالة OK

SET TO MAINTENANCE MAJOR job where subtype="parsefile"

تعيين كافة مهام parsefile إلى الحالة Maintenance Major


باستخدام EQL، يمكنك بسهولة ربط مجموعة من الكائنات أسفل مجموعة أو كائن SLO.

مثال: ربط كافة أجهزة التوجيه والمبدلات بكائن SLO /root/Customer/Services/SLOs/Network service

  1. اختر Edit dependency من القائمة المنسدلة لكائن SLO Network service

  2.  انتقل إلى /root/Customer/Devices في النافذة الموجودة على الجانب الأيمن

  3. انقر فوق زر EQL في الزاوية السفلية اليمنى من النافذة الموجودة على الجانب الأيمن

  4. أدخل استعلام البحث: GET device WHERE subtype = "router" OR subtype = "switch"

  5. حدد كافة الأجهزة بالنقر فوق خانة الاختيار العلوية

  6. انقر فوق أحد الأسهم المتجهة إلى اليسار. يجب أن تكون كافة الأجهزة مرئية الآن في النافذة اليسرى

  7. قم بالتأكيد بالنقر فوق الزر OK


البحث السريع باستخدام معاملات EQL

تتوفر معاملات EQL التالية أيضًا للبحث في مربع نص البحث السريع في SKOOR Engine في رأس عرض التكوين الخاص بـ SKOOR Engine:

 =

يساوي

!=

لا يساوي

~=

يطابق

^=

يبدأ بـ

~~

يحتوي على

$=

ينتهي بـ

!~

لا يطابق

!^

لا يبدأ بـ

!!

لا يحتوي على

!$

لا ينتهي بـ

أمثلة:

سلسلة البحث

يبحث عن كافة

id=15

الكائنات التي يكون فيها id هو 15

addr=192.168.1.2

الأجهزة ذات عنوان محدد

=dns01

الكائنات التي يكون فيها name = "dns01"

^=dns

الكائنات التي يبدأ فيها name بـ "dns"

$=01

الكائنات التي ينتهي فيها name بـ "01"

!$01

الكائنات التي لا ينتهي فيها name بـ "01"

!!dns

الكائنات التي لا يحتوي فيها name على "dns"

~=DNS.*ch

الكائنات التي يحتوي فيها name على "DNS" "ch"

~=^DNS.*ch$

الكائنات التي يبدأ فيها name بـ "DNS" وينتهي بـ "ch"

~=dns\d\d$

الكائنات التي يحتوي فيها name على "dns" متبوعة برقمين