الوحدة 4 — إنشاء SLO في Dynatrace Managed: المعالج وmetric expression وAPI

إنشاء SLO في Dynatrace Managed: معالج من 4 خطوات وmetric expression وentity selector والفترة وburn rate، ثم واجهة /api/v2/slo والتحقق.
Module 4 — Créer un SLO Managed : assistant, metric expression et API

الوحدة 4 من دورة SLO وSLA: إنشاء SLO في Dynatrace Managed، أي SLO كلاسيكي يُعرَّف بـmetric expression وentity selector وفترة تقييم وعتبات، من المعالج أو عبر واجهة /api/v2/slo.

المسار: دورة SLO وSLA · الوحدة 4/6 · المدة: نحو 40 دقيقة · المستوى: متوسط · المنصة: Dynatrace Managed (أهداف SLO الكلاسيكية وmetric expressions وAPI v2)

الأهداف:

  • إنشاء SLO بمعالج من أربع خطوات
  • كتابة metric expression للتوافر وللأداء
  • ترشيح الكيانات واختيار فترة التقييم
  • إنشاء SLO وقراءته عبر API بنطاق الرمز الصحيح

المتطلبات: الوحدتان 1 و2، وبيئة Managed، ورمز API يحمل النطاقين slo.read وslo.write.

في Dynatrace Managed لا يوجد Grail ولا DQL: تُسمى أهداف SLO «كلاسيكية» وتعتمد على مقاييس builtin: وعلى metric selector. ويبقى المبدأ هو نفسه في الوحدة 1: مؤشر SLI بنسبة مئوية وهدف وفترة. وحده أسلوب كتابة SLI يتغير.

تصح هذه الوحدة على Dynatrace Managed. أما المقابل في Dynatrace SaaS، مع تطبيق Service-Level Objectives ولغة DQL، فتعالجه الوحدة 3. ولنظرة أوسع على الإعداد وواجهة API انظر أيضًا SLO في Dynatrace Managed: الإعداد وواجهة API.

إنشاء SLO في Dynatrace Managed بالمعالج

اذهب إلى Service-Level Objectives واختر Add new SLO واتبع خطوات المعالج الأربع: Select your indicators وDefine a filter وAdd success criteria وEvaluate.

الخطوة 1: اختيار المؤشر

تقترح وثائق Managed ستة أهداف SLO مهيأة مسبقًا:

  • Service-level availability: الاستدعاءات الناجحة مقسومة على مجموع استدعاءات الخدمة؛
  • Service-method availability: الحساب نفسه على الطلبات الرئيسة (key requests)؛
  • Service performance: الدقائق «الجيدة» (زمن الاستجابة دون العتبة) مقسومة على مجموع الدقائق؛
  • User experience: نسبة المستخدمين SATISFIED بحسب Apdex؛
  • Mobile crash-free users: نسبة مستخدمي الجوال دون انهيار؛
  • Synthetic availability: عمليات التنفيذ الاصطناعية الناجحة من المجموع.

ثم أدخل اسم SLO وMetric name، مثلًا checkout_availability. ويشتق Dynatrace منه أربعة مفاتيح مقاييس: func:slo.checkout_availability (الحالة) وfunc:slo.errorBudget.checkout_availability وfunc:slo.normalizedErrorBudget.checkout_availability وfunc:slo.errorBudgetBurnRate.checkout_availability. فاختر هذا الاسم بعناية: تنص الوثائق على أنه لا يمكن تعديله بعد الإنشاء.

الخطوة 2: المرشح والفترة

يقترح محدد الفترة قيمًا جاهزة (Presets) أو قيمة Custom. ويتبع entity selector صيغة REST API: منطقة الإدارة (الاسم أو المعرّف) والوسوم واسم الكيان أو معرّفه أو نوعه وحالة السلامة، أو توليفة منها. ويتحقق الزر Preview من المحدد قبل المتابعة. مثال من الوثائق:

type("SERVICE"),entityName("My service")

إدراج منطقة إدارة في entity selector يربط SLO بتلك المنطقة: فلا يراه إلا المستخدمون الذين لهم وصول إليها. أما SLO بلا منطقة فهو عام ويراه الجميع.

الخطوة 3: معايير النجاح

أدخل الهدف (Failure) والتحذير (Warning). ويجب أن يقع التحذير بين الهدف و100%: فمع هدف 99% اختر مثلًا 99.5%. فعّل Error budget burn rate وحدد العتبة بين الاحتراق البطيء والسريع.

الخطوة 4: التقييم ثم الإنشاء

يحسب Evaluate قيمة SLO بالقيم المدخلة. وإن لم يظهر خطأ فإن Create يحفظه ويظهر في القائمة. ويمكن للمستخدمين المتقدمين أيضًا المرور بـSettings > Cloud Automation > Definition > Add new SLO.

كتابة metric expression

تنتج metric expression مؤشر SLI بنسبة مئوية. وللتوافر على مستوى الخدمة تعطي الوثائق:

(100)*(builtin:service.errors.server.successCount:splitBy())/(builtin:service.requestCount.server:splitBy())

التعبير :splitBy() بلا وسيط يدمج كل الكيانات التي اختارها المرشح في سلسلة واحدة: فيعيد SLO قيمة واحدة. وتذكر الوثائق خطأ «One resulting value is required, but the SLO definition delivers more than one» ضمن المشكلات المعروفة؛ وهو يحدث عادة حين يغيب هذا التجميع.

ولـSLO أداء قائم على شرائح الزمن تقترح الوثائق تعبيرًا يحصي الفواصل «الجيدة»:

مثال من وثائق Dynatrace Managed: metric expression لـSLO من نوع Service performance مع partition باسم latency وlt(10000)، وentity selector هو type("SERVICE"),entityName("My service")

الأسطر الحاسمة: partition("latency",value("good",lt(10000))) يصنّف كل نقطة بحسب زمن الاستجابة؛ وتوضح الوثائق أن الوحدة المطلوبة هي الميكروثانية، فـlt(10000) تعني أقل من 10 ms. و:default(0) يستبدل القيم المعدومة، و:default(100,always) يعيد 100% إن لم توجد بيانات. ولعتبة 500 ms اكتب lt(500000).

إنشاء SLO عبر API

لوضع أهداف SLO تحت التحكم في الإصدارات استعمل نقطة النهاية POST /api/v2/slo في البيئة. ويجب أن يحمل الرمز النطاق slo.write. وهذا نموذج متن الطلب من الوثائق، بعد حذف الحقول الموسومة DEPRECATED (metricNumerator وmetricDenominator وmetricRate وuseRateMetric):

متن الطلب POST /api/v2/slo بحسب نموذج وثائق Dynatrace Managed: evaluationType بقيمة AGGREGATE وfilter وmetricExpression وmetricName وtarget بقيمة 95 وtimeframe بقيمة -1d وwarning بقيمة 97.5 وerrorBudgetBurnRate

نقاط يجب معرفتها، كلها من الوثائق:

  • الحقول name وtarget وwarning وtimeframe وevaluationType (قيمته الوحيدة: AGGREGATE) إلزامية؛
  • قيمة enabled الافتراضية false: فبدونه يُنشأ SLO معطَّلًا؛
  • يتبع filter صيغة entity selector ولا يتجاوز 1000 حرف؛
  • يتبع timeframe صيغة محدد الفترة العام؛ ويستعمل النموذج -1d، فعدّله بحسب فترتك؛
  • الاستجابة 201 بلا متن: ومعرّف SLO الجديد في ترويسة Location.
curl -s -i -X POST "https://{your-domain}/e/{environment-id}/api/v2/slo" \
  -H "Authorization: Api-Token $DT_TOKEN" \
  -H "Content-Type: application/json" \
  -d @slo.json

ولإدارة أهداف SLO بوصفها شيفرة على المدى الطويل انظر أهداف SLO في Dynatrace مع Terraform.

كيف تتحقق من أن الأمر يعمل

  1. اقرأ SLO المقيَّم (النطاق slo.read):
    curl -s "https://{your-domain}/e/{environment-id}/api/v2/slo?sloSelector=name(%22Payment%20service%20availability%22)&evaluate=true" \
      -H "Authorization: Api-Token $DT_TOKEN"
  2. افحص الحقول: evaluatedPercentage (الحالة؛ وقيمة -1 عند الخطأ، فانظر حينئذ الحقل error)، وerrorBudget (القيمة الموجبة تعني أن كل شيء بخير)، وstatus (SUCCESS أو WARNING أو FAILURE)، وerrorBudgetBurnRate.burnRateValue المحسوب على الساعة الأخيرة.
  3. مع evaluate=true يُحدَّد حجم الصفحة بـ25. ولفترة غير فترة SLO أضف timeFrame=GTF مع from وto.
  4. في الواجهة افتح Actions > View in Data Explorer لرسم المفتاح func:slo.….

مثال على القراءة: الهدف 95 والحالة 96.25 يعطيان errorBudget = 1.25. وإذا فُعِّلت الميزانية المطبَّعة (Settings > Cloud Automation > Setup) فإن الوثائق تحسبها هكذا: (96.25 − 95) ÷ (100 − 95) × 100 = 25% من الميزانية المتبقية.

التنبيه على SLO

من القائمة يقترح More (…) > Create alert نوعين: Status (حين تنخفض الحالة عن الهدف) وBurn rate. وتقوم التنبيهات على metric events تُقيَّم على الساعة الأخيرة: فعتبة 10 تطلق التنبيه حين يتجاوز burn rate القيمة 10 خلال الساعة المنقضية. وتوضح الوثائق أن Davis لا ينبه على انتهاك الهدف نفسه، بل على المقاييس والكيانات الكامنة وراءه. وتُفصَّل استراتيجيات التنبيه في تنبيهات burn rate لأهداف SLO وفي الوحدة 5.

تمرين عملي

  1. أنشئ بالمعالج SLO من نوع Service-level availability على خدمة في بيئة اختبار، بهدف 99% وتحذير 99.5% وburn rate مفعَّل.
  2. أنشئ SLO نفسه عبر API بقيمة metricName مختلفة، مع الانتباه إلى "enabled": true.
  3. النتيجة المتوقعة: يعرض الهدفان قيمة evaluatedPercentage نفسها في GET /api/v2/slo?evaluate=true.

اختبار قصير

  1. أي نطاق لازم لإنشاء SLO عبر API؟ أ) metrics.read ب) slo.read ج) slo.write د) settings.read
  2. في SLO أداء تعني lt(10000): أ) 10 ثوانٍ ب) 10 ms ج) 10 µs د) 10000 طلب
  3. ماذا يحدث إذا حُذف enabled؟ أ) خطأ 400 ب) SLO مفعَّل ج) SLO معطَّل د) SLO محذوف

الإجابات

  1. ج) slo.write؛ أما القراءة فتحتاج slo.read.
  2. ب) الوحدة هي الميكروثانية: 10000 µs = 10 ms.
  3. ج) القيمة الافتراضية هي false.

أفضل الممارسات

  • اختر metricName بعناية: فهو ثابت ويُستعمل في كل الرسوم البيانية.
  • أنهِ metric expression دائمًا بتجميع واحد (:splitBy()).
  • اربط أهداف SLO الخاصة بالفرق بمنطقة إدارة؛ وأبقِ أهداف الإدارة العليا عامة.
  • قيّم SLO قبل إنشائه وقارنه بحساب يدوي.

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

هل أستطيع استعمال DQL في SLO على Managed؟

لا. ليس في Dynatrace Managed أي Grail: يُكتب SLI بـmetric expression. وDQL مخصص لأهداف SLO في Dynatrace SaaS (الوحدة 3).

هل ما زالت الحقول metricNumerator وmetricDenominator مفيدة؟

هي موسومة DEPRECATED في وثائق API. استعمل metricExpression الذي يغطي النسبة كما يغطي التعبيرات الأكثر تعقيدًا.

كيف أقارن أهداف SLO هذه بأهداف أدوات أخرى؟

المفاهيم نفسها، والذي يتغير هو كتابة SLI. وتوجد مقارنة مفصلة في SLO في Dynatrace وGrafana.

صرت تعرف إنشاء SLO في Managed، بالمعالج أو بواجهة API، والتحقق منه. وتقرر الوحدة التالية ما نفعله حين تذوب الميزانية: سياسة ميزانية الأخطاء.

→ الوحدة 3: SLO في Dynatrace SaaS · فهرس المسار · الوحدة 5: سياسة ميزانية الأخطاء ←

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. الشاشات والحقول والنطاقات المذكورة مستمدة من وثائق Dynatrace Managed الرسمية (Configure and monitor SLOs وPOST an SLO)؛ تحقق منها في إصدار عنقودك.

Total
0
Shares
Leave a Reply

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

Previous Post
Module 3 — SLO Dynatrace SaaS : créer un objectif dans l'app Service-Level Objectives

الوحدة 3 — SLO في Dynatrace SaaS: إنشاء هدف في تطبيق Service-Level Objectives

Next Post
Module 5 — Politique de budget d'erreur : seuils, gel des déploiements et alertes burn rate

الوحدة 5 — سياسة ميزانية الأخطاء: العتبات وتجميد النشر وتنبيهات burn rate

Related Posts