Key requests في Dynatrace: وسم طلب مفتاحي واستخدامه للتنبيه

Key requests في Dynatrace: وسم طلب مفتاحي في الواجهة أو عبر Settings API، وعتبات تنبيه ومقاييس مخصصة له، في SaaS وManaged.
Key requests Dynatrace : marquer une requête clé et l'utiliser pour alerter

تحل 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-…)، يُحصل عليه عبر API GET /api/v2/entities: الطريقة موصوفة في العثور على معرّف كيان Dynatrace.

عمليًا: وسم key request

الخطوة 1: ابحث عن الطلب في الواجهة

  1. افتح Services (في Managed) أو Services Classic (في SaaS).
  2. اختر الخدمة من القائمة.
  3. في صفحة الخدمة، انقر أحد أزرار View (View requests أو View dynamic requests أو View resource requests).
  4. انزل إلى Top requests واختر الطلب.

الخطوة 2: اوسمه

في صفحة الطلب، افتح القائمة More (…) ثم اختر Mark as key request. يثبّت الخيار Pin to dashboard في القائمة نفسها tile مخصصة للطلب على لوحة معلومات كلاسيكية.

صفحة تفاصيل طلب خدمة في Dynatrace مع القائمة More مفتوحة: الأزرار Mute وPin to dashboard وMark as key request
Source : docs.dynatrace.com

متى وُسم الطلب يدويًا، تُحفظ منحنيات اتجاهه دون حد زمني.

الخطوة 3: احمِ الوسم من إعادة التسمية

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

الخطوة 4: الأتمتة عبر Settings API

لإدارة القائمة بالإصدارات (وإعادة إنشائها بالمثل في عدة بيئات)، استخدم Settings API. اسم المخطط builtin:settings.subscriptions.service ونطاقه (scope) خدمة دائمًا، تُحدَّد بمعرّف كيانها.

متن JSON لكائن Settings من المخطط builtin:settings.subscriptions.service مع النطاق SERVICE-123456789 والمصفوفة keyRequestNames التي تحتوي /cart/checkout
# 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): تحقق منها في الوثائق الرسمية.

Total
0
Shares
Leave a Reply

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

Previous Post
Host groups Dynatrace : à quoi ils servent et comment les définir

host groups Dynatrace: فيم تفيد وكيف تُعرَّف

Next Post
ID entité Dynatrace : le trouver dans un Notebook, par l'API entitySelector ou en DQL

معرف كيان Dynatrace: كيف تجده في Notebook أو عبر API وentitySelector أو بـ DQL

Related Posts