تدير عنقودًا (cluster) داخل المؤسسة وتريد أهداف موثوقية قابلة للقياس لا مجرد لوحات معلومات. أهداف SLO Dynatrace Managed موجودة، لكنها لا تعمل كما تعمل أهداف SLO الجديدة في منصة SaaS: لا Grail ولا DQL، والاعتماد كله على محددات المقاييس (metric selectors). وتكتشف فرق كثيرة هذه الفروق لحظة ربط التنبيهات.
الهدف: في نهاية هذا الدرس سيكون لديك هدف SLO للتوافر على خدمة حرجة، أُنشئ من الواجهة ثم عبر API Environment v2، ومحفوظ بصيغة JSON تحت إدارة الإصدارات، وستعرف كيف تتحقق من حالته وميزانية أخطائه (error budget). المحتوى ينطبق على Dynatrace Managed. وتُذكر الفروق مع Dynatrace SaaS في قسم مخصص.
إن لم تختر مؤشراتك بعد، فابدأ بـ اختيار مؤشرات SLI: لا فائدة من SLO إلا إذا عكس مؤشر SLI تجربة المستخدم.
المشكلة: SLO Dynatrace Managed ليس SLO من Grail
في SaaS الحديث يعتمد الـ SLO على استعلام DQL وعلى بيانات Grail. أما في Managed فالـ SLO كائن إعدادات في البيئة، يُقيَّم انطلاقًا من تعبير مقياس (metric selector) على المقاييس الكلاسيكية، مثل builtin:service.*. النتائج العملية:
- يجب أن يكون مؤشر SLI قابلًا للتعبير بالمقاييس المتاحة في البيئة (المدمجة أو المحسوبة أو المستوعَبة)؛
- نافذة التقييم مدى نسبي (مثل
-1w) وليست تقويمًا حرًّا؛ - مدة الاحتفاظ بمقاييس العنقود تحدّ عمق السجل التاريخي الممكن استغلاله.
المتطلبات المسبقة
- بيئة Dynatrace Managed محدّثة، فيها خدمة واحدة على الأقل يراقبها OneAgent.
- مستخدم يملك صلاحية تعديل إعدادات البيئة.
- رمز API مميّز (API token) للبيئة بنطاقي
slo.readوslo.write(وmetrics.readللتحقق). تُسرد الأسماء الدقيقة للنطاقات في صفحة إنشاء الرمز: تحقق منها في إصدارك. curlوjqعلى جهازك.
في الأمثلة، يأخذ عنوان API الخاص بـ Managed الشكل https://{votre-cluster}/e/{environment-id}/api/v2/.
الخطوة 1: تعريف مؤشر SLI بمحدد مقياس
لنأخذ مؤشر SLI للتوافر: نسبة طلبات الخادم الخالية من الأخطاء. اختبر التعبير أولًا في مستكشف البيانات، أو عبر API المقاييس:
export DT_ENV="https://cluster.example.com/e/abc12345"
export DT_TOKEN="dt0c01.XXXX"
curl -s -G "$DT_ENV/api/v2/metrics/query" \
-H "Authorization: Api-Token $DT_TOKEN" \
--data-urlencode 'metricSelector=(100)*(builtin:service.errors.server.successCount:splitBy())/(builtin:service.requestCount.server:splitBy())' \
--data-urlencode 'entitySelector=type(SERVICE),entityId(SERVICE-0123456789ABCDEF)' \
--data-urlencode 'from=-1w' | jq '.result[0].data[0].values[-5:]'
نقاط حرجة: يجب أن يتعلق المعامِلان بالكيان نفسه، وsplitBy() من دون وسيط يجمع كل شيء. إذا أعاد الاستعلام قيمًا فارغة فالمقياس غير موجود بهذا الاسم في إصدارك: اسرد المقاييس بـ GET /api/v2/metrics?text=service.errors.
الخطوة 2: إنشاء SLO Dynatrace Managed من الواجهة
من القائمة افتح Service-level objectives (قد يختلف الاسم بحسب الإصدار)، ثم أضف SLO. املأ:
- الاسم واسم مقياس قصير (يُستخدم لبناء مقاييس
func:slo.*)؛ - تعبير المقياس من الخطوة 1؛
- مرشّح الكيان (الخدمة المعنية)؛
- الهدف (مثل 99.5) وعتبة التحذير (مثل 99.8)؛
- نافذة التقييم (مثل 7 أيام).
يتيح المعالج أيضًا الانطلاق من قوالب جاهزة. هذا مفيد للتجربة الأولى، لكن أبقِ التعبير صريحًا لتتمكن من مراجعته.
الخطوة 3: إنشاء الـ SLO نفسه عبر API
لتجنب انحراف الإعدادات بين البيئات، صِف الـ SLO في ملف خاضع لإدارة الإصدارات:
{
"enabled": true,
"name": "checkout - disponibilite",
"customDescription": "Requetes serveur sans erreur, service checkout",
"metricName": "checkout_availability",
"metricExpression": "(100)*(builtin:service.errors.server.successCount:splitBy())/(builtin:service.requestCount.server:splitBy())",
"evaluationType": "AGGREGATE",
"filter": "type(\"SERVICE\"),entityId(\"SERVICE-0123456789ABCDEF\")",
"target": 99.5,
"warning": 99.8,
"timeframe": "-1w"
}
curl -s -X POST "$DT_ENV/api/v2/slo" \
-H "Authorization: Api-Token $DT_TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d @slo-checkout.json -i | head -n 1
تؤكد الاستجابة 201 الإنشاء. قد يتغير مخطط الجسم من إصدار عنقود إلى آخر: قارنه بمرجع API الخاص بـ SLO على docs.dynatrace.com قبل اعتماده على نطاق واسع. ولإدارة عدة أهداف SLO تبقى Terraform أمتن طريق، وهي مفصّلة في SLO Dynatrace Terraform.
الخطوة 4: ربط تنبيه
هدف SLO بلا تنبيه يبقى مجرد رقم. في Managed هناك نهجان: تنبيه على الحالة أو على ميزانية الأخطاء، وتنبيه على معدل الاستهلاك (burn rate) عبر حدث مقياس على مقاييس func:slo.*. الثاني أنفع للمناوبة، وهو موصوف خطوة بخطوة في تنبيهات burn rate لـ SLO. ثم وجّه التنبيه بملف تنبيه (alerting profile) مخصص، كما في التنبيه وملفاته وتكاملاته.
كيف تتحقق من أن الأمر يعمل
- اسرد أهداف SLO واسترجع المعرّف:
curl -s "$DT_ENV/api/v2/slo?pageSize=25&evaluate=true" \ -H "Authorization: Api-Token $DT_TOKEN" \ | jq '.slo[] | {id, name, status, evaluatedPercentage, errorBudget}' - تأكد أن
evaluatedPercentageقريب من القيمة التي حصلت عليها في الخطوة 1. من دونevaluate=trueلا تقيّم القائمة أهداف SLO (ويكون حجم الصفحة حينئذ محدودًا بـ 25). الفارق الكبير يدل غالبًا على اختلاف مرشّح الكيان. - إن بقيت الحالة فارغة أو في خطأ، فإن الحقل
errorفي الاستجابة يبيّن السبب عادة (تعبير غير صالح، كيان غائب). - في الواجهة، يجب أن تعرض صفحة الـ SLO الحالة وميزانية الأخطاء المتبقية والاتجاه.
حدود يجب معرفتها في Managed
- لا DQL: يجب أولًا تحويل أي SLI يتطلب الربط بين السجلات والتتبعات إلى مقياس (مقياس محسوب أو استيعاب).
- الاحتفاظ بالبيانات: تنخفض دقة المقاييس مع قِدم البيانات بحسب سياسة العنقود؛ تبقى نافذة 30 يومًا ممكنة، لكن الدقة تتوقف على إعدادك.
- الحمل: يُقيَّم كل SLO بانتظام. عشرات أهداف SLO بتعابير ثقيلة تثقل العنقود؛ فضّل التعابير البسيطة.
- ميزات SaaS غير المتاحة: أهداف SLO على Grail وSite Reliability Guardian بصيغته تطبيقًا في المنصة وWorkflows غير متاحة في Managed. تحقق من مصفوفة التوافر في الوثائق.
الفروق مع Dynatrace SaaS
في SaaS تبقى أهداف SLO الكلاسيكية متاحة في البيئات المعنية، لكن الأهداف الجديدة تعتمد على DQL وGrail، مما يتيح مؤشرات SLI على أي بيانات، ومنها OpenTelemetry. وإن كنت تخطط للترحيل (migration)، فأبقِ مؤشراتك بسيطة وموثقة: سيسهل نقلها. ولجانب SaaS راجع SLO مع OpenTelemetry وDQL.
أفضل الممارسات
- SLO واحد لكل مسار مستخدم حرج، لا واحد لكل خدمة مصغّرة.
- عتبة تحذير فوق الهدف للتفاعل قبل نفاد الميزانية.
- ملفات JSON أو Terraform خاضعة لإدارة الإصدارات وتُراجع كالشيفرة: عمل يدوي مكرر أقل (toil) وأخطاء يدوية أقل.
- اسم مقياس ثابت: تغييره يكسر التنبيهات ولوحات المعلومات المعتمدة عليه.
- مراجعة شهرية لميزانية الأخطاء مع فريق المنتج، بأسلوب بلا لوم.
الأسئلة الشائعة
هل يمكن استخدام مقاييس OpenTelemetry لـ SLO في Managed؟
نعم، إن كانت مستوعَبة كمقاييس في البيئة وقابلة للاستعلام بمحدد مقياس. تحقق من الاستعلام أولًا عبر API المقاييس.
أي نافذة تقييم تختار؟
سبعة أيام تناسب إدارة الفريق. وثلاثون يومًا أنسب للالتزام التعاقدي، بشرط أن تسمح مدة الاحتفاظ في عنقودك.
هل يلزم رمز لكل فريق؟
يُنصح بذلك: رمز لكل خط نشر (pipeline) بنطاقات SLO اللازمة فقط يحدّ أثر أي تسرّب ويسهّل التدقيق.
الخلاصة
تتطلب أهداف SLO في Managed صرامة أكبر في اختيار SLI، لكنها توفّر أساسًا متينًا: تعبير مقياس مختبَر، وكائنًا خاضعًا لإدارة الإصدارات عبر API، وتنبيهًا على burn rate. ابدأ بخدمة حرجة واحدة، وقِس أسبوعًا، ثم وسّع.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. قد تختلف الشاشات وحقول API بحسب إصدار عنقودك: تحقق منها في الوثائق الرسمية.