المسار: مقاييس Dynatrace SaaS · الوحدة 3/7 — مقاييس الخدمة في Grail: الطلبات والمراسلة وservice mesh · الشكل: بطاقات مرجعية · المنصة: Dynatrace SaaS (Grail وDQL)
في هذه الوحدة: 12 مدخلًا dt.service.* (الطلبات والمراسلة وservice mesh والمقاييس المحسوبة)، وجدول موجز وبطاقة لكل مقياس.
تمثّل مقاييس الخدمة في Grail مفاتيح dt.service.* التي تصف ما تعيشه خدماتك. وهذه الوحدة الثالثة من مسار مقاييس Dynatrace SaaS ترتبها في بطاقات: طلبات HTTP وRPC لكل endpoint، والمراسلة (Kafka وRabbitMQ وSQS…) وservice mesh. وتعطي كل بطاقة الوحدة والأبعاد وحالة استخدام واستعلام DQL.
تقيس مقاييس الخدمة ما يعيشه المستدعون: كم طلبًا يصل، وكم منها يفشل، وكم يستغرق. وهي الإشارات الذهبية التي تُبنى عليها أهداف SLO، وبالتالي التنبيهات التي توقظ أحدًا عن حق. ينتجها Dynatrace تلقائيًا لكل endpoint مكتشَف، دون أي إعداد.
المحتوى خاص بـDynatrace SaaS. أما Dynatrace Managed فراجع وحدة مقاييس الخدمة builtin. مفاتيح المضيف في الوحدة 2؛ وتفيد هذه الوحدة في إيجاد مفتاح الخدمة المناسب وخصوصيته بسرعة.
مقاييس الخدمة في Grail: الجدول الموجز
اثنا عشر مدخلًا فقط: ففي Grail تحل الأبعاد محل تكاثر المفاتيح. حيث كان في Classic مفتاح لأخطاء 4xx ومفتاح لـ5xx ومفتاح للطلبات الرئيسية، يحتفظ Grail بـdt.service.request.count ويترك لك الترشيح. الوحدات والأبعاد مأخوذة من صفحة المرجع؛ وعبارة «انظر الواصف» تشير إلى ما لا تحدده.
| المفتاح | الوحدة | الأبعاد الرئيسية | ما يقيسه |
|---|---|---|---|
dt.service.request.count |
عدد | dt.entity.service، endpoint.name، http.request.method، http.response.status_code، failed |
الطلبات المستلمة لكل endpoint |
dt.service.request.failure_count |
عدد | dt.entity.service، endpoint.name، http.request.method، http.response.status_code |
الطلبات الفاشلة لكل endpoint |
dt.service.request.response_time |
µs | dt.entity.service، endpoint.name، http.request.method، http.response.status_code، failed |
زمن استجابة الطلبات لكل endpoint |
dt.service.messaging.publish.count |
عدد | dt.entity.service، messaging.destination.name، messaging.system |
الرسائل المرسلة إلى طوابير أو topics |
dt.service.messaging.receive.count |
عدد | dt.entity.service، messaging.destination.name، messaging.system |
الرسائل المستلمة من طوابير أو topics |
dt.service.messaging.process.count |
عدد | dt.entity.service، messaging.destination.name، messaging.system |
الرسائل المعالَجة بنجاح |
dt.service.messaging.process.duration |
انظر الواصف | dt.entity.service، messaging.destination.name، messaging.system |
الزمن المقضي في معالجة الرسائل |
dt.service.messaging.process.failure_count |
عدد | dt.entity.service، messaging.destination.name، messaging.system |
الرسائل التي فشلت معالجتها |
dt.service.request.service_mesh.count |
عدد | انظر الواصف | الطلبات التي يراها service mesh |
dt.service.request.service_mesh.failure_count |
عدد | انظر الواصف | الطلبات الفاشلة التي يراها service mesh |
dt.service.request.service_mesh.response_time |
انظر الواصف | انظر الواصف | زمن الاستجابة كما يراه service mesh |
service.<nom_de_la_métrique> |
حسب التعريف | بعد Classic + المتغيرات النائبة (placeholders) المفصولة | مقياس خدمة محسوب، منقول من calc:service:… |

البطاقات: الطلبات والمراسلة وservice mesh
الترتيب نفسه لكل بطاقة: الفائدة، حالة الاستخدام، الفخ، استعلام DQL. أبعاد البنية التحتية (k8s.namespace.name وk8s.cluster.name وaws.region وdt.host_group.id…) وprimary_tags.* متاحة أيضًا على مقاييس الطلبات والمراسلة، دون ربط طوبولوجي.
dt.service.request.count
الفائدة: حركة المرور، الإشارة الذهبية الأولى، ومقام كل معدل فشل.
حالة الاستخدام: مفتاح واحد يحل محل نحو ثلاثين مفتاح Classic (النجاح و4xx و5xx والطلبات الرئيسية): يُرشَّح حسب http.response.status_code أو failed بدل تغيير المقياس. مثال: حصة استجابات 5xx لخدمة.
الفخ: تُجمع المقاييس كل دقيقة: أضف rate: 1s إن أردت طلبات في الثانية.
timeseries {all = sum(dt.service.request.count),
s5xx = sum(dt.service.request.count, filter: {http.response.status_code >= 500}, default: 0)},
by: {dt.entity.service}, union: true
| fieldsAdd pct_5xx = s5xx[] / all[] * 100
dt.service.request.failure_count
الفائدة: بسط معدل الخطأ، وأساس مؤشر SLI للتوافر.
حالة الاستخدام: ترتيب الـendpoints حسب عدد الإخفاقات لمعرفة أيها يستهلك ميزانية الأخطاء.
الفخ: توضح الوثائق أن المقياس يحتوي نقاطًا بقيمة صفر للطلبات الناجحة، للتمييز بين «إخفاقات» و«لا إخفاقات» و«لا طلبات». ولا يعيدها استعلام timeseries العادي: فكّر في default: 0 في النسب.
timeseries failed = sum(dt.service.request.failure_count), by: {dt.entity.service, endpoint.name}
| sort arraySum(failed) desc
| limit 10
dt.service.request.response_time
الفائدة: زمن الاستجابة، مقيسًا من جهة الخدمة.
حالة الاستخدام: النسبة المئوية 99 لكل خدمة، كما في مثال وثائق DQL، لتتبع ذيل التوزيع.
الفخ: الوحدة هي الميكروثانية: عتبة 300 ميلي ثانية تُكتب 300000.
timeseries p99 = percentile(dt.service.request.response_time, 99),
by: {dt.entity.service}
| limit 5
dt.service.messaging.publish.count
الفائدة: المعدل الذي تنتجه خدمة، من جهة المرسِل.
حالة الاستخدام: هبوط النشر إلى الصفر على topic لأحداث الأعمال يدل على منتِج متوقف قبل أي شكوى.
الفخ: هذه المقاييس موجودة على Grail فقط: لا مقابل في Classic لترحيله.
timeseries pub = sum(dt.service.messaging.publish.count),
by: {messaging.destination.name, messaging.system}
dt.service.messaging.receive.count
الفائدة: نظير النشر من جهة المستهلك.
حالة الاستخدام: مقارنة النشر بالاستلام على الوجهة نفسها لمعرفة هل يواكب المستهلكون.
timeseries {pub = sum(dt.service.messaging.publish.count),
rec = sum(dt.service.messaging.receive.count)},
by: {messaging.destination.name}, union: true
dt.service.messaging.process.count
الفائدة: الحركة المفيدة لمستهلك.
حالة الاستخدام: بمقارنته بـreceive.count يتبين هل الرسائل المستلمة تُعالَج فعلًا.
timeseries done = sum(dt.service.messaging.process.count, rate: 1m),
by: {dt.entity.service, messaging.destination.name}
dt.service.messaging.process.duration
الفائدة: زمن استجابة المستهلك، غير المرئي في مقاييس طلبات HTTP.
حالة الاستخدام: زمن معالجة يتضاعف يفسّر تأخرًا يتراكم في الطابور.
الفخ: لا تعطي صفحة المرجع الوحدة: اقرأها في متصفح المقاييس قبل تحديد عتبة.
timeseries d = avg(dt.service.messaging.process.duration),
by: {dt.entity.service, messaging.destination.name}
dt.service.messaging.process.failure_count
الفائدة: معدل خطأ المستهلك.
حالة الاستخدام: إخفاقات مركزة على وجهة واحدة تشير إلى صيغة رسالة أو تبعية لاحقة.
timeseries {ok = sum(dt.service.messaging.process.count),
ko = sum(dt.service.messaging.process.failure_count, default: 0)},
by: {messaging.destination.name}, union: true
| fieldsAdd fail_pct = ko[] / (ok[] + ko[]) * 100
dt.service.request.service_mesh.count
الفائدة: الحركة كما يقيسها وكيل (proxy) الـmesh لا الشيفرة المجهزة.
حالة الاستخدام: فرق مستمر مع dt.service.request.count يكشف طلبات رفضها الوكيل قبل بلوغ التطبيق.
timeseries mesh = sum(dt.service.request.service_mesh.count, rate: 1s)
dt.service.request.service_mesh.failure_count
الفائدة: تلتقط إخفاقات الشبكة والوكيل (المهل والاتصالات المرفوضة) التي لا يراها التطبيق.
حالة الاستخدام: معدل فشل الـmesh يُتابَع بالتوازي مع معدل الخدمة عند ترقية إصدار الـmesh.
timeseries {all = sum(dt.service.request.service_mesh.count),
ko = sum(dt.service.request.service_mesh.failure_count, default: 0)}, union: true
| fieldsAdd fail_pct = ko[] / all[] * 100
dt.service.request.service_mesh.response_time
الفائدة: تشمل كلفة الوكيل: الفرق مع زمن الخدمة يقيس الحِمل الإضافي للـmesh.
حالة الاستخدام: النسبة المئوية 90 التي تُراقَب بعد تفعيل التشفير المتبادل (mTLS).
الفخ: قارن بالوحدة نفسها: تحقق منها في الواصف قبل طرحها من زمن الخدمة.
timeseries p90 = percentile(dt.service.request.service_mesh.response_time, 90)
service.<nom_de_la_métrique>
الفائدة: تحفظ حاجة أعمال محددة (مبلغ أو عميل أو نوع طلب) لا تغطيها المقاييس المدمجة.
حالة الاستخدام: المقياس القائم calc:service:orders يصبح service.orders بعد تفعيله على Grail، وتتحول متغيراته النائبة إلى أبعاد منفصلة.
الفخ: تعلن الوثائق إيقاف دعم مقاييس الخدمة المحسوبة (deprecation) دون تاريخ. ولحاجة جديدة ابدأ من مقاييس endpoint أو من استخراج مقياس من الـspans في OpenPipeline.
timeseries sum(service.orders), by: {dt.entity.service}
كيف تتحقق من أن كل شيء يعمل
- في Notebook نفّذ
timeseries sum(dt.service.request.count), by: {dt.entity.service}: يجب أن تظهر كل خدمة مجهزة. - أضف
endpoint.nameإلىby: إن كان العمود فارغًا لخدمة SDv1 ففعّل الـendpoints المحسّنة (Enhanced endpoints) كما تشير الوثائق. - بالنسبة إلى المراسلة رشّح على
messaging.system؛ وغياب أي سلسلة تمامًا يعني غالبًا أن مكتبة العميل غير مدعومة أو غير مجهزة. - قارن معدل فشل محسوبًا هنا بشاشة الخدمة في تطبيق Services: يجب أن يرويا القصة نفسها.
أفضل الممارسات
- رشّح حسب البعد بدل البحث عن مفتاح مخصص: حالة HTTP والطريقة والـendpoint.
- استخدم
default: 0وunion: trueفي النسب كي لا تخسر الخدمات بلا إخفاقات. - فضّل النسب المئوية على المتوسط لزمن الاستجابة، وحوّل العتبات إلى ميكروثانية.
للمزيد: يحوّل تنبيهات burn rate على SLO هذه السلاسل إلى تنبيهات على ميزانية الأخطاء، ويعالج ترحيل SLO إلى Grail الانتقال من مفاتيح Classic، ويشرح نشر سياق Kafka لماذا تعتمد مقاييس المراسلة على سياق منقول جيدًا. المصادر: Built-in metrics on Grail وأوامر مقاييس DQL.
→ الوحدة 2: مقاييس المضيف في Grail · فهرس المسار · الوحدة 4: مقاييس RUM في Grail ←
الأسئلة الشائعة
أين ذهبت مقاييس الطلبات الرئيسية؟
لا يوجد مفتاح مخصص بعد الآن: المفاتيح القديمة builtin:service.keyRequest.* تقابل المقاييس dt.service.request.*، مرشَّحة حسب endpoint.name.
هل يعمل الاستعلام نفسه لـSDv1 وSDv2؟
نعم، بحسب الوثائق تُنتَج مقاييس endpoint لخدمات SDv1 (مع Enhanced endpoints) وSDv2، ويغطي استعلام واحد الاثنين.
هل ما زال يجب إنشاء مقاييس خدمة محسوبة؟
ليس لحاجة جديدة: فقد أُعلن إيقاف دعمها. تغطي المقاييس المدمجة وأبعادها معظم أنواع التقسيم؛ وللباقي استخرج مقياسًا من الـspans عبر OpenPipeline.
بهذه المداخل الاثني عشر تغطي زمن الاستجابة والحركة والأخطاء في خدماتك، المتزامنة وغير المتزامنة. تنتقل الوحدة التالية إلى جهة المستخدم النهائي: الواجهات الأمامية RUM والمراقبة الاصطناعية.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. هذه الوحدة اختيار معلّق عليه وليست القائمة الرسمية: استُخرجت المفاتيح والوحدات والأبعاد من الوثائق العامة لـDynatrace SaaS وقد تتغير؛ تحقق منها في متصفح المقاييس في بيئتك.