تعلن سياسة ILM لديك عن مرحلة warm أو cold، ومع ذلك يبقى الفهرس على عقد hot. في أغلب الحالات يكون السبب هو الإعداد _tier_preference، الذي يُفترض أن يضبطه الإجراء migrate في ILM. يشرح هذا المقال آلية tier preference ILM في Elasticsearch، والأسباب الموثّقة لعدم تطبيقها، وكيفية التشخيص ثم الإصلاح.
بالنسبة لفريق SRE، الرهان ملموس: الفهرس الذي لا ينتقل إلى طبقة أدنى يحتفظ بتخزين مكلف وبعقد ساخنة مشبعة، بينما تبدو السياسة سليمة. يصلح المقال لـ Elasticsearch المستضاف ذاتيًا ولـ Elastic Cloud على حد سواء؛ فهو لا يخص Dynatrace Managed ولا Dynatrace SaaS، لكن التشخيص يندرج ضمن مراقبة عنقود Elasticsearch الموصوفة في دليلنا حول امتداد Dynatrace.
باختصار
- ينقل ILM الفهرس بين الطبقات بالإجراء
migrate، الذي يكتبindex.routing.allocation.include._tier_preference. - بحسب وثائق Elastic، يُحقن هذا الإجراء تلقائيًا في مرحلتي warm وcold.
- مع
"migrate": { "enabled": false }لا ينقل ILM شيئًا: عليك أنت تحديد قواعد التخصيص. - قد تتعارض مرشّحات السمات القديمة (
require.data، وallocateمعincludeأوrequireأوexclude) مع tier preference.
tier preference ILM: ماذا يفعل هذا الإعداد فعلًا
يحدد الإعداد index.routing.allocation.include._tier_preference لـ Elasticsearch الطبقة التي توضع فيها شظايا (shards) الفهرس. بحسب صفحة «Data tiers» من Elastic، يتلقى الفهرس العادي القيمة data_content افتراضيًا، ويتلقى الفهرس المنشأ داخل data stream القيمة data_hot. يقبل الإعداد قائمة مرتبة مفصولة بفواصل: يستخدم Elasticsearch أول طبقة تحتوي على عقد.
توضح صفحة الإجراء migrate القيم التي يضعها ILM: data_warm,data_hot في مرحلة warm، وdata_cold,data_warm,data_hot في مرحلة cold. يمنع الرجوع إلى الطبقات الأكثر سخونة بقاء الفهرس غير مخصّص عندما لا تحتوي الطبقة الهدف على عقد. في مرحلة frozen يركّب ILM الـ searchable snapshot مباشرة بالقيمة data_frozen؛ وفي مرحلة hot لا يُسمح بـ migrate.

تفصيلان مفيدان: ضبط الإعداد على null يزيل التفضيل دون استعادة القيمة الافتراضية، والإعداد لا يلغي تخصيص شظية مخصّصة أصلًا. لتكاليف طبقة frozen، راجع مقالنا حول frozen tier.
لماذا لا ينقل ILM فهارسك
السبب 1: الإجراء migrate معطّل
قيمة المعامل enabled في migrate هي true افتراضيًا. ضبطه على false في مرحلة ما يمنع الانتقال التلقائي. تذكر الوثائق هذا الاستخدام للفرق التي تدير التخصيص يدويًا بالإجراء allocate، وتحذّر: لا تعطّل الانتقال التلقائي دون تحديد قواعد تخصيص يدويًا. وإلا فقد لا تصل البيانات إلى الطبقة الهدف أبدًا بينما تظهر المرحلة مكتملة.

السبب 2: مرشّحات سمات مخصّصة
يقبل الإجراء allocate القيم include (سمة واحدة على الأقل من القائمة) وexclude (ولا واحدة) وrequire (كلها)، وتعتمد على سمات العقد مثل node.attr.box_type. تنتمي هذه المرشّحات إلى النموذج القديم hot-warm-cold. لا تصف وثائق Elastic بدقة كيف يتفاعل require أو exclude مع _tier_preference: فصفحة allocate لا تتناول ذلك، وصفحة migrate تحيل إليها. لذلك تبقى هذه النقطة بحاجة إلى اختبار على إصدارك بدل افتراضها.
أما الموثّق فهو حالة فهرس يحتفظ بـ index.routing.allocation.require.data قديم يتعارض مع tier preference منتهية الصلاحية: يجب حذف هذا الإعداد وتصحيح التفضيل. وتطلب وثائق الترحيل أيضًا إزالة مرشّحات السمات من القوالب (القديمة والقابلة للتركيب والمكوّنات)، وإلا ورثتها الفهارس الجديدة.
السبب 3: لا توجد عقدة بالدور المناسب
في الاستضافة الذاتية، تُعلن الأدوار data_hot وdata_warm وdata_cold وdata_frozen وdata_content في elasticsearch.yml. وفي Elastic Cloud Hosted أو ECE تُضمَّن افتراضيًا طبقة مشتركة hot وcontent لا يمكن إزالتها؛ أما warm وcold وfrozen فتُضاف من الواجهة. وعند غياب عقد في الطبقة الهدف، تعيد قائمة الرجوع الفهرس إلى طبقة أكثر سخونة، فيبدو الأمر كأن الانتقال يفشل.
لسياسة الاحتفاظ في المنبع، راجع أيضًا دليل logsdb.
التشخيص خطوة بخطوة
- اقرأ حالة ILM بالطلب
GET <index>/_ilm/explain: تعطي الاستجابة السياسة والمرحلة والإجراء والخطوة الحالية. يلزم الامتيازانmanage_ilmوview_index_metadata. - اقرأ إعدادات الفهرس وابحث عن
index.routing.allocation.include._tier_preference، وكذلك عن أيrequire.dataأو مرشّحات سمات أخرى. - أعد قراءة السياسة: هل مرحلة warm أو cold فيها
migrate.enabled: false؟ وهل يوجد إجراءallocateبمرشّحات؟ - استعلم عن التخصيص بالطلب
GET _cluster/allocation/explain(الجسم:indexوshardوprimary). تسرد الاستجابة، عقدة بعقدة، الـ deciders وقرارها (NOأوYESأوTHROTTLE). - تحقق من أدوار العقد في
elasticsearch.ymlأو في إعدادات النشر.
الإصلاح: الانتقال من السمات إلى data tiers
تصف وثائق Elastic مسار ترحيل من مرشّحات السمات إلى أدوار العقد. الخطوات التي ينبغي تذكرها: إسناد أدوار الطبقات إلى العقد، وتنظيف إجراءات allocate من السياسات (إجراء allocate الفارغ غير صالح ويجب حذفه)، وإزالة المرشّحات من القوالب، ثم تحديث الفهارس الموجودة (require.data إلى null و_tier_preference المناسبة). يجب أن توجد كل مرحلة من كل طبقة في معماريتك، ولو كانت فارغة، حتى يستطيع ILM حقن migrate.
تؤتمت الواجهة POST /_ilm/migrate_to_data_tiers ثلاثًا من هذه الخطوات الأربع. تقبل dry_run (محاكاة، وقيمته الافتراضية false) وlegacy_template_to_delete وnode_attribute، وتسرد في استجابتها السياسات والفهارس والقوالب المرحَّلة. يجب إيقاف ILM قبل الاستدعاء.
POST /_ilm/stop
GET /_ilm/status # attendre "operation_mode": "STOPPED"
POST /_ilm/migrate_to_data_tiers?dry_run=true
POST /_ilm/migrate_to_data_tiers
POST /_ilm/start

شغّل dry_run=true أولًا وراجع قائمة الفهارس والسياسات المتأثرة. في Elastic Cloud، بحسب الوثائق، يُقترح الترحيل تلقائيًا عند الترقية إلى 7.10 أو أحدث، أو عند إضافة طبقة warm أو cold أو frozen؛ ثم يجب التحقق من القوالب المخصّصة.
كيف تتحقق من أن الأمر يعمل
أعد تشغيل GET <index>/_ilm/explain وتأكد من أن الفهرس يتقدم عبر المراحل. ثم راجع الإعداد _tier_preference: يجب أن يطابق المرحلة (data_warm,data_hot في warm). وأخيرًا تحقق من أن الشظايا على عقد الطبقة المتوقعة.
الصلة بقابلية الملاحظة
يظهر الفهرس العالق على طبقة hot أولًا في مقاييس العنقود: مساحة القرص وعدد الشظايا في كل عقدة. اكشفها عبر OpenTelemetry Collector (دليل Elasticsearch وOpenTelemetry)، ونبّه على تشبّع عقد hot بدل الاكتفاء بفشل ILM، الذي قد يظهر كأنه مكتمل. وللسياق، راجع الفرق بين قابلية الملاحظة والمراقبة.
أفضل الممارسات
- أبقِ
migrateمفعّلًا إلا لحاجة محددة، ولا تعطّله أبدًا دون قواعد تخصيص يدوية. - فضّل أدوار العقد على السمات المخصّصة.
- اختبر كل ترحيل بوضع
dry_runقبل تنفيذه. - نبّه على عمر الفهارس في كل طبقة، وليس فقط على حالة السياسات.
الأسئلة الشائعة
ما هو _tier_preference؟
هو إعداد الفهرس index.routing.allocation.include._tier_preference، وهو قائمة مرتبة من الطبقات توضع فيها الشظايا. يضبطه ILM عبر الإجراء migrate.
لماذا مرحلة warm لديّ «complete» بينما لم يتحرك شيء؟
مع migrate.enabled: false ودون قاعدة تخصيص يدوية، تشير الوثائق إلى أن البيانات قد لا تصل إلى الطبقة الهدف بينما تُعلَّم المرحلة كمكتملة.
هل يجب حذف الإجراء allocate؟
إذا لم يعد يحتوي إلا على مرشّحات سمات قديمة، توصي وثائق الترحيل بإزالتها؛ والإجراء allocate الفارغ غير صالح ويجب حذفه.
الخلاصة
عندما لا ينقل ILM فهارسك، ابدأ بـ migrate.enabled، ثم بمرشّحات السمات القديمة وأدوار العقد. تبقى الصفحات الرسمية المذكورة أدناه هي المرجع لإصدارك.
المصادر
- Data tiers، وثائق Elastic
- ILM migrate، وثائق Elastic
- ILM allocate، وثائق Elastic
- Migrate index allocation filters to node roles، وثائق Elastic
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا لشركة Elastic N.V. Dynatrace علامة تجارية لشركة Dynatrace LLC. أسماء المنتجات تعود إلى مالكيها؛ الأمثلة مأخوذة من الوثائق الرسمية أو خيالية، ويجب التحقق منها على إصدارك.