تستكشف هذه المقالة كيف يمكننا جلب الوصف التفصيلي لكل جزء مشارك في لقطة معينة.
لجلب حالة لقطة معينة في Elasticsearch ، نستخدم نقطة نهاية Get snapshot status API.
بناء جملة الطلب
يكون بناء جملة الطلب كما هو موضح في الآتي:
الحصول على لقطة / _الحالة
الحصول على لقطة / < مخزن > / _الحالة
الحصول على لقطة / < مخزن > / < لمحة > / _الحالة
يدعم الطلب معلمات المسار التالية:
- <التسجيل> - اسم مستودع اللقطات. يعد هذا مفيدًا جدًا لحصر نطاق الطلب في مستودع تخزين معين بدلاً من الاستعلام على مستوى النظام.
- <لقطة> - يحدد اسم لقطة الهدف. يمكنك أيضًا تحديد اللقطات المتعددة كقائمة مفصولة بفواصل.
يمكننا حذف اللقطة في معلمة الطلب لجلب معلومات حول اللقطات قيد التشغيل حاليًا.
هيئة الاستجابة
يجب أن يعرض الطلب معلومات مفصلة حول اللقطة. هذه المعلومات الواردة في الرد هي:
- مخزن - اسم المستودع الذي توجد به اللقطة.
- لمحة - اسم اللقطة.
- uuid - UUID من اللقطة.
- حالة - الوضع الحالي للقطة. يمكن أن تكون اللقطة في الحالات التالية:
- Include_global_state - يشير إلى ما إذا كانت حالة الكتلة العالمية مضمنة في اللقطة المحددة.
- Shard_stats - يظهر عدد القطع.
- احصائيات - تفاصيل عن عدد الملفات وحجم الملفات في اللقطة.
أ. باءت بالفشل - اللقطة التي انتهى بها خطأ وفشلت في استعادة البيانات التي تم نسخها احتياطيًا.
ب. بدأت - يشير إلى أن اللقطة قيد التشغيل حاليًا.
ج. جزئي - يُظهر أنه تمت استعادة حالة المجموعة العالمية ولكن فشل تخزين بيانات جزء واحد على الأقل بنجاح.
د. النجاح - يشير إلى انتهاء اللقطة بنجاح.
هذه بعض المعلومات التي تم إرجاعها من حالة اللقطة.
Elasticsearch إنشاء لقطة
لتوضيح كيفية استخدام Elasticsearch Get snapshot API ، دعنا ننشئ لقطة عينة. ضع في اعتبارك أن هذا القسم لا يغطي أساسيات إنشاء مستودع Elasticsearch أو المتطلبات الأخرى للحصول على لقطة Elasticsearch.
تحقق من الوثائق لمعرفة المزيد.
لنفترض أن لدينا مستودع يسمى elk_bakcups ، يمكننا إنشاء لقطة في هذا المستودع مع الطلب كما هو موضح في ما يلي:
لفة -XPUT 'http://localhost:9200/_snapshot/elk_backups/test_snapshot?wait_for_completion=true' -ح 'kbn-xsrf: إعداد التقارير'يقوم الطلب السابق بتهيئة تكوين اللقطة في مستودع التخزين المحدد.
ملاحظة : يعتمد الوقت المطلوب لإكمال إنشاء اللقطة على عدد من العوامل.
Elasticsearch الحصول على حالة لقطة
بمجرد أن نبدأ عملية إنشاء اللقطة ، يمكننا التحقق من حالتها عن طريق تشغيل الاستعلام التالي:
لفة -XGET 'http://localhost:9200/_snapshot/elk_backups/test_snapshot/_status' -ح 'kbn-xsrf: إعداد التقارير'يجب أن يؤدي هذا إلى إرجاع معلومات مفصلة حول حالة اللقطة. مثال على الإخراج هو كما هو موضح في ما يلي:
{'لقطات' : [
{
'لمحة' : 'test_snapshot' و
'مخزن' : 'each_backups' و < قوي >
قوي > 'uuid' : '9oOJtTunR_WC-1a7NA-9WQ' و
'حالة' : 'النجاح' و
'include_global_state' : حقيقي و
'الأجزاء_الحالة' : {
'جار تهيئة' : 0 و
'بدأت' : 0 و
'وضع اللمسات الأخيرة' : 0 و
'فعله' : 94 و
'باءت بالفشل' : 0 و
'المجموع' : 94
} و
'احصائيات' : {
'تدريجي' : {
'file_count' : 282 و
'size_in_bytes' : 750304
} و
'المجموع' : {
'file_count' : 692 و
'size_in_bytes' : 62159894
} و
'start_time_in_millis' : 1663770043239 و
'time_in_millis' : 26212
} و
'المؤشرات' : { < قوي >
قوي > 'دفق البيانات الخاصة بي' : {
'الأجزاء_الحالة' : {
'جار تهيئة' : 0 و
'بدأت' : 0 و
'وضع اللمسات الأخيرة' : 0 و
'فعله' : 1 و
'باءت بالفشل' : 0 و
'المجموع' : 1
} و
'احصائيات' : {
'تدريجي' : {
'file_count' : 0 و
'size_in_bytes' : 0
} و
'المجموع' : {
'file_count' : 10 و
'size_in_bytes' : 13518
} و
-----------------انتاج مقطوع ------------------------
في Kibana ، يمكنك التحقق من حالة اللقطة بالانتقال إلى قسم Stack Management - Snapshot and Restore.
حدد اللقطة المستهدفة واعرض التفاصيل.
ملاحظة : ضع في اعتبارك أن Kibana لا تقدم تفاصيل شاملة كما هو منصوص عليه في Elasticsearch الحصول على حالة لقطة API.
استنتاج
في هذا المنشور ، استكشفنا أساسيات العمل مع واجهة برمجة تطبيقات حالة الحصول على لقطة والتي تتيح لنا إحضار معلومات مفصلة حول لقطة معينة.
شكرا للقراءة!