الاستعلام عن طوبولوجيا Kubernetes بلغة DQL: أربعة قرارات تشغيلية

طوبولوجيا Kubernetes بلغة DQL: أفرغ عقدة ودوّر Secret وارصد الـ pods المنفردة عبر smartscapeNodes وtraverse على Dynatrace SaaS.
Interroger la topologie Kubernetes avec DQL : quatre décisions d'exploitation

الليلة سيُفرغ فريق المنصة العقدة node-07 (drain) لتحديث النواة. سؤال واحد يحسم الموافقة: أي الخدمات ستفقد نسخًا، ومن يجب إبلاغه؟ يجيب مخطط طوبولوجيا Kubernetes في Dynatrace SaaS عن ذلك باستعلام DQL واحد، بشرط أن تعرف كيف تتنقل فيه. ينطلق هذا المقال من أربعة قرارات تشغيلية ويستخرج منها الاستعلامات.

مصدر معلومات الصياغة هو وثائق Dynatrace. أما أفكار حالات الاستخدام فمستوحاة من تدوينة الشركة المزوّدة حول الموضوع. الاستعلامات أدناه أُعيدت كتابتها ولم تُنفَّذ على tenant لأجل هذا المقال، فجرّبها على نطاق صغير قبل الاعتماد عليها. المحتوى خاص بـ Dynatrace SaaS وحده.

تجد الصياغة العامة للأمرين smartscapeNodes وtraverse في المقال عن DQL وSmartscape. لن نعيد هنا شرح الأوامر، بل نستعملها.

لماذا نستعلم عن طوبولوجيا Kubernetes بدل الاكتفاء بـ kubectl

مع kubectl كل إجابة لقطة ثابتة من عنقود (cluster) واحد. ولمعرفة الخدمات المعتمدة على عقدة ما، تكتب ثلاثة أوامر متتالية ثم تقاطع النتائج يدويًا. ومع عشرة عناقيد يصير الأمر عبئًا ثقيلًا.

يخزّن المخطط الكائنات على شكل عُقد (K8S_NODE وK8S_POD وK8S_SERVICE وK8S_NAMESPACE وK8S_DEPLOYMENT وK8S_SECRET) وعلاقاتها على شكل حواف (edges): runs_on تربط الـ pod بعقدته، وroutes_to تربط الخدمة بـ pods التابعة لها، وbelongs_to تربط الكائن بمساحة الأسماء (namespace)، وis_part_of تربط الـ pod بمتحكمه، وuses تربط الـ pod بـ Secret. فيغطي استعلام واحد كل العناقيد المرتبطة بالبيئة.

ثلاثة عناصر صياغة تستحق الحفظ

  • smartscapeNodes "*" يفتتح الاستعلام. يُكتب النوع بلا علامات اقتباس (HOST)، وبين قوسين معقوصين إن تعددت الأنواع، وبين علامتي اقتباس إن كان نمطًا. وتنص الوثائق على أن النمط يقبل 64 رمزًا بديلًا (wildcard) على الأكثر.
  • traverse edge, target_type يتتبع علاقة. الاتجاه الافتراضي forward، وبالخيار direction: backward نصعد عكس اتجاه الحافة، مثلًا من العقدة إلى الـ pods التابعة لها.
  • fieldsKeep يحتفظ بحقول عقدة الانطلاق داخل المصفوفة dt.traverse.history. يضيف كل traverse سجلًا جديدًا، ويعيد dt.traverse.history[0][name] اسم المستوى الأول.

القرار الأول: إفراغ عقدة دون مفاجآت

قبل الإفراغ تريد قائمة بالخدمات المتأثرة مرتبة بعدد الـ pods المفقودة. نبدأ من العقدة، وننزل إلى الـ pods، ثم إلى الخدمات التي توجّه إليها حركة المرور.

smartscapeNodes "*"
| filter type == "K8S_NODE" and name == "node-07"
| traverse runs_on, K8S_POD, direction: backward,
    fieldsKeep: {name, `k8s.namespace.name`, `k8s.cluster.name`}
| traverse routes_to, K8S_SERVICE, direction: backward,
    fieldsKeep: {name}
| fieldsAdd pod = dt.traverse.history[1][name]
| summarize pods_perdus = countDistinctExact(pod),
    by: {service = name,
         namespace = `k8s.namespace.name`,
         cluster = `k8s.cluster.name`}
| sort pods_perdus desc
استعلام DQL لقياس نطاق التأثير ينطلق من عقدة ويستخدم أمري traverse متتاليين باتجاه backward

اقرأ النتيجة بمنهجية. خدمة تفقد pod واحدًا من اثني عشر لا تثير القلق، أما خدمة تفقد podين من اثنين فتستوجب تأجيل الإفراغ. وقد تعني النتيجة الفارغة أن اسم العقدة خاطئ، فتحقق منه أولًا بالاستعلام smartscapeNodes "*" | filter type == "K8S_NODE".

القرار الثاني: من نُبلغ وأين نبحث

لا تخمّن الطوبولوجيا من المسؤول عن ماذا، بل تقرأ الوسوم التي تضعها فرقك على مساحات الأسماء. فإذا كانت لمساحة الأسماء وسم owner، أظهره الاستعلام إلى جانب العنقود:

smartscapeNodes "*"
| filter type == "K8S_NAMESPACE"
| fields namespace = name, cluster = `k8s.cluster.name`, owner = tags[owner]
| sort cluster asc, namespace asc

كل سطر بلا owner ثغرة في الحوكمة وليس خللًا في الاستعلام. عالجها من المصدر، مثلًا بالإثراء الموصوف في المقال عن metadata enrichment في Kubernetes. ثم اجمع هذه القائمة مع نتيجة القرار الأول لتعرف من تتصل به.

القرار الثالث: تدوير Secret دون تعطيل الإنتاج

تغيير Secret يفرض عادةً إعادة تشغيل الـ pods التي تركّبه (mount). فالسؤال إذن: كم pod وكم خدمة تعتمد عليه؟ نبدأ من الـ Secrets ونصعد عبر العلاقة uses.

smartscapeNodes "*"
| filter type == "K8S_SECRET"
| traverse uses, K8S_POD, direction: backward,
    fieldsKeep: {name, `k8s.cluster.name`}
| fieldsAdd pod = name
| traverse routes_to, K8S_SERVICE, direction: backward, fieldsKeep: {name}
| fieldsAdd service = dt.traverse.history[1][name]
| summarize pods = countDistinctExact(pod),
    services = countDistinctExact(service),
    by: {secret = dt.traverse.history[0][name], cluster = `k8s.cluster.name`}
| sort pods desc
استعلام DQL يحسب عدد الـ pods والخدمات المعتمدة على كل Secret في Kubernetes

الـ Secret الذي تركّبه أربعون pod يُدوَّر على عدة دفعات، والذي تركّبه podان يُدوَّر في نافذة الصيانة المعتادة. الرقم أساس للنقاش مع الفرق المعنية، لكنه لا يغني عن رأيها.

القرار الرابع: رصد المخاطر قبل الحادثة

استعلامان أسبوعيان يكفيان ليصيرا عادة. الأول يعرض الـ deployments التي تحتوي pod واحدًا فقط، أي التي لا شبكة أمان لها أثناء الإفراغ:

smartscapeNodes "*"
| filter type == "K8S_DEPLOYMENT"
| traverse is_part_of, K8S_POD, direction: backward,
    fieldsKeep: {name, `k8s.namespace.name`, `k8s.cluster.name`}
| summarize pods = count(),
    by: {deployment = dt.traverse.history[0][name],
         namespace = `k8s.namespace.name`, cluster = `k8s.cluster.name`}
| filter pods == 1

حدّ ينبغي معرفته: الـ deployment الذي لا يملك أي pod لا يظهر، إذ لا شيء فيه ليُعَدّ. أما الاستعلام الثاني فيبحث عن الـ pods التي اختفت خلال اليوم الأخير بفضل الحقل lifetime:

smartscapeNodes "*"
| filter type == "K8S_POD"
| fieldsAdd fin = lifetime[end]
| filter fin < now() - 5m and fin > now() - 1d
| fields pod = name, cluster = `k8s.cluster.name`, namespace = `k8s.namespace.name`, fin
| sort fin desc
استعلام DQL يعرض الـ pods التي اختفت خلال اليوم الأخير اعتمادًا على الحقل lifetime

عتبتا الخمس دقائق واليوم مجرد اختيار، فعدّلهما بحسب وتيرة نشرك. وأي pod يختفي خارج نافذة النشر يستحق سؤالًا. ولتحويل هذه القوائم إلى تنبيهات بدل القراءة اليدوية، راجع تنبيهات Kubernetes على العقد والـ pods والحصص.

ممارسات جيدة لطوبولوجيا Kubernetes في DQL

  • رشّح مبكرًا بحسب type والعنقود، فـ traverse على البيئة كلها أكثر كلفة.
  • سمِّ حقولك بـ fieldsAdd مباشرة بعد كل traverse حتى لا تخلط بين فهارس dt.traverse.history.
  • احفظ الاستعلامات المفيدة في Notebook أو Dashboard. ولمعرفة كيفية العثور على معرّف كيان، راجع المقال عن معرّفات الكيانات.
  • نفّذ كل استعلام على عنقود تجريبي قبل أتمتته.

الأسئلة الشائعة

هل يلزم تفعيل شيء للاستعلام عن طوبولوجيا Kubernetes؟

يلزم أن تغذّي مراقبة Kubernetes بيئة SaaS، وأن يمنحك دورك الوصول إلى جدول Grail المسمى smartscape، وهو يتطلب بحسب الوثائق الإذن storage:smartscape:read. لم أتحقق هنا من إجراء التفعيل كاملًا.

ما الفرق بين smartscapeNodes وsmartscapeEdges؟

يعيد smartscapeNodes الكائنات، ويعيد smartscapeEdges العلاقات. استعمل الحواف لجرد أنواع العلاقات المتاحة، واستعمل traverse لتتبعها من كائن إلى آخر.

هل تعمل هذه الاستعلامات على Dynatrace Managed؟

يقتصر هذا المقال على Dynatrace SaaS. لم أتحقق من توفر هذه الأوامر على Managed، فلا تنقلها إليه دون اختبار.

الخلاصة

لا قيمة للمخطط إلا إذا أجاب عن قرار. إفراغ عقدة، تدوير Secret، رصد نقطة فشل وحيدة: كل استعلام أعلاه يحل محل تقاطع يدوي للبيانات. ولاستكمالها باتجاهات رقمية، عُد إلى أوامر DQL: filter وsummarize وtimeseries. والمرجع الرسمي للصياغة هو صفحة أوامر Smartscape.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Cardinalité des métriques : repérer les séries qui explosent avant la facture

كاردينالية المقاييس: اكتشف السلاسل المنفجرة قبل وصول الفاتورة

Related Posts