يطلب العمل هدف مستوى خدمة (SLO) على الطلبات المؤكَّدة، ويريد فريق الدفع متابعة حالات الرفض بحسب السبب، وتريد فرق التشغيل عدّ أخطاء دفعة (batch) لا تكتب إلا سجلات. لا توجد أي من هذه القيم في المقاييس المدمجة. لا بد إذن من إنشاء مقياس مخصص في Dynatrace، واختيار الطريقة لا يقل أهمية عن المقياس نفسه: فهو يحدد كثافة الأبعاد الممكنة (cardinality) والتكلفة، وما سيتعين تعديله يوم يتغير المصدر.
يقارن هذا الدليل أربع طرق لإنشاء مقياس مخصص في Dynatrace: المقاييس المحسوبة للخدمات (calculated service metrics) انطلاقًا من التتبعات، ومقاييس السجلات (log metrics) انطلاقًا من السجلات، والاستيعاب عبر Metrics API من نص برمجي أو تطبيق، وOneAgent SDK الذي لا ينشئ مقياسًا بل يوفر المادة الخام. كل طريقة مصحوبة بمثال وبطريقة تحقق.
يغطي المحتوى Dynatrace Managed وDynatrace SaaS. وتُذكر الفوارق: في SaaS على Grail يصبح OpenPipeline المسار الموصى به لاستخراج المقاييس من السجلات والـ spans، وتنتقل صياغة الاستعلام من metric selector إلى DQL.
أي طريقة لإنشاء مقياس مخصص في Dynatrace
| البيانات موجودة في… | الطريقة | بادئة المفتاح | المنصات |
|---|---|---|---|
| طلبات خدمة (التتبعات) | Calculated service metric | calc:service. |
Managed وSaaS (يوصى بـ OpenPipeline على Grail) |
| السجلات | Log metric | log. |
Managed وSaaS (OpenPipeline Metric extraction على Grail) |
| نص برمجي أو مهمة أو تطبيق | Metrics API ingest | حرة (باستثناء dt.) |
Managed وSaaS |
| تقنية غير مجهَّزة | OneAgent SDK ثم calculated metric | calc:service. |
Managed وSaaS |
قاعدة بسيطة: إن كانت البيانات تمر أصلًا عبر Dynatrace (تتبعات أو سجلات)، فاشتق المقياس منها بدل إرسالها مرة ثانية. وخصّص الاستيعاب للقيم التي لا يراها Dynatrace. وللأساسيات (أنواع المقاييس والأبعاد والدقة)، راجع وحدة «فهم المقاييس».
الطريقة 1: المقاييس المحسوبة للخدمات (التتبعات)
يلتقط Dynatrace أصلًا كل طلب إلى خدمة. تستخرج calculated service metric منه قيمة (زمن الاستجابة أو عدد الطلبات أو قيمة request attribute…) للطلبات التي تستوفي شروطًا، مع تقسيم اختياري بحسب بُعد.
الخطوات
- انتقل إلى Settings > Server-side service monitoring > Calculated service metrics > Create new metric.
- أعطِ اسمًا: يضيف Dynatrace تلقائيًا البادئة
calc:service.إلى المفتاح. - اختر Metric source. بالنسبة إلى request attribute حدّد الوحدة.
- اختياريًا: management zone وIgnore muted requests.
- أضف الشروط (يجب أن تتحقق كلها)، مثل الخدمة = checkout وrequest attribute orderStatus = VALIDATED. تسرد المعاينة الخدمات المعنية.
- اختياريًا: Split by dimension مع عنصر نائب (placeholder) أو عنصر نائب مخصص مستخرج بفاصل أو regex، وعدد أعلى القيم (top values).
- راجع المصدر وأسماء الأبعاد: لن يمكن تعديلها لاحقًا. ثم Save metric.
حدود يجب معرفتها
- البيانات الجديدة وحدها تغذي المقياس: لا حساب بأثر رجعي.
- 500 مقياس محسوب نشط لكل بيئة، و100 لكل خدمة.
- قاعدة «top X»: 100 قيمة بُعد على الأكثر؛ والباقي يُجمَّع في بُعد remainder.
في SaaS توصي الوثائق الآن باستخراج هذه المقاييس من الـ spans عبر OpenPipeline: لا حد لـ 500 مقياس ولا قاعدة top X، وكثافة أبعاد كاملة، وتوجيه إلى buckets في Grail. أما request attributes نفسها فراجع Distributed traces وPurePath.
الطريقة 2: مقاييس السجلات (Log metrics)
Managed وLog Monitoring Classic
- انتقل إلى Settings > Log Monitoring > Metrics extraction واختر Add log metric (أو، من عارض السجلات، Create metric على استعلام).
- Metric key: أكمل بعد
log.، مثلlog.paiement_refus. - Matcher: الاستعلام الذي يرشّح السجلات، مثل
status="error". - Measure: Occurrence of log records (عدّ) أو Attribute value (المتوسط والمجموع والحد الأدنى والأقصى والوسيط والمئينات لسمة رقمية).
- Add dimension: مثل process group instance، لمعرفة أين تحدث الأخطاء.
فخان اثنان. لا يوجد المقياس إلا انطلاقًا من السجلات المستوعَبة بعد إنشائه. وتعديل المفتاح ينشئ مقياسًا جديدًا: يبقى السجل التاريخي تحت المفتاح القديم. وفي Managed تذكر الوثائق حدًا قدره 1 000 000 بُعد لكل مقياس و50 000 000 للمجموع؛ وإنشاء مقاييس من السجلات المحذوفة (dropped logs) غير متاح هناك.
SaaS على Grail: OpenPipeline
في OpenPipeline تقدّم مرحلة Metric extraction المعالِجات Counter metric (تعدّ السجلات) وValue metric (مقياس gauge من حقل رقمي) وHistogram metric (توزيع)، إضافة إلى نسخ للـ spans المأخوذة بالعيّنات. لكل معالج شرط DQL ومفتاح وأبعاد؛ ولا يُعدَّل السجل المصدر.

بالنسبة إلى المدرّجات التكرارية (histograms)، راجع مقاييس histograms مع OpenPipeline.
الطريقة 3: الاستيعاب عبر Metrics API
لقيمة لا يراها Dynatrace (نتيجة مهمة أو عدّاد عمل أو قياس جهاز)، أرسلها بالطلب POST /api/v2/metrics/ingest. لا حاجة إلى إعلان المقياس مسبقًا.
البروتوكول

- المفتاح: أقسام تفصلها نقاط، من 3 إلى 255 محرفًا، حروف وأرقام وشرطات وشرطات سفلية؛ ولا يبدأ برقم أو شرطة. البادئة
dt.محجوزة. - حتى 50 بُعدًا بالشكل
clé="valeur"في السطر الواحد؛ وdt.entity.host=HOST-…يربط القياس بمضيف. - الصيغة
gauge(قيمة أو min/max/sum/count) أوcount,delta=…. في المقاييس Classic (Managed) يتلقى مفتاح من نوع count اللاحقة.count؛ أما مقاييس Grail فلا تطبّقها. - ختم زمني اختياري بالميلي ثانية UTC، يُقبل من ساعة واحدة في الماضي إلى 10 دقائق في المستقبل.
- الحمولة
text/plainمحدودة بـ 1 ميغابايت.
مثال
# Token with the metrics.ingest scope (Managed: https://{votre-domaine}/e/{id-environnement})
curl -s -X POST "https://{votre-domaine}/e/{id-environnement}/api/v2/metrics/ingest" \
-H "Authorization: Api-Token {token}" \
-H "Content-Type: text/plain; charset=utf-8" \
--data-binary $'#shop.orders.validated gauge dt.meta.displayName="Commandes validées"\nshop.orders.validated,channel="web",country="fr" 42'
تعيد الاستجابة 202 الحقلين linesOk وlinesInvalid؛ ويشير 400 إلى أسطر غير صالحة، مع أن الأسطر الصالحة تُقبل رغم ذلك. اقرأ هذين العدّادين دائمًا في نصوصك البرمجية.
على مضيف مزوَّد بـ OneAgent تعرض الوحدة EEC أيضًا العنوان http://localhost:14499/metrics/ingest (المنفذ الافتراضي)، دون رمز: يُضاف البُعد dt.entity.host تلقائيًا. هذا أبسط حل لمهمة cron محلية. وفي SaaS تقبل الواجهة نفسها رمز منصة (platform token)؛ ويذكر مثال الوثائق النطاق openpipeline:metrics:ingest.
الطريقة 4: OneAgent SDK، التجهيز أولًا
يُستخدم OneAgent SDK (Java وC/C++ وNode.js و.NET وPython وPHP) لتتبع ما لا يراه OneAgent وحده: الاستدعاءات البعيدة، واستعلامات قواعد البيانات، وطلبات الويب، والطوابير والرسائل، والتنفيذ غير المتزامن، والتقاط request attributes. وهو لا ينشئ مقياسًا مباشرة. المسار إذن: جهّز بالـ SDK، والتقط القيمة كـ request attribute، ثم أنشئ calculated service metric (الطريقة 1). المتطلبات: OneAgent بوضع full-stack على المضيف، وإعادة تشغيل التطبيق بعد تثبيت OneAgent.
كيف تتحقق من أن كل شيء يعمل
- Managed: افتح Data Explorer وابحث عن المفتاح (
calc:service.…أوlog.…أوshop.orders.validated). استعلام تحقق:shop.orders.validated:splitBy("channel"):sum - SaaS: في Notebook، استعلم عن المقياس بـ DQL:
timeseries total = sum(shop.orders.validated), by:{channel} - الاستيعاب: تحقق من
linesInvalid = 0في استجابة API. - Log metric وcalculated metric: ولّد حدثًا معروفًا (خطأ اختباري) وتحقق من ظهوره خلال الدقيقة التالية.
متى استقر المقياس، حوّله إلى تنبيه: راجع إنشاء تنبيه في Dynatrace خطوة بخطوة.
أفضل الممارسات
- اشتق من البيانات الموجودة قبل الاستيعاب المزدوج.
- اصطلاح تسمية (
équipe.domaine.mesure) وبيانات وصفيةdt.meta.displayNameوdt.meta.descriptionمنذ السطر الأول. - كثافة أبعاد مضبوطة: لا معرّف طلب أو مستخدم أو عنوان URL كامل كبُعد.
- مفاتيح ثابتة: إعادة التسمية تكسر السجل التاريخي ولوحات المعلومات والتنبيهات.
- رموز الاستيعاب محصورة في النطاق
metrics.ingest.
الأسئلة الشائعة
لماذا صار اسم مقياسي المستوعَب فجأة «.count»؟
في المقاييس Classic يضيف السطر بصيغة count اللاحقة .count تلقائيًا إلى المفتاح. استعلم عن ma.cle.count، أو أرسل قيم gauge إن أردت إبقاء المفتاح كما هو.
مقياسي المحسوب للخدمة فارغ عن الشهر الماضي. هل هذا طبيعي؟
نعم. لا يتغذى إلا بالطلبات اللاحقة لإنشائه. للتحليل بأثر رجعي، استخدم Multidimensional analysis على التتبعات المحفوظة.
Log metric أم الاستيعاب عبر API لدفعة تكتب سجلات؟
إن كانت السجلات مستوعَبة أصلًا، فإن log metric تجنّبك سلسلة ثانية للصيانة. وإن كانت الدفعة قادرة على استدعاء API ولا تُجمع سجلاتها، فالاستيعاب المباشر أوثق من تحليل النص.
الخلاصة
إنشاء مقياس مخصص في Dynatrace هو في الأساس اختيار المصدر الصحيح: التتبعات للخدمات، والسجلات لما لا يوجد إلا فيها، وAPI لما عداه، وSDK لسد ثغرة التجهيز. والمقياس حسن التسمية، المضبوط الأبعاد، يصبح مؤشر مستوى خدمة (SLI) موثوقًا وتنبيهًا وسطرًا في لوحة معلومات.
المراجع: Metric ingestion protocol وCalculated metrics for services (وثائق Managed)، وMetric extraction in OpenPipeline (وثائق SaaS).
span.observer مدوّنة مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. المعلومات مأخوذة من الوثائق العامة؛ تحقق من الحدود والخيارات في إصدارك قبل أي استخدام في الإنتاج.