الوحدة 5 من مسار مقاييس Dynatrace Managed: مقاييس العمليات builtin، ومقاييس بيئات التشغيل (JVM و.NET وNode.js وGo) والحاويات وKubernetes، في 24 بطاقة بمفتاح دقيق ووحدة وحالة استخدام وselector جاهز للصق.
المسار: تدريب مقاييس Dynatrace Managed · الوحدة 5/7 · النوع: مرجع · المنصة: Dynatrace Managed (المقاييس الكلاسيكية)
في هذه الوحدة:
- جدول موجز للمفاتيح الـ24، لتبقيه في متناولك
- بطاقة لكل مقياس: ما يقيسه ومتى يُستخدم والفخ الذي ينبغي تفاديه
- metric selector لكل بطاقة، يمكن تجربته في Data Explorer
حين يسوء حال مضيف، يكون السؤال التالي دائمًا واحدًا: أي عملية، وأي JVM، وأي حاوية؟ تجيب مقاييس هذه الوحدة عن هذا السؤال. فهي تقع تحت الخدمة وفوق المضيف، وهي التي تقصّر التشخيص، ومن ثم زمن الاستعادة (MTTR)، حين يصل تنبيه بنية تحتية في الليل.
كل ما يلي صالح لـDynatrace Managed: مفاتيح builtin: وmetric selector وMetrics API v2 وData Explorer. لا Grail ولا DQL هنا. وفي Dynatrace SaaS تحمل القياسات نفسها مفاتيح dt.process.* أو dt.runtime.* أو dt.kubernetes.*؛ وهي مشروحة في مسار مقاييس SaaS.
تصل هذه الوحدة بين الوحدة 2 عن المضيفين والوحدة 3 عن الخدمات. وهنا نذهب مباشرة إلى البطاقة.
مقاييس العمليات builtin في جدول
كل المفاتيح والوحدات والتجميعات أدناه مأخوذة من القائمة الرسمية للمقاييس المدمجة في Dynatrace Managed. يعيد عمود «النطاق» قسم الوثائق؛ وتُقرأ الأبعاد الدقيقة في وصف كل مقياس.
| المفتاح | الوحدة | التجميعات | النطاق | ما يقيسه |
|---|---|---|---|---|
builtin:tech.generic.cpu.usage |
Percent (%) | avg, max, min | عملية | معالج العملية، كنسبة من معالج المضيف |
builtin:tech.generic.mem.workingSetSize |
Byte | avg, max, min | عملية | الذاكرة التي تستخدمها العملية |
builtin:tech.generic.mem.exhaustedMem |
Count | value | عملية | أحداث «Memory resource exhausted» |
builtin:tech.generic.handles.fileDescriptorsPercentUsed |
Percent (%) | avg, max, min | عملية (Linux) | نسبة حد واصفات الملفات |
builtin:tech.generic.network.packets.retransmission |
Percent (%) | avg, max, min | عملية (شبكة) | نسبة الحزم المعاد إرسالها |
builtin:tech.generic.network.sessions.reset |
Per second | avg, max, min | عملية (شبكة) | جلسات TCP الواردة المعاد ضبطها |
builtin:tech.generic.processCount |
Count | avg, max, min | عملية | عدد العمليات العاملة (workers) |
builtin:pgi.availability.state |
Count | value | نسخة العملية | حالة توافر العملية، كل دقيقة |
builtin:tech.jvm.memory.pool.used |
Byte | avg, max, min | JVM | الذاكرة المستخدمة لكل مجمّع في الكومة |
builtin:tech.jvm.memory.gc.suspensionTime |
Percent (%) | avg, max, min | JVM | حصة الزمن المنفقة في توقفات GC |
builtin:tech.jvm.memory.gc.collectionTime |
Millisecond | value | JVM | زمن الجمع التراكمي، كل المجمّعات |
builtin:tech.jvm.threads.count |
Count | avg, max, min | JVM | الخيوط الحية في JVM |
builtin:tech.dotnet.gc.timePercentage |
Percent (%) | avg, max, min | .NET | نسبة الزمن المنفق في GC الخاص بـ.NET |
builtin:tech.dotnet.threadpool.queuedWorkItems |
Count | avg, max, min | .NET | العناصر المنتظرة في مجمّع الخيوط |
builtin:tech.nodejs.uvLoop.loopLatency |
Nanosecond | avg, max, min | Node.js | زمن استجابة حلقة الأحداث |
builtin:tech.nodejs.v8heap.used |
Byte | avg, max, min | Node.js | كومة V8 التي تشغلها البيانات |
builtin:tech.go.memory.heap.live |
Byte | avg, max, min | Go | كومة Go التي يعدّها GC حية |
builtin:containers.cpu.throttledMilliCores |
Millicores | avg, max, min | حاوية | خنق معالج الحاوية |
builtin:containers.memory.limitPercent |
Percent (%) | avg | حاوية | حد الذاكرة، كنسبة من الذاكرة الفعلية |
builtin:containers.memory.outOfMemoryKills |
Count | value | حاوية | إيقافات بسبب تجاوز الذاكرة (OOM kills) |
builtin:kubernetes.container.restarts |
Count | value | Kubernetes (حاوية) | إعادة تشغيل الحاويات |
builtin:kubernetes.node.requests_cpu |
Millicores | avg, max, min | Kubernetes (عقدة) | requests المعالج للـpods، لكل عقدة |
builtin:kubernetes.workload.pods_desired |
Count | avg, max, min | Kubernetes (حمل عمل) | الـpods المطلوبة لكل حمل عمل |
builtin:kubernetes.persistentvolumeclaim.used |
Byte | avg, max, min | Kubernetes (PVC) | البايتات المستخدمة في الحجم |

كيف تقرأ بطاقة
تتبع كل بطاقة الترتيب نفسه: ما يقيسه المقياس، وحالة استخدام ملموسة، وفخ، ثم selector. وتقسّم الـselectors بحسب dt.entity.process_group_instance حين يخص المقياس عملية، وتستخدم التحويلات الموثقة فقط (splitBy وsort وlimit والتجميعات). والعتبات المذكورة مراجع تُعايَر على تاريخك، لا قيم رسمية.
العمليات: المعالج والذاكرة والشبكة والتوافر
builtin:tech.generic.cpu.usage
مجموع زمن المعالج لكل العمليات العاملة (workers) في العملية، منسوبًا إلى معالج المضيف المتاح: 100% تعني أن العملية تستهلك المضيف كله. وهو أول مقياس تفتحه حين يرتفع builtin:host.cpu.usage: فهو يخبرك أي عملية المسؤولة. حالة الاستخدام: ترتيب العمليات العشر الأكثر شرهًا على مضيف مشبع. الفخ: على مضيف من 16 نواة تتوقف عملية أحادية الخيط قرابة 6%؛ ورقم منخفض لا يثبت غياب الاختناق.
builtin:tech.generic.cpu.usage:splitBy("dt.entity.process_group_instance"):sort(value(avg,descending)):limit(10)
builtin:tech.generic.mem.workingSetSize
مجموع الذاكرة التي تستخدمها كل عملية عاملة، بما فيها الذاكرة المشتركة. وتقدمه الوثائق أداةً لرصد كبار المستهلكين وحالات التسرب. حالة الاستخدام: منحنى بشكل أسنان المنشار لا ينزل أبدًا إلى المستوى نفسه بعد كل إعادة تشغيل يدل على تسرب محتمل. الفخ: الذاكرة المشتركة محسوبة، فجمع عدة عمليات على المضيف نفسه يبالغ في الإجمالي.
builtin:tech.generic.mem.workingSetSize:splitBy("dt.entity.process_group_instance"):sort(value(max,descending)):limit(10)
builtin:tech.generic.mem.exhaustedMem
عدد أحداث «Memory resource exhausted» التي تصدرها العمليات العاملة في دقيقة؛ وتولّدها JVM حين تنقصها الذاكرة. حالة الاستخدام: كل قيمة غير صفرية على JVM إنتاجية تستحق التحليل، وغالبًا قبل ظهور OutOfMemoryError في السجلات. الفخ: غياب النقطة لا يعني صفرًا؛ تحقق من أن العملية JVM مراقَبة بعمق.
builtin:tech.generic.mem.exhaustedMem:splitBy("dt.entity.process_group_instance")
builtin:tech.generic.handles.fileDescriptorsPercentUsed
أعلى نسبة مستخدمة من حد واصفات الملفات بين العمليات العاملة، على Linux. حالة الاستخدام: خادم يفتح اتصالات دون إغلاقها يقترب ببطء من 100% ثم يفشل برسالة «Too many open files». وتنبيه مبكر قبل بلوغ الحد يمنح وقتًا للتصرف. الفخ: المقياس غير موجود على Windows.
builtin:tech.generic.handles.fileDescriptorsPercentUsed:splitBy("dt.entity.process_group_instance"):max
builtin:tech.generic.network.packets.retransmission
نسبة حزم TCP المعاد إرسالها للعملية، تقيسها تحليلات الشبكة في OneAgent. حالة الاستخدام: خدمة بطيئة دون سبب ظاهر في التطبيق؛ وارتفاع إعادة الإرسال يشير إلى الشبكة (فقد أو تشبع أو MTU) لا إلى الشيفرة. الفخ: مع عدد قليل من الحزم تعطي بضع إعادات إرسال نسبة مذهلة؛ فانظر إليها مع الحركة.
builtin:tech.generic.network.packets.retransmission:splitBy("dt.entity.process_group_instance"):max
builtin:tech.generic.network.sessions.reset
عدد جلسات TCP الواردة التي أُنهيت بخطأ إعادة ضبط (RST) في الثانية. حالة الاستخدام: بعد تغيير موزّع أحمال أو جدار ناري، يكشف ارتفاع مفاجئ اتصالات قُطعت في منتصف الطريق. الفخ: بعض العملاء يغلقون عمدًا بـRST؛ فقارن بفترة مرجعية لا بالصفر.
builtin:tech.generic.network.sessions.reset:splitBy("dt.entity.process_group_instance"):avg
builtin:tech.generic.processCount
عدد العمليات العاملة في عملية (Apache أو PHP-FPM أو IIS…). وتذكّر الوثائق بأن عددًا ضئيلًا جدًا يضر بالأداء وأن عددًا مرتفعًا جدًا يهدر الموارد. حالة الاستخدام: التحقق من أن المجمّع يتوسع فعلًا تحت الحمل عند الذروة. الفخ: لا تخلطه مع builtin:tech.generic.count الذي يعد عمليات مجموعة.
builtin:tech.generic.processCount:splitBy("dt.entity.process_group_instance"):max
builtin:pgi.availability.state
حالة توافر نسخة العملية، تُنشر كل دقيقة. حالة الاستخدام: بناء هدف SLO لتوافر مكوّن دون الاعتماد على الحركة، أو رصد إعادات التشغيل الليلية. الفخ: إنها حالة لا نسبة مئوية؛ اقرأ الوصف لتعرف بُعد الحالة قبل التصفية.
builtin:pgi.availability.state:splitBy("dt.entity.process_group_instance")
التقنيات: JVM و.NET وNode.js وGo
builtin:tech.jvm.memory.pool.used
الذاكرة المشغولة حاليًا في كل مجمّع من مجمّعات JVM (Eden وSurvivor وOld Gen بحسب جامع النفايات). حالة الاستخدام: ارتفاع Old Gen من جديد بعد كل جمع رئيسي هو العلامة الكلاسيكية للتسرب. الفخ: يتأرجح Eden طبيعيًا بين الفراغ والامتلاء؛ وجمع كل المجمّعات يخفي المنحنى الوحيد الذي يهم.
builtin:tech.jvm.memory.pool.used:splitBy("dt.entity.process_group_instance"):max
builtin:tech.jvm.memory.gc.suspensionTime
الزمن المنقضي بين بداية توقفات جامع النفايات ونهايتها، مُعبَّرًا عنه بنسبة مئوية. وهو المقياس الذي يربط GC بما يشعر به المستخدم: ففي أثناء التوقف لا يستجيب التطبيق. حالة الاستخدام: ربط ذرى زمن الاستجابة بذرى التوقف. الفخ: يلطّف المتوسط على ساعة التوقفات الطويلة؛ فاستخدم max.
builtin:tech.jvm.memory.gc.suspensionTime:splitBy("dt.entity.process_group_instance"):max
builtin:tech.jvm.memory.gc.collectionTime
الزمن التقريبي المنفق في الجمع، لكل المجمّعات. حالة الاستخدام: مقارنة إصدارين من تطبيق أو ضبطين لجامع النفايات تحت الحمل نفسه. الفخ: تشير وثائق SaaS إلى أن هذا المفتاح يختلف عن مقابله في Grail لعمليات Go؛ وفي Managed التزم بالمفتاح builtin: ووصفه.
builtin:tech.jvm.memory.gc.collectionTime:splitBy("dt.entity.process_group_instance")
builtin:tech.jvm.threads.count
عدد الخيوط الحية، بما فيها خيوط الخدمة (daemon). حالة الاستخدام: نمو متواصل يكشف مجمّعًا بلا حد أو خيوطًا لا تُحرَّر، قبل أن تنقص JVM الذاكرة الأصلية. الفخ: عدد مرتفع ومستقر طبيعي على خادم تطبيقات؛ فالاتجاه هو المهم.
builtin:tech.jvm.threads.count:splitBy("dt.entity.process_group_instance"):max
builtin:tech.dotnet.gc.timePercentage
نسبة الزمن المنفق في جامع نفايات CLR. حالة الاستخدام: تطبيق ASP.NET يبطؤ تحت الحمل بينما يظل معالج المضيف معقولًا؛ ونسبة GC مرتفعة تشير إلى التخصيصات (السلاسل والكائنات الكبيرة) لا إلى قاعدة البيانات. الفخ: اقرأها مع استهلاك كومة الكائنات الكبيرة (LOH) التي تكون غالبًا السبب.
builtin:tech.dotnet.gc.timePercentage:splitBy("dt.entity.process_group_instance"):max
builtin:tech.dotnet.threadpool.queuedWorkItems
عدد عناصر العمل في الطابور داخل مجمّع الخيوط المُدار. حالة الاستخدام: طابور يتضخم بينما تنفجر أزمنة الاستجابة هو توقيع تشبع المجمّع، وسببه غالبًا استدعاءات حاجزة داخل شيفرة غير متزامنة. الفخ: طابور قصير عند الذروة طبيعي؛ فنبّه على طابور يدوم.
builtin:tech.dotnet.threadpool.queuedWorkItems:splitBy("dt.entity.process_group_instance"):max
builtin:tech.nodejs.uvLoop.loopLatency
متوسط الزمن بين لحظة انتظار حدث ولحظة معالجته. ولأن Node.js أحادي الخيط، فإن حلقة محجوبة تؤخر كل الطلبات. حالة الاستخدام: رصد معالجة متزامنة مكلفة (JSON كبير أو تشفير) أدخلها إصدار جديد. الفخ: الوحدة هي النانوثانية؛ حوّلها قبل مقارنتها بأزمنة استجابة بالمللي ثانية.
builtin:tech.nodejs.uvLoop.loopLatency:splitBy("dt.entity.process_group_instance"):max
builtin:tech.nodejs.v8heap.used
حجم كومة V8 التي تشغلها بيانات التطبيق، مقيسًا بلقطة دورية. حالة الاستخدام: ارتفاع متواصل حتى سقف الكومة يسبق أعطال «heap out of memory». الفخ: قارنه بـbuiltin:tech.nodejs.v8heap.total؛ فالهامش بينهما وحده يخبر عن الخطر.
builtin:tech.nodejs.v8heap.used:splitBy("dt.entity.process_group_instance"):max
builtin:tech.go.memory.heap.live
الذاكرة التي يعدّها جامع نفايات Go حية: ما احتفظ به آخر جمع، مضافًا إليه ما خُصص منذئذ. حالة الاستخدام: تتبّع البصمة الحقيقية لخدمة Go بعد ترقية إصدار. الفخ: تظل ذاكرة العملية كما يراها نظام التشغيل أعلى، لأن بيئة التشغيل تحتفظ بصفحات غير نشطة.
builtin:tech.go.memory.heap.live:splitBy("dt.entity.process_group_instance"):max
الحاويات وKubernetes
builtin:containers.cpu.throttledMilliCores
المعالج الذي حُرمت منه الحاوية بسبب حدّها، بالـmillicores. حالة الاستخدام: حاوية بطيئة بينما للمضيف معالج حر؛ وخنق غير صفري يبيّن أن الحد، لا الجهاز، هو الاختناق. الفخ: دون حد معالج مضبوط لا يوجد خنق ليُقاس.
builtin:containers.cpu.throttledMilliCores:sort(value(max,descending)):limit(10)
builtin:containers.memory.limitPercent
حد ذاكرة الحاوية منسوبًا إلى الذاكرة الفعلية للمضيف؛ وهو فارغ إن لم يوضع حد. حالة الاستخدام: جرد الحاويات بلا حد، وهي التي قد تجوّع جاراتها. الفخ: القيمة الغائبة هنا معلومة لا ثغرة في الجمع.
builtin:containers.memory.limitPercent:sort(value(avg,descending))
builtin:containers.memory.outOfMemoryKills
عدد المرات التي أوقفت فيها النواة الحاوية بسبب تجاوز الذاكرة. حالة الاستخدام: تفسير إعادات تشغيل بلا أثر في سجلات التطبيق؛ وكل قيمة غير صفرية تُعامل كحادثة. الفخ: في Kubernetes قارنها بـbuiltin:kubernetes.container.oom_kills الذي يحمل سياق حمل العمل.
builtin:containers.memory.outOfMemoryKills
builtin:kubernetes.container.restarts
دلتا العدّاد restartCount من حالة الحاوية؛ ولا يُكتب إلا عند حدوث إعادة تشغيل واحدة على الأقل. حالة الاستخدام: اكتشاف CrashLoopBackOff قبل أن يشتكي مستخدم. الفخ: غياب البيانات هو الحالة الطبيعية، لا عطل في الجمع.
builtin:kubernetes.container.restarts
builtin:kubernetes.node.requests_cpu
مجموع requests المعالج لحاويات التطبيقات في الـpods، مجمَّعًا لكل عقدة. حالة الاستخدام: بمقارنتها بـbuiltin:kubernetes.node.cpu_allocatable تخبرك بالمساحة المتبقية للمجدوِل، بمعزل عن الاستهلاك الفعلي. الفخ: قد تكون عقدة «ممتلئة» بالـrequests شبه خاملة؛ وهذا شأن تحديد حجم لا شأن حمل.
builtin:kubernetes.node.requests_cpu:sort(value(max,descending))
builtin:kubernetes.workload.pods_desired
عدد الـpods المنتظرة: الحقل replicas في deployment، أو desiredNumberScheduled في daemon set. حالة الاستخدام: بمقارنتها بعدد الـpods العاملة تكشف نشرًا متعثرًا أو مقيِّس تلقائي (autoscaler) بلغ سقفه. الفخ: إنها نية لا حالة؛ فلا تنخفض حين تفشل الـpods.
builtin:kubernetes.workload.pods_desired:max
builtin:kubernetes.persistentvolumeclaim.used
البايتات المستخدمة في حجم persistent volume claim. حالة الاستخدام: بنسبتها إلى builtin:kubernetes.persistentvolumeclaim.capacity تستبق امتلاء حجم قاعدة بيانات أو وسيط رسائل. الفخ: حجم ممتلئ لا يُسقط الـpod دائمًا؛ فقد يتوقف التطبيق عن الكتابة ببساطة.
builtin:kubernetes.persistentvolumeclaim.used:sort(value(max,descending)):limit(10)
كيف تتحقق من أن الأمر يعمل
- افتح Data Explorer وانتقل إلى وضع Code والصق selector من بطاقة: يجب أن يظهر رسم بياني خلال ثوانٍ.
- إن كانت الاستجابة فارغة فاقرأ الوصف:
GET /api/v2/metrics/builtin:tech.jvm.threads.countبرمز مميّز بنطاقmetrics.read. فهو يسرد الوحدة والتجميعات والأبعاد. - بالنسبة إلى مقاييس بيئات التشغيل، تحقق في شاشة العملية من أن المراقبة العميقة نشطة وأن العملية أُعيد تشغيلها بعد تثبيت OneAgent.
- وبالنسبة إلى Kubernetes، تأكد من أن العنقود مراقَب بواسطة مشغّل Dynatrace؛ ودونه تظل مفاتيح
builtin:kubernetes.*فارغة.
curl -s -H "Authorization: Api-Token $DT_TOKEN" \
"https://managed.example.com/e/ENV-ID/api/v2/metrics/query?metricSelector=builtin:tech.jvm.threads.count:max&from=now-2h"
أفضل الممارسات
- ابدأ من العَرَض: معالج مضيف مرتفع ←
builtin:tech.generic.cpu.usage؛ JVM بطيئة ← توقف GC؛ إعادات تشغيل ← OOM kills وrestarts. - نبّه على المدة لا على الذروة: فلـGC وطابور .NET والأقسام ناقصة النسخ ذرى طبيعية.
- احتفظ بالـselectors في مستودع لوحات معلوماتك، كما في مقال بلاطات JSON في لوحات Managed.
الأسئلة الشائعة
لماذا يظل مقياس JVM فارغًا على عملية Java عندي؟
تتطلب مفاتيح builtin:tech.jvm.* مراقبة عميقة للعملية. والعملية التي بدأت قبل OneAgent، أو استثنتها قاعدة، لا تُبلِّغ إلا بالمقاييس العامة builtin:tech.generic.*.
ما الفرق بين builtin:containers.* وbuiltin:kubernetes.*؟
الأولى تأتي من OneAgent على المضيف وتصف الحاوية (المعالج والذاكرة والخنق). والثانية تأتي من مراقبة Kubernetes وتصف كائنات العنقود (العقد وأحمال العمل والحصص والأحجام). ولتشخيص pod نقاطع بين الاثنين، كما في تشخيص CrashLoopBackOff وOOMKilled.
هل تعمل هذه المفاتيح في Dynatrace SaaS؟
في الواجهة الكلاسيكية لـSaaS نعم. أما في Grail فتحمل المقابلات مفاتيح dt.* وتُستعلم بـDQL، مع فروق حسابية أحيانًا تشير إليها وثائق الترحيل.
بهذه البطاقات الـ24 تستطيع النزول من المضيف إلى العملية فبيئة التشغيل فالحاوية دون البحث عن المفتاح. وتغطي الوحدة التالية السحابة والمحاكاة الافتراضية والإضافات.
→ الوحدة 4: التطبيقات والمراقبة الاصطناعية · فهرس المسار · الوحدة 6: السحابة والإضافات ←
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. هذه الوحدة مختارات معلَّق عليها: يبقى المرجع هو الوثائق الرسمية لإصدارك من Dynatrace Managed، حيث ينبغي التحقق من كل مفتاح ووحدة وتجميع.