تحل Key requests في Dynatrace مشكلة مناوبة كلاسيكية: الطلب الأهم للعمل ليس دائمًا الأثقل في حركة المرور. قد لا يمثل /login أو /cart/checkout إلا جزءًا ضئيلًا من معدل معالجة الخدمة، فيمر تدهوره تحت رادار التنبيه الافتراضي.
وسم الطلب بوصفه key request يمنحه مقاييس مخصصة وسجلًا تاريخيًا طويلًا وتنبيهًا مضمونًا حتى مع الحجم الضعيف، وعند الحاجة عتباته الخاصة. بالنسبة إلى فريق SRE هذه أكثر الطرق مباشرةً لتحويل «الطلب الذي يصنع رقم المبيعات» إلى إشارة مراقَبة، ثم إلى مؤشر مستوى خدمة (SLI).
يصلح هذا الدليل لـ Dynatrace Managed ولبيئات Dynatrace SaaS التي ما زالت تستخدم الخدمات الكلاسيكية (Services Classic). انتبه: تشير الوثائق إلى أن إنشاء key requests غير متاح لبيئات SaaS المنشأة بالإصدار 1.330 أو أحدث؛ سنعود إلى ذلك.
ما الذي تغيّره Key requests في Dynatrace
الـ key request طلب خدمة تعلن أنه مهم، إما لأنه يقيس نجاح العمل (تسجيل الدخول والدفع)، وإما لأنه يحمل وظيفة تقنية يعتمد عليها التطبيق. عمليًا يمنحك وسمه أربعة أشياء:
- تنبيه نشط دائمًا. افتراضيًا، لا يطلق الطلب الذي تقل حصته عن 1% من حمل الخدمة تنبيهًا، إلا إذا أضرّ بزمن استجابة الخدمة كلها أو بمعدل فشلها. أما الـ key request فتحتفظ بعتبات التنبيه القياسية مهما كان حجمها.
- عتبات خاصة. يمكنك تعريف عتبات لزمن الاستجابة ومعدل الفشل على مستوى الطلب؛ وتتقدم عندئذ على عتبات الخدمة.
- مقاييس مخصصة من عائلة
builtin:service.keyRequest.*، قابلة للاستخدام في Data Explorer ولوحات المعلومات وأهداف SLO. - احتفاظ أطول: بيانات تفصيلية على مستوى الشيفرة 10 أيام، وبيانات مجمَّعة على مستوى الشيفرة 35 يومًا، وسجل المقاييس طويل الأمد 5 سنوات.
تظهر الـ key requests في قسم Key requests/endpoints من صفحة كل خدمة، بدل أن تضيع في أسفل Top requests.
حدود يجب معرفتها قبل الوسم
- 500 key request لكل بيئة، على كل الخدمات مجتمعة؛
- 100 key request لكل خدمة؛
- لا تحتوي بلاطات (tiles) لوحة المعلومات إلا البيانات المجمَّعة بعد الوسم: لا تعويض للسجل التاريخي؛
- يعتمد الكشف على اسم الطلب. قاعدة تسمية (request naming rule) تعيد تسمية الطلب تكسر الرابط إن لم تضف الاسم الجديد.
وفيما يتجاوز هذه الحدود، أو لتقسيم أدق، توصي الوثائق بالمقاييس المحسوبة للخدمات (راجع Multidimensional analysis في Managed).
المتطلبات
- خدمة يكتشفها OneAgent، مع حركة مرور على الطلب المراد وسمه.
- للواجهة: صلاحية إعداد على البيئة.
- لواجهة API: رمز وصول بالنطاقين
settings.readوsettings.write. - معرّف كيان الخدمة (بالشكل
SERVICE-…)، يُحصل عليه عبر APIGET /api/v2/entities: الطريقة موصوفة في العثور على معرّف كيان Dynatrace.
عمليًا: وسم key request
الخطوة 1: ابحث عن الطلب في الواجهة
- افتح Services (في Managed) أو Services Classic (في SaaS).
- اختر الخدمة من القائمة.
- في صفحة الخدمة، انقر أحد أزرار View (View requests أو View dynamic requests أو View resource requests).
- انزل إلى Top requests واختر الطلب.
الخطوة 2: اوسمه
في صفحة الطلب، افتح القائمة More (…) ثم اختر Mark as key request. يثبّت الخيار Pin to dashboard في القائمة نفسها tile مخصصة للطلب على لوحة معلومات كلاسيكية.

متى وُسم الطلب يدويًا، تُحفظ منحنيات اتجاهه دون حد زمني.
الخطوة 3: احمِ الوسم من إعادة التسمية
إن طبّقت request naming rule لاحقًا، فأضف الاسم الجديد إلى القائمة: Services، اختر الخدمة، More (…) > Settings، تبويب Key requests، ثم Add item. وبدون ذلك لا يُعرَف الطلب المعاد تسميته كـ key request وتختفي تنبيهاته المخصصة بصمت.
الخطوة 4: الأتمتة عبر Settings API
لإدارة القائمة بالإصدارات (وإعادة إنشائها بالمثل في عدة بيئات)، استخدم Settings API. اسم المخطط builtin:settings.subscriptions.service ونطاقه (scope) خدمة دائمًا، تُحدَّد بمعرّف كيانها.

# Managed : https://{votre-domaine}/e/{id-environnement}
# SaaS : https://{id-environnement}.live.dynatrace.com
curl -X POST "$DT_URL/api/v2/settings/objects" \
-H "Authorization: Api-Token $DT_TOKEN" \
-H "Content-Type: application/json" \
-d '[{"schemaId":"builtin:settings.subscriptions.service",
"scope":"SERVICE-123456789",
"value":{"keyRequestNames":["/cart/checkout"]}}]'
نقطة حرجة: توضح الوثائق أن هذا الإنشاء يستبدل الإعداد القائم للخدمة. لتعديل قائمة موجودة، اقرأ الكائن أولًا، واحصل على objectId وupdateToken، ثم أرسل القائمة الكاملة بالطلب PUT:
curl -s "$DT_URL/api/v2/settings/objects?schemaIds=builtin:settings.subscriptions.service&scopes=SERVICE-123456789" \
-H "Authorization: Api-Token $DT_TOKEN"
curl -X PUT "$DT_URL/api/v2/settings/objects/{objectId}" \
-H "Authorization: Api-Token $DT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"updateToken":"{updateToken}",
"value":{"keyRequestNames":["/cart/checkout","/cart"]}}'
استخدام key request يوميًا
عتبات تنبيه خاصة بالطلب
يقبل المخطط builtin:anomaly-detection.services ثلاثة نطاقات: SERVICE_METHOD (الطلب) وSERVICE وHOST_GROUP. يحمل الكائن الموضوع على مستوى الطلب إعداداته الخاصة responseTime وfailureRate، بالوضع auto أو fixed. هذا مفيد لعملية دفع خاضعة لالتزام تعاقدي صارم، بينما يتحمل بقية الخدمة زمن استجابة أعلى.
مقاييس للوحات المعلومات وأهداف SLO
بعض مفاتيح العائلة builtin:service.keyRequest كما ترد في مرجع المقاييس المدمجة:
| المفتاح | القياس | الوحدة |
|---|---|---|
builtin:service.keyRequest.response.time |
زمن استجابة الـ key request | Microsecond |
builtin:service.keyRequest.count.total |
عدد الطلبات | Count |
builtin:service.keyRequest.errors.server.rate |
معدل الفشل من جهة الخادم | Percent (%) |
builtin:service.keyRequest.errors.server.successCount |
الاستدعاءات بلا خطأ من جهة الخادم | Count |
في Data Explorer يعطي builtin:service.keyRequest.response.time:percentile(90) قيمة p90 لكل طلب، وهي أبلغ من المتوسط. وبالنسبة إلى SLI التوافر لمسار دفع، فالنسبة بين errors.server.successCount وcount.server هي المرشح الطبيعي؛ وإعداد SLO موصوف في إنشاء SLO في Managed.
Dynatrace SaaS: ماذا تفعل في بيئة حديثة؟
الصفحة الرسمية صريحة: إنشاء key requests غير متاح للبيئات المنشأة بالإصدار 1.330 أو أحدث. وهي توصي بتفعيل الميزة Enhanced endpoints for SDv1 التي تعرض كل الـ endpoints في تطبيق Services، لا الـ key requests وحدها. وفي بيئة SaaS أقدم يبقى الإجراء أعلاه صالحًا عبر Services Classic. وفي Managed ينطبق كما هو.
أفضل الممارسات
- اوسم الطلبات بحسب مسارات العمل (تسجيل الدخول والبحث والدفع)، لا بدافع العادة: الـ 100 لكل خدمة سقف لا هدف.
- فضّل الطلبات قليلة الحجم عظيمة الأهمية: فهي ما يتجاهله التنبيه الافتراضي.
- أدِر القائمة عبر API وأصدِرها (versioning)؛ فالطلب
POSTيستبدل والطلبPUTيعدّل. - بعد كل request naming rule جديدة، تحقق من تبويب Key requests في الخدمة.
- اربط كل key request بـ SLO أو بعتبة صريحة، وإلا لم تفدك إلا في تزيين صفحة الخدمة.
كيف تتحقق من أن كل شيء يعمل
- يظهر الطلب في Key requests/endpoints في صفحة الخدمة.
- عبر API، تعيد القراءة
GET /api/v2/settings/objects?schemaIds=builtin:settings.subscriptions.service&scopes=SERVICE-…مصفوفتكkeyRequestNames. - في Data Explorer، يعرض
builtin:service.keyRequest.count.totalنقاطًا ابتداءً من وقت الوسم.
إن لم تصل النقاط، فقارن الاسم الدقيق للطلب (حالة الأحرف والبادئة) بالاسم الوارد في القائمة: إنها في الغالب إعادة تسمية. ولتقليل الضجيج الذي ترافقه أحيانًا عتبات ضيقة جدًا، راجع أيضًا تقليل ضجيج تنبيهات Davis، ولمقاييس الخدمة العامة مقاييس الخدمة المدمجة. المرجع الرسمي: Monitor key requests.
الأسئلة الشائعة
هل تستعيد key request سجل ما قبل الوسم؟
لا: توضح الوثائق أن tiles لوحة المعلومات لا تحتوي إلا البيانات المجمَّعة بعد الوسم. فاوسم طلباتك الحرجة قبل أن تحتاج إليها، لا أثناء الحادثة.
ما الفرق عن المقياس المحسوب للخدمة؟
تتابع الـ key request طلبًا مسمًّى، مع تنبيه مدمج وعتبات خاصة. أما المقياس المحسوب فيرشّح ويقسّم بحرية (بحسب رمز HTTP أو request attribute)، ويُحتسب ضمن حدود أخرى، ويُستخدم كمقياس مدمج في التنبيه.
لماذا اختفت key request بعد الإطلاق في الإنتاج؟
الكشف مبني على الاسم. إن تغيّر المسار أو قاعدة تسمية، فأضف الاسم الجديد في تبويب Key requests من إعدادات الخدمة أو في keyRequestNames.
الخلاصة
الـ key requests إعداد متواضع عظيم العائد: بضعة طلبات عمل موسومة، وعتبات مناسبة، وSLI مشتق، تكفي كي لا تفوتك أبدًا عطلة الدفع الغارقة في حركة الصفحات الثابتة. أعدّ القائمة مع فرق المنتج، وأدِرها عبر API، وتحقق منها عند كل تغيير في التسمية.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. قد تختلف أسماء الشاشات والحدود والتوفر بحسب الإصدار والمنصة (SaaS أو Managed): تحقق منها في الوثائق الرسمية.