تعد إدارة المهام عاملاً هائلاً لأي مسؤول ، وعند العمل مع نظام معقد مثل Elasticsearch ، ستحتاج إلى القيام ببعض مراقبة المهام '.
دعنا نغطي ما تستلزمه واجهة برمجة التطبيقات هذه وكيف يمكن أن تساعدك كمسؤول للنظام.
ملاحظة: اعتمادًا على تكوين المجموعة وإعدادات الأمان ، قد تتطلب واجهة برمجة التطبيقات هذه امتيازات مراقبة.
بناء جملة الطلب
يوضح ما يلي بناء الجملة لإرسال الطلب إلى واجهة برمجة تطبيقات إدارة المهام.
احصل على / _مهام / < معرّف_المهمة >
احصل على / _مهام
بمجرد أن تطلب واجهة برمجة التطبيقات ، يجب أن يعرض الأمر معلومات مفصلة حول المهام الحالية أو المهمة بالمعرف المحدد.
طلب معلمات المسار
يدعم الطلب معلمة مسار واحدة:
-
- قيمة معرف فريد للمهمة التي ترغب في استرداد معلوماتها. يتبع معرف المهمة النمط node_id: task_number.
طلب معلمات الاستعلام
لتخصيص السلوك وتنسيق الإرجاع للاستعلام ، يمكنك تحديد المعلمات التالية:
- الإجراءات - تحدد مجموعة من الإجراءات المستخدمة للحد من الطلب. هنا ، يمكنك تحديد الإجراءات كقائمة من القيم المفصولة بفواصل.
- تفصيلي - هذه معلمة منطقية تحدد ما إذا كان الطلب يعرض معلومات مفصلة حول عمليات استرداد جزء أم لا. يتم تعيين هذا الخيار افتراضيًا على خطأ
- Group_by - يحدد المفاتيح المستخدمة لتجميع المهام من الاستجابة. تشمل القيم المقبولة:
- العقد - معرف العقدة.
- الوالدين - هوية الوالدين.
- العقدة - لا تجمع.
- Node_id - يحدد العقدة أو قائمة العقد التي يتم جلب المعلومات منها.
- parent_task_id - تحدد معرّف الأصل المستخدم لتصفية معلومات الاستجابة. لإظهار جميع المهام ، حدد parent_task_id كـ -1.
- master_timeout - يحدد المدة التي ينتظر فيها الطلب الاتصال بالعقدة الرئيسية. إذا لم يتلق الطلب استجابة من السيد بعد انقضاء مدة المهلة الرئيسية ، فإنه يفشل ويعيد خطأ. المدة الافتراضية مضبوطة على 30 ثانية.
- المهلة - على غرار master_timeout ، لكن هذه القيمة تحدد المدة التي يجب انتظار أي استجابة خلالها.
- Wait_for_completion - إذا كان هذا صحيحًا ، فسيتم حظر الطلب حتى تنتهي العملية. افتراضات على خطأ.
إجابة
إذا نجح الطلب ، فسيعيد الطلب معلومات مفصلة حول المهمة أو المهام المحددة. إذا لم يتم العثور على المهمة ، فسيقوم الطلب بإرجاع رمز الحالة 404.
مثال على الاستخدام
يوضح المثال التالي كيفية استخدام واجهة برمجة تطبيقات إدارة المهام لعرض معلومات حول جميع المهام التي تعمل في نظام المجموعة (جميع العقد).
حليقة -XGET 'http://localhost:9200/_tasks' -ح 'kbn-xsrf: إعداد التقارير'يجب أن يوفر الطلب معلومات حول المهام في الكتلة ، كما هو موضح في الإخراج أدناه:
مثال 2
في المثال التالي ، نستخدم معلمة العقد لتقييد الاستجابة للمهام التي تعمل في العقدة slave_1
حليقة -XGET 'http://localhost:9200/_tasks?nodes=slave_1' -ح 'kbn-xsrf: إعداد التقارير'يجب أن يعيد هذا المهام في العقدة المحددة كما هو موضح في الإخراج أدناه:
'مهام' : {'Fit416fGR1GJefJxOxLurw: 1651265' : {
'العقدة' : 'slave_1' و
'هوية شخصية' : 1651265 و
'يكتب' : 'المواصلات' و
'عمل' : 'المؤشرات: مراقب / أسطول / global_checkpoints' و
'start_time_in_millis' : 1664214054489 و
'run_time_in_nanos' : 94450056094 و
'قابل للإلغاء' : خاطئة،
'رؤوس' : {
'منشأ منتج مرن س' : 'سريع'
}
}
مثال 3
في المثال 3 ، نستخدم واجهة برمجة تطبيقات إدارة المهام لعرض معلومات حول المهمة بالمعرف المحدد:
حليقة -XGET 'http://localhost:9200/_tasks/Fit416fGR1GJefJxOxLurw:1656310' -ح 'kbn-xsrf: إعداد التقارير'معلومات مهمة الإخراج كما هو موضح:
مثال 4
لإظهار معلومات تفصيلية حول المهمة ، أضف المعلمة التفصيلية إلى الطلب كما هو موضح:
[cc lang = 'apache' width = '100٪' height = '100٪' escaped = 'true' theme = 'blackboard' nowrap = '0 ″]
curl -XGET 'http://localhost:9200/_tasks?detailed=true” -H “kbn-xsrf: reporting&rdquo ؛
[/نسخة
يجب أن يوفر هذا معلومات إضافية حول المهام:
استنتاج
استكشاف هذا المنصب كيفية استخدام واجهة برمجة تطبيقات إدارة المهام في Elasticsearch. تسمح لنا واجهة برمجة التطبيقات هذه باسترداد المعلومات حول تنفيذ المهام حاليًا في المجموعة.
هتافات!! وسألتقطك في المرة القادمة.