المسار: مقاييس Dynatrace SaaS · الوحدة 1/7 — مقاييس Grail · المدة: ~40 دقيقة · المستوى: مبتدئ إلى متوسط
الأهداف:
- قراءة مفتاح مقياس
dt.*ومعرفة ما يقيسه. - فهم دور الأبعاد وأمر DQL
timeseries. - مطابقة مفتاح كلاسيكي
builtin:مع مفتاحه في Grail. - معرفة الدقة والاحتفاظ بالبيانات وصلاحيات المقاييس على Grail.
المتطلبات: بيئة Dynatrace SaaS فيها OneAgent واحد على الأقل، وتطبيق Notebooks، وأساسيات DQL.
تمثّل مقاييس Grail السلاسل الزمنية التي يحفظها Dynatrace SaaS في Grail إلى جانب السجلات والـspans والأحداث. تضع هذه الوحدة الأولى من مسار مقاييس Dynatrace SaaS المفردات الأساسية: مفاتيح dt.* والأبعاد والتجميعات والمطابقة مع المفاتيح القديمة ومدة الاحتفاظ بالبيانات.
بالنسبة إلى مهندس SRE، المقياس هو المادة الخام لمؤشر مستوى الخدمة (SLI). وإذا قرأت مفتاحًا أو وحدة قراءة خاطئة، فإن هدف مستوى الخدمة (SLO) يقيس شيئًا غير ما تظنه، ويدفع فريق المناوبة الثمن. ساعة واحدة لفهم النموذج توفّر أسابيع من لوحات المعلومات المضللة.
تصلح هذه الوحدة لـDynatrace SaaS (المنصة التي فيها Grail). أما Dynatrace Managed فليس فيه Grail ولا DQL: تُعالج مقاييسه بمحدد المقاييس (metric selector) المشروح في مسار مقاييس Dynatrace Managed.
ما هي مقاييس Grail؟
المقياس في Grail سلسلة من القياسات الرقمية المختومة بالوقت، يعرّفها مفتاح وتصفها أبعاد. ينتج OneAgent المقاييس المدمجة (built-in) تلقائيًا؛ وتصل مقاييس أخرى عبر OpenTelemetry أو واجهة الاستيعاب أو بالاستخراج من السجلات والـspans (الوحدة 7).
تلخّص الوثائق ما يضيفه Grail إلى المقاييس:
- دقة دقيقة واحدة محفوظة 15 شهرًا؛
- إثراء بالسياق (المضيف والعملية وKubernetes والسحابة)؛
- عدد قيم غير محدود بسقف ثابت (cardinality)، مفيد لعمليات نشر Kubernetes شديدة الديناميكية؛
- إمكانية إنشاء سلاسل من السجلات أو الـspans أو بيانات أخرى.
يخضع استهلاك المقاييس على Grail لنموذج Dynatrace Platform Subscription (DPS). تحقق من عقدك قبل استيعاب مقاييس مخصصة بكميات كبيرة.
تشريح مفتاح dt.*
تتبع المفاتيح التي يوفرها Dynatrace ثلاث قواعد تسمية، موصوفة في صفحة «Built-in Metrics on Grail»:
- يُستبدل البادئة
builtin:بالبادئةdt.التي تدل على مقياس يوفره Dynatrace؛ - يحل snake case محل camel case:
bytes_readبدلbytesRead؛ - يصف الاسم القياس بدقة أكبر:
dt.host.disk.used.percentبدلusedPct.
اقرأ المفتاح من اليسار إلى اليمين، من الأعم إلى الأدق: dt.host.memory.avail.percent يدل على الذاكرة المتاحة لمضيف، بالنسبة المئوية. أما المقاييس التي تنشئها بنفسك فلا تبدأ بـdt.: هذه البادئة محجوزة.
المطابقة بين builtin: وdt.*
إن كنت قادمًا من Dynatrace Managed أو Metrics Classic، فاستعلاماتك وتنبيهاتك ولوحات معلوماتك تستخدم مفاتيح builtin:. تنشر الوثائق جدول المطابقة الكامل. وهذا مقتطف حقيقي منه:

ثلاث حالات تتطلب انتباهًا أثناء الترحيل:
- مقاييس مجمَّعة مسبقًا غير موجودة. كان
builtin:host.net.bytesRxيجمّع واجهات الشبكة لكل مضيف. يتعامل Grail مع العدد الكبير للقيم: فيُستعلم مباشرةdt.host.net.nic.bytes_rxويُجمَّع حسب المضيف. وكذلك لم يُعتمدbuiltin:host.mem.total. - Extensions 1.0. تظهر مقاييس
builtin:tech.*الصادرة عن Extensions 1.0 بالبادئةlegacy.، مثلlegacy.cassandra.KeyCache.Hit.Rate. والاستثناء: مقاييس العمليات العامة (builtin:tech.generic.*) وWebSphere. - الخدمات. تتجمع نحو ثلاثين مفتاح خدمة كلاسيكيًا في ثلاثة مقاييس لكل endpoint، تُرشَّح بالأبعاد (الوحدة 3). وتنتقل المقاييس المحسوبة للخدمة من البادئة
calc:serviceإلى البادئةservice.بعد تفعيلها على Grail.
يضع دليل الترحيل من Managed إلى SaaS هذه المطابقة في سياق مشروع ترحيل كامل.
الأبعاد والتجميعات وtimeseries
البعد زوج مفتاح-قيمة مرتبط بكل نقطة: dt.entity.host وdt.smartscape.host وendpoint.name وk8s.namespace.name… ويُستخدم للترشيح وتقسيم السلسلة. المفتاح نفسه بقيم أبعاد مختلفة يكوّن سلاسل متمايزة بعددها.
يُقرأ المقياس بأمر DQL timeseries، وهو أمر بداية يحمّل ويرشّح ويجمّع في خطوة واحدة. يقبل التجميعات sum وavg وmin وmax وcount وpercentile وpercentRank وcountDistinct، ومعاملات مثل by: وfilter: وinterval: وfrom: وrollup: (min وmax وsum وavg وtotal).
النتيجة متجانسة: تتشارك كل السلاسل timeframe وinterval نفسيهما، وتحتوي كل خلية على مصفوفة قيم، قيمة لكل فاصل. وبدون interval: يختار Dynatrace خطوة مناسبة للفترة، محاذاة لقيمة معروفة (1 أو 2 أو 5 أو 10 دقائق أو ساعة…). أساسيات اللغة في وحدة أساسيات DQL؛ وتتعمق الوحدة 7 من هذا المسار في timeseries.
استكشاف المقاييس المتاحة
يسرد الأمر metrics السلاسل الموجودة، دون قيم ولا أختام زمنية. يُستخدم لاكتشاف المفاتيح والأبعاد، على العشرة أيام الأخيرة كحد أقصى وفي حدود 100000 سلسلة لكل استعلام. وللحصول على البيانات الوصفية (الوصف والأبعاد) تحيل الوثائق أيضًا إلى ملف lookup الذي مساره /dt/platform/metrics.metadata.
تمرين عملي
الخطوة 1 — سرد مفاتيح مضيف
في Notebook، احصل على معرّف مضيف مراقَب (بصيغة HOST-…) ثم نفّذ مثال الوثائق:
metrics
| filter dt.entity.host == "HOST-6DF6DE092963F2AB"
| dedup metric.key
النتيجة المتوقعة: قائمة مفاتيح dt.host.* وdt.process.* وغيرها، يرسلها هذا المضيف.
الخطوة 2 — رسم أول سلسلة
timeseries usage = avg(dt.host.cpu.usage)
يعيد الاستعلام سلسلة واحدة: متوسط استخدام المعالج لكل المضيفين. اعرضها بشكل منحنى.
الخطوة 3 — التقسيم حسب بعد
timeseries usage = avg(dt.host.cpu.usage), by: {dt.smartscape.host}
| fieldsAdd host_name = getNodeName(dt.smartscape.host)
النتيجة المتوقعة: سلسلة لكل مضيف، باسمه المقروء. قارن عدد الأسطر بعدد المضيفين في البيئة.
الخطوة 4 — تحديد الفاصل والفترة
timeseries usage = avg(dt.host.cpu.usage), by: {dt.smartscape.host}, interval: 1h, from: -7d
لاحظ العمود interval: قيمته ساعة، وتحتوي كل مصفوفة نحو 168 قيمة.
كيف تتحقق من أن كل شيء يعمل
إذا أعاد timeseries خطأ وصول بدل نتيجة فارغة، فتحقق من صلاحياتك: قراءة المقاييس تتطلب storage:metrics:read وstorage:buckets:read. والنتيجة الفارغة على dt.host.cpu.usage تعني عادة أن أي OneAgent لا يرسل بيانات في الفترة المختارة: وسّع from: قبل البحث أبعد من ذلك.
أفضل الممارسات
- تحقق من كل مفتاح في جدول الوثائق قبل وضعه في تنبيه: المفتاح غير الموجود لا يثير خطأ، بل يعيد نتيجة فارغة فقط.
- دوّن الوحدة بجانب مؤشر SLI:
dt.service.request.response_timeمثلًا يُعبَّر عنه بالميكروثانية. - قسّم بأقل عدد ممكن من الأبعاد: كل بعد يضاعف عدد السلاسل المطلوب قراءتها وعرضها.
- احتفظ بالأمر
metricsللاستكشاف وtimeseriesللرسوم البيانية والحسابات.
للمزيد
- مقاييس المدرّج التكراري وOpenPipeline، للنسب المئوية على مقاييسك الخاصة
- لوحة معلومات Dynatrace SaaS: أمثلة DQL
- الوثائق الرسمية: Built-in Metrics on Grail وDQL metric commands
→ تقديم المسار · فهرس المسار · الوحدة 2: مقاييس المضيف في Grail ←
الأسئلة الشائعة
هل ما زالت مفاتيح builtin: تعمل في Dynatrace SaaS؟
تبقى قابلة للاستخدام مع Metrics Classic (واجهة Metrics API v2 وData Explorer). أما في DQL وعلى Grail فيجب استخدام مفاتيح dt.* المقابلة، ومن هنا أهمية جدول المطابقة.
كم مدة الاحتفاظ بالمقاييس على Grail؟
تعلن الوثائق دقة دقيقة واحدة لمدة 15 شهرًا. أما قواعد الاحتفاظ الخاصة بحسابك ودلاء (buckets) بياناتك فيبقى التحقق منها في إعدادات البيئة.
هل أستخدم dt.entity.host أم dt.smartscape.host؟
يظهر البعدان في الوثائق. تستخدم الأمثلة الحديثة dt.smartscape.host مع getNodeName()؛ بينما ما زالت أمثلة timeseries المرجعية تستخدم dt.entity.host. اختر أحدهما والتزم به داخل لوحة المعلومات الواحدة.
أصبحت تعرف كيف تقرأ مفتاح dt.* وتجده انطلاقًا من مفتاح builtin: وترسمه بـtimeseries. تطبّق الوحدة التالية هذه الأسس على مقاييس المضيف، وهي الأكثر استخدامًا أثناء المناوبة.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. لا يغني هذا المسار عن التدريبات والشهادات الرسمية في Dynatrace University. تحقق دائمًا من مفاتيح المقاييس في الوثائق الرسمية الخاصة ببيئتك.