تعمل أهداف SLO الكلاسيكية لديك منذ سنوات، لكن تعبيرات المقاييس فيها صارت صعبة الصيانة ويريد الفريق إدارة كل شيء بلغة DQL. ترحيل SLO إلى Grail لا يتم بنقرة واحدة: يجب إعادة كتابة كل هدف ومقارنته ثم نقله دون فقدان تاريخ ميزانية الأخطاء (error budget). يشرح هذا الدرس كيف تنقل أهداف SLO إلى Grail هدفًا بعد هدف دون كسر تنبيهاتك.
الهدف: في النهاية ستمتلك جردًا لأهداف SLO الكلاسيكية، ومكافئها بلغة DQL على Grail، وفترة تشغيل مزدوج تثبت أن الحسابين متطابقان، وخطة لنقل التنبيهات. يخص المحتوى Dynatrace SaaS: فأهداف SLO الجديدة تقوم على Grail غير الموجودة في Dynatrace Managed. وفي Managed تبقى على أهداف SLO الكلاسيكية؛ ويبيّن القسم المخصص لاحقًا ما ينبغي تحضيره.
إن كنت تبدأ من الصفر في المؤشرات فاقرأ أولًا كيف تختار مؤشرات SLI بلغة DQL.
المشكلة: محرّكان لـ SLO يتباعدان
يحسب SLO الكلاسيكي نسبته انطلاقًا من تعبير مقاييس (مثلًا builtin:service.errors.total.successCount مقسومًا على builtin:service.requestCount.total). أما SLO على Grail فيحسبها انطلاقًا من استعلام DQL. ولا يجمع المحرّكان بالضرورة بالطريقة نفسها: الدقة، والتعامل مع فجوات البيانات، ونطاق الكيانات. وبلا مقارنة قد تنتقل إلى SLO يعرض 99.95% حيث كان القديم يعرض 99.80%، فتخفي استهلاكًا حقيقيًا للميزانية.
المتطلبات المسبقة
- بيئة Dynatrace SaaS على منصة Grail، مع تطبيق Service-Level Objectives (قد يختلف العنوان الدقيق بحسب الإصدار: تحقق في docs.dynatrace.com).
- رمز API كلاسيكي بنطاق قراءة أهداف SLO (
slo.read) للجرد. - صلاحيات قراءة المقاييس في Grail وإنشاء أهداف SLO في التطبيق الجديد.
- الأداتان
curlوjqعلى جهازك.
الخطوة 1: اجرد أهداف SLO الكلاسيكية
تعيد واجهة API v2 لأهداف SLO الكلاسيكية قائمة مقسمة إلى صفحات، مع الهدف والنافذة وتعبير المقاييس.
export DT_ENV="https://VOTRE-ENV.live.dynatrace.com"
export DT_TOKEN="dt0c01.XXXX" # scope slo.read
curl -s "$DT_ENV/api/v2/slo?pageSize=200&evaluate=false" \
-H "Authorization: Api-Token $DT_TOKEN" \
| jq -r '.slo[] | [.id, .name, .target, .timeframe, .metricExpression] | @tsv' \
> inventaire-slo.tsv
wc -l inventaire-slo.tsv
الحقول الحاسمة: target (الهدف، مثل 99.9) وtimeframe (مثل -30d) وmetricExpression، وهي الصيغة التي ستُترجم. وإن احتوت الاستجابة على nextPageKey فأعد الاستدعاء بهذا المعامل.
الخطوة 2: افرز قبل الترحيل
لا ترحّل كل شيء. صنّف كل سطر من الجرد في ثلاث مجموعات:
- للترحيل: SLO متابَع، مرتبط بتنبيه أو بلوحة معلومات.
- للدمج: عدة أهداف تقيس الرحلة نفسها بمرشحات مختلفة قليلًا.
- للحذف: SLO يتيم لا يطلع عليه أحد. كل SLO يُحتفظ به يكلّف صيانة: وهذا عمل رتيب (toil).
الخطوة 3: ترحيل SLO إلى Grail هدفًا بعد هدف بإعادة كتابة SLI بلغة DQL
لنأخذ SLO كلاسيكيًا لمعدل نجاح خدمة. في Grail تُعرض مقاييس الخدمة بمفاتيح مثل dt.service.request.count وdt.service.request.failure_count. يحسب الاستعلام التالي مؤشر SLI على الفترة نفسها:
timeseries {
total = sum(dt.service.request.count),
failures = sum(dt.service.request.failure_count)
},
by: { dt.entity.service },
filter: { in(dt.entity.service, "SERVICE-0123456789ABCDEF") }
| fieldsAdd sli = 100 * (total[] - failures[]) / total[]
نقاط تستحق الانتباه:
- العبارة
total[] - failures[]تطبّق العملية على كل فاصل من السلسلة: فالمؤشر إذن سلسلة زمنية، وهذا ما ينتظره SLO مخصص. - اسم حقل الإخراج مهم. فقوالب أهداف SLO المخصصة تنتظر حقلًا محددًا (غالبًا
sli): تحقق من الاصطلاح في وثائق التطبيق قبل الاعتماد. - استبدل معرّف الخدمة المكتوب يدويًا بمرشح على وسم أو منطقة حالما تتعدد الخدمات المعنية.
ثم أنشئ الـ SLO في التطبيق: الصق الاستعلام، وأبقِ بالضبط الهدف والنافذة نفسيهما كما في SLO الكلاسيكي. فتغيير الهدف أثناء الترحيل يجعل المقارنة بلا قيمة.
الخطوة 4: التشغيل المزدوج
أبقِ الهدفين نشطين طوال نافذة كاملة على الأقل، ويفضل نافذتان. قارن القيم كل يوم. في الجانب الكلاسيكي تعيد واجهة API التقييم:
curl -s "$DT_ENV/api/v2/slo/ID_DU_SLO?timeFrame=CURRENT" \
-H "Authorization: Api-Token $DT_TOKEN" \
| jq '{name, evaluatedPercentage, errorBudget}'
وفي جانب Grail أعد استخدام استعلام الخطوة 3 مع التجميع على النافذة كاملة:
timeseries {
total = sum(dt.service.request.count),
failures = sum(dt.service.request.failure_count)
},
from: now()-30d,
filter: { in(dt.entity.service, "SERVICE-0123456789ABCDEF") }
| fieldsAdd t = arraySum(total), f = arraySum(failures)
| fieldsAdd sli = 100 * (t - f) / t
| fields sli
تسامح مع فارق صغير (بضعة أجزاء من مئة من النقطة) سببه اختلاف طرائق التجميع. أما الفارق الأكبر فيدل غالبًا على نطاق مختلف: خدمة أُضيفت، أو مرشح الطلبات الأساسية نُسي، أو طلبات اصطناعية محسوبة في جانب دون آخر.
الخطوة 5: انقل التنبيهات
لا ينتهي الترحيل إلا حين ينبَّه فريق المناوبة بواسطة الـ SLO الجديد. اعتمد منطق النوافذ المتعددة الموصوف في تنبيهات burn rate لـ SLO في Dynatrace، مطبَّقًا على SLO في Grail. فعّل التنبيه الجديد، واترك القديم يعمل بالتوازي أيامًا، ثم عطّل القديم. ولا تحذف SLO الكلاسيكي إلا بعد تصدير تاريخه إن كانت تقاريرك الشهرية تعتمد عليه.
وإن كنت تدير أهداف SLO بوصفها شيفرة، فحدّث تعريفات Terraform بدل النقر في الواجهة: راجع أهداف SLO في Dynatrace مع Terraform. وتحقق في وثائق المزوّد من المورد المقابل لأهداف SLO الجديدة، فهو يختلف عن مورد الأهداف الكلاسيكية.
وماذا عن Dynatrace Managed؟
لا تتوفر Grail في Dynatrace Managed: أهداف SLO الجديدة غير متاحة فيه. ومع ذلك يمكنك التحضير لترحيل مستقبلي إلى SaaS:
- صدّر الجرد بالاستدعاء نفسه لواجهة API (يحتوي العنوان عندئذ على
/e/ID-ENVIRONNEMENT)؛ - نظّف أهداف SLO اليتيمة من الآن؛
- وثّق لكل SLO قصده المهني في جملة واحدة. فهي ستبقى بعد إعادة الكتابة.
كيف تتأكد أن كل شيء يعمل
- في تطبيق أهداف SLO يعرض الهدف الجديد حالة وميزانية أخطاء متبقية، دون رسالة خطأ في الاستعلام.
- يُظهر جدول مقارنة التشغيل المزدوج فارقًا مستقرًا وصغيرًا على النافذة كلها.
- في Notebook يعيد استعلام الخطوة 4 سطرًا واحدًا بقيمة
sliمتسقة مع التطبيق. - يؤدي اختبار مضبوط (أخطاء تُحقن في بيئة ما قبل الإنتاج) إلى انخفاض الهدفين بالطريقة نفسها ويطلق التنبيه الجديد.
أفضل الممارسات
- هدف ثابت أثناء الترحيل: نغيّر المحرك أو الهدف، لا الاثنين معًا.
- الترحيل على دفعات: ابدأ بأكثر ثلاثة أهداف متابعةً، لا بالخمسين كلها.
- تسمية واضحة: لاحقة مؤقتة مثل «(Grail)» تمنع الخلط بين الهدفين أثناء التشغيل المزدوج.
- توثيق القرارات: دوّن في تذكرة كل دمج أو حذف مع سببه.
- مراجعة لوحات المعلومات: يجب أن تتبع البلاطات المشيرة إلى SLO القديم، راجع لوحة معلومات SLO للإدارة العليا.
الأسئلة الشائعة
هل توجد أداة ترحيل آلي لأهداف SLO الكلاسيكية؟
تتغير القدرات بحسب إصدارات Dynatrace SaaS. راجع الوثائق الرسمية لمعرفة هل يُقترح معالج للتحويل في بيئتك. وحتى مع وجود معالج يبقى التشغيل المزدوج ضروريًا للتحقق من الأرقام.
هل يضيع تاريخ ميزانية الأخطاء عند الترحيل؟
يعيد الهدف الجديد حساب مؤشره من البيانات الموجودة في Grail، بحسب مدة الاحتفاظ بمقاييسك. أما تاريخ SLO الكلاسيكي فلا ينتقل كما هو. صدّره إن احتجت إليه في التقارير.
هل يمكن إبقاء أهداف كلاسيكية وأهداف Grail معًا؟
نعم، بل يُنصح بذلك أثناء المرحلة الانتقالية. وعلى المدى البعيد تجنب مصدرين للحقيقة لهدف واحد: يجب أن يعرف فريق المناوبة أي رقم هو المعتمد.
الخلاصة
ترحيل SLO إلى Grail يبدأ بالفرز، ثم إعادة كتابة كل SLI بلغة DQL، ثم المقارنة طوال نافذة كاملة، وبعدها فقط نقل التنبيهات. هذا الانضباط يمنع «كسب» نقاط موثوقية بمجرد تغيير طريقة الحساب، ويُبقي ميزانية الأخطاء صادقة.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لمالكها. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك، فميزات SaaS تتطور بسرعة.