الوحدة 2 من مسار مقاييس Dynatrace Managed، وعنوانها مضيفو البنية التحتية: 20 مقياسًا من builtin:host.* اختيرت للتشغيل، مع مفتاحها الدقيق ووحدتها وتجميعاتها واستعلام metric selector جاهز للنسخ.
المسار: تدريب مقاييس Dynatrace Managed · الوحدة 2/7 · المجال: المضيفون والبنية التحتية · المنصة: Dynatrace Managed (Metrics API v2 وmetric selector)
مضيف مشبع يُسقط كل ما يحمله: العمليات، ثم الخدمات، ثم تجربة المستخدمين. لذلك فإن مقاييس المضيف هي الطبقة الأولى في كل تشخيص. وتضم قائمة المقاييس المدمجة (builtin) في Dynatrace Managed مئات المقاييس؛ ويكفي نحو عشرين منها لتغطية المعالج والذاكرة والقرص والشبكة والتوافر.
تطبّق هذه الوحدة شبكة القراءة في الوحدة 1 (فهم المقاييس) على المضيفين. وتعطي كل بطاقة المفتاح وما يقيسه واستخدامًا وفخًّا شائعًا؛ أبقها في متناولك أثناء التشخيص.
كل ما يلي صالح لـDynatrace Managed وللمقاييس الكلاسيكية في Dynatrace SaaS. أما في Grail فتحمل المقاييس المقابلة مفاتيح dt.host.* وتُستعلم بـDQL: وهذا موضوع مسار مقاييس SaaS.
مضيفو البنية التحتية: الجدول الموجز
المفاتيح والوحدات والتجميعات مأخوذة من صفحة Built-in metrics في وثائق Managed. لها جميعًا البعد dt.entity.host؛ وتضيف مقاييس القرص dt.entity.disk، وتضيف مقاييس واجهة الشبكة بعد الواجهة.
| المفتاح | الوحدة | التجميعات | ما يقيسه |
|---|---|---|---|
builtin:host.cpu.usage |
% | avg, max, min | المعالج المستخدم |
builtin:host.cpu.user |
% | avg, max, min | المعالج في وضع المستخدم |
builtin:host.cpu.system |
% | avg, max, min | المعالج في وضع النواة |
builtin:host.cpu.iowait |
% | avg, max, min | انتظار عمليات الإدخال والإخراج |
builtin:host.cpu.steal |
% | avg, max, min | المعالج الذي يسلبه المحاكي (hypervisor) |
builtin:host.cpu.load |
Ratio | avg, max, min | حمل النظام خلال دقيقة |
builtin:host.mem.usage |
% | avg, max, min | الذاكرة المستخدمة |
builtin:host.mem.avail.bytes |
Byte | avg, max, min | الذاكرة المتاحة |
builtin:host.mem.swap.used |
Byte | avg, max, min | swap المستخدم |
builtin:host.mem.avail.pfps |
في الثانية | avg, max, min | أخطاء الصفحات |
builtin:host.disk.usedPct |
% | avg, max, min | مساحة القرص المستخدمة |
builtin:host.disk.avail |
Byte | avg, max, min | مساحة القرص المتاحة |
builtin:host.disk.inodesAvail |
% | avg, max, min | الـinodes الحرة |
builtin:host.disk.queueLength |
Count | avg, max, min | طابور القرص |
builtin:host.disk.readTime |
مللي ثانية | avg, count, max, min, sum | زمن الاستجابة عند القراءة |
builtin:host.disk.writeTime |
مللي ثانية | avg, count, max, min, sum | زمن الاستجابة عند الكتابة |
builtin:host.net.nic.trafficIn |
bit/s | avg, max, min | الحركة الواردة |
builtin:host.net.nic.packets.dropped |
في الثانية | value | الحزم المرفوضة |
builtin:host.availability.state |
Count | value | حالة التوافر |
builtin:host.uptime |
ثانية | avg, max, min | الزمن منذ التشغيل |

مقاييس المعالج المدمجة للمضيف
builtin:host.cpu.usage
نسبة زمن المعالج المستخدم في كل الأنوية. وهو مقياس التشبع الأكثر مراقبة. استخدم max بدل المتوسط الافتراضي لترى الذرى: فالمتوسط على الفاصل يخفي بسهولة تشبعًا قصيرًا. وقارنه دائمًا مع cpu.load قبل أن تستنتج.
builtin:host.cpu.usage:splitBy("dt.entity.host"):max:sort(value(max,descending)):limit(10)
builtin:host.cpu.user
حصة المعالج المنفقة في وضع المستخدم، أي في شيفرة التطبيقات. إن ارتفع cpu.usage وحمل cpu.user معظمه فابحث في عمليات التطبيقات (الوحدة 5 من المسار).
builtin:host.cpu.user:splitBy("dt.entity.host"):avg
builtin:host.cpu.system
الحصة في وضع النواة. وقيمة مرتفعة ومستمرة توحي بكثرة استدعاءات النظام أو تبديلات السياق أو مقاطعات الشبكة. إنها إشارة تُقارن بتاريخ المضيف، لا بعتبة مطلقة.
builtin:host.cpu.system:splitBy("dt.entity.host"):max
builtin:host.cpu.iowait
الزمن الذي كان فيه المعالج خاملًا بينما ظلت عملية إدخال وإخراج معلقة. وتوضح الوثائق أن المقياس غير موجود على Windows. وارتفاع iowait مع ارتفاع زمن استجابة القرص يشير إلى التخزين لا إلى المعالج.
builtin:host.cpu.iowait:splitBy("dt.entity.host"):max
builtin:host.cpu.steal
الزمن الذي تنتظر فيه آلة افتراضية دورات معالج يمنحها المحاكي لآلات افتراضية أخرى؛ وتذكر الوثائق أنه لمضيفي Linux. وتطبيق بطيء على مضيف معالجه معتدل لكن steal فيه مرتفع هو شأن فريق المحاكاة الافتراضية لا فريق التطبيق.
builtin:host.cpu.steal:splitBy("dt.entity.host"):avg:sort(value(avg,descending))
builtin:host.cpu.load
متوسط عدد العمليات قيد التنفيذ أو المنتظرة للمعالج خلال الدقيقة الأخيرة (ويوجد أيضًا load5m وload15m). الوحدة نسبة (ratio): قارنها بعدد أنوية المضيف. وحمل أعلى من عدد الأنوية يعني وجود طابور انتظار.
builtin:host.cpu.load:splitBy("dt.entity.host"):max
الذاكرة
builtin:host.mem.usage
نسبة الذاكرة المستخدمة، وتحسبها OneAgent بوصفها الإجمالي ناقص المتاح. فخ معروف: لا تطابق القيمة «used» في free ولا مدير المهام، لأن الذاكرة المؤقتة القابلة للاسترجاع تُحتسب متاحة. فلا تقارن الرقمين في خضم الأزمة.
builtin:host.mem.usage:splitBy("dt.entity.host"):max
builtin:host.mem.avail.bytes
الذاكرة المتاحة بالبايت، مقدّرة دون اللجوء إلى swap. وهو غالبًا مؤشر تنبيه أفضل من النسبة المئوية: ففي خادم كبير تمثل 5% حرة عدة غيغابايت.
builtin:host.mem.avail.bytes:splitBy("dt.entity.host"):min:sort(value(min,ascending)):limit(10)
builtin:host.mem.swap.used
مساحة swap المستخدمة بالبايت. لا يقلق swap المستقر؛ أما swap الذي يزداد بينما تنقص الذاكرة المتاحة فيُنذر بضغط على الذاكرة وبتدهور أزمنة الاستجابة.
builtin:host.mem.swap.used:splitBy("dt.entity.host"):max
builtin:host.mem.avail.pfps
أخطاء الصفحات في الثانية، الخفيفة والثقيلة معًا بحسب الوثائق. وتصعب قراءة القيمة منفردة؛ أما انقطاع واضح عن الأسبوع السابق مع swap فيؤكد نقص الذاكرة.
builtin:host.mem.avail.pfps:splitBy("dt.entity.host"):avg
القرص
builtin:host.disk.usedPct
نسبة المساحة المستخدمة لكل نظام ملفات. وهو مقياس تنبيهات «القرص ممتلئ». فكّر في الاتجاه: قسم عند 80% يربح نقطتين كل يوم أكثر إلحاحًا من قسم مستقر عند 90%.
builtin:host.disk.usedPct:splitBy("dt.entity.host","dt.entity.disk"):max:sort(value(max,descending)):limit(20)
builtin:host.disk.avail
المساحة الحرة بالبايت. وعلى Linux وAIX توضح الوثائق أنها المساحة المتاحة لمستخدم غير مميّز، دون الاحتياطي المخصص لـroot: فقد تكون القيمة أقل من قيمة df لدى root.
builtin:host.disk.avail:splitBy("dt.entity.host","dt.entity.disk"):min
builtin:host.disk.inodesAvail
نسبة الـinodes الحرة، وهي غير موجودة على Windows. قد يرفض القرص أي كتابة مع بقاء مساحة: وهي الحالة النموذجية للمجلدات المليئة بملفات صغيرة (الجلسات والطوابير والسجلات الدوّارة).
builtin:host.disk.inodesAvail:splitBy("dt.entity.host","dt.entity.disk"):min
builtin:host.disk.queueLength
متوسط عدد عمليات القراءة والكتابة الموجودة في الطابور. وطابور يظل مرتفعًا يدل على قرص لم يعد يستوعب الطلب؛ اقرأه مع أزمنة القراءة والكتابة أدناه.
builtin:host.disk.queueLength:splitBy("dt.entity.host","dt.entity.disk"):max
builtin:host.disk.readTime
متوسط زمن القراءة الواحدة على نظام الملفات بالمللي ثانية: أي زمن استجابة القرص كما يراه المضيف. وهو يفسر كثيرًا قاعدة بيانات بطيئة دون أن يتحرك المعالج.
builtin:host.disk.readTime:splitBy("dt.entity.host","dt.entity.disk"):avg
builtin:host.disk.writeTime
نظيره في الكتابة، بالمللي ثانية. وسجلات المعاملات وطوابير الرسائل شديدة الحساسية له. قارن القيمة قبل ترحيل التخزين وبعده لتقيس أثر التغيير بموضوعية.
builtin:host.disk.writeTime:splitBy("dt.entity.host","dt.entity.disk"):max
الشبكة والتوافر ونظام التشغيل
builtin:host.net.nic.trafficIn
الحركة الواردة لكل واجهة بالبت في الثانية؛ ويعطي builtin:host.net.nic.trafficOut الحركة الصادرة. انتبه إلى الوحدة: اقسم على 8 للمقارنة بمعدل بالبايت. وانسب القيمة إلى سعة الواجهة.
builtin:host.net.nic.trafficIn:splitBy("dt.entity.host"):max:sort(value(max,descending)):limit(10)
builtin:host.net.nic.packets.dropped
الحزم المرفوضة في الثانية على الواجهات؛ وتفصل المتغيرتان droppedRx وdroppedTx بين الاستقبال والإرسال. وكل قيمة غير صفرية باستمرار تستحق نظرة، خاصة إن ازدادت إعادة إرسال الخدمات.
builtin:host.net.nic.packets.dropped:splitBy("dt.entity.host")
builtin:host.availability.state
حالة توافر المضيف، تُبلَّغ كل دقيقة. تفيد في قياس توافر البنية التحتية أو التحقق من أن مضيفًا لم يختفِ خلال نافذة معينة. وقبل التصفية على حالة، اقرأ الأبعاد الدقيقة في وصف بيئتك.
builtin:host.availability.state:splitBy("dt.entity.host")
builtin:host.uptime
الزمن المنقضي منذ آخر تشغيل، بالثواني. وتشير الوثائق إلى أنه يتطلب OneAgent بالإصدار 1.259 أو أحدث وأنه غير موجود في وضع application-only. مفيد لاكتشاف إعادة تشغيل غير متوقعة قبل الحادثة مباشرة.
builtin:host.uptime:splitBy("dt.entity.host"):min:sort(value(min,ascending)):limit(10)
كيف تتحقق من أن الأمر يعمل
- اسرد المفاتيح الموجودة فعلًا في بيئتك:
curl -s "$DT_URL/api/v2/metrics?metricSelector=builtin:host.*&fields=unit,aggregationTypes" \ -H "Authorization: Api-Token $DT_TOKEN" - اقرأ وصف مفتاح (
GET /api/v2/metrics/builtin:host.disk.avail): يجب أن تطابق الوحدة والتجميعات والأبعاد الجدول. - الصق استعلامًا من هذه الوحدة في Data Explorer بوضع الشيفرة. يظهر خطأ الصياغة فورًا؛ وتدل سلسلة فارغة على مضيف غير مراقَب أو مقياس غير متاح على نظام التشغيل.
يجب أن يحمل الرمز المميّز النطاق metrics.read. والصياغة الكاملة لـmetric selector مفصلة في وحدة metric selector وAPI.
أفضل الممارسات
- حدّد التجميع دائمًا: ففي غيابه يلطّف المتوسط الافتراضي الذرى.
- نبّه على البايتات المتاحة بدل النسبة المئوية للأحجام الكبيرة.
- اقرأ المعالج وiowait وزمن استجابة القرص معًا قبل اتهام أي طرف.
- اجعل العتبات خاصة بحظيرتك: فالوثائق لا تحدد قيمة «طبيعية».
الأسئلة الشائعة
لماذا لا تُذكر كل مقاييس builtin:host.*؟
تضم القائمة الرسمية عدة عشرات، منها مقاييس خاصة جدًا بـz/OS أو AIX. تحتفظ هذه الوحدة بما يفيد في معظم التشخيصات؛ وتبقى صفحة Built-in metrics المرجع الشامل.
هل ينبغي حفظ المفاتيح العشرين عن ظهر قلب؟
لا. تذكّر المنطق (المعالج والذاكرة والقرص والشبكة والتوافر) وعد إلى الجدول الموجز عند بناء لوحة معلومات أو تنبيه.
هل تعمل هذه المفاتيح على Dynatrace SaaS؟
نعم، بوصفها مقاييس كلاسيكية عبر API v2. وفي Grail استخدم المفاتيح dt.host.* وأمر DQL المسمى timeseries، المشروحين في مسار مقاييس SaaS.
تغطي هذه البطاقات العشرون أساس تشخيص المضيف. وتصعد الوحدة التالية طبقة: الخدمات وطلباتها وأخطاؤها. وللمزيد عن البنية التحتية راجع أيضًا بنية Dynatrace Managed.
→ الوحدة 1: فهم المقاييس · فهرس المسار · الوحدة 3: الخدمات ←
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. المفاتيح والوحدات المذكورة مأخوذة من الوثائق الرسمية لـDynatrace Managed؛ تحقق منها في إصدار عنقودك.