يسأل مدير المنتج كم طلبًا فشل خلال حادثة مساء أمس. تُظهر التتبعات أخطاء 500 وتُظهر السجلات استثناءات، لكن لا أحد يعرف كيف يترجم ذلك إلى سلال ضائعة. هنا تسدّ business events Dynatrace الفجوة: تلتقط واقعة تجارية (طلب أو دفعة أو تسجيل) مع سماتها لحظة حدوثها. يُنشئ هذا الدليل أول business event ويستغلّه من البداية إلى النهاية.
بالنسبة إلى مهندس SRE هذا مؤشر مستوى خدمة (SLI) من الدرجة الأولى. معدل الطلبات الناجحة أوضح للجميع من زمن استجابة p95، وهو يقيس مباشرة ما تحميه ميزانية الأخطاء (error budget). والأفضل أنك تستطيع مع OneAgent التقاط هذه الأحداث دون تعديل سطر واحد من كود التطبيق.
الهدف: إنشاء قاعدة التقاط في OneAgent تحوّل طلب HTTP إلى حدث تجاري، ثم استعلامه بـ DQL، واستخراج مؤشر أداء رئيسي (KPI) وتنبيه منه. المحتوى موجه إلى Dynatrace SaaS (التخزين في Grail). أما في Dynatrace Managed فتحقق من توافر Business Analytics في إصدارك قبل البدء.
ما هي business events Dynatrace
الـ business event سجل مخزَّن في جدول bizevents في Grail. يحمل على الأقل مزوِّدًا (event.provider) ونوعًا (event.type) وطابعًا زمنيًا، ثم السمات التي تختارها: المبلغ والعملة ومعرّف العميل ووسيلة الدفع.
ثلاثة مصادر رئيسية:
- OneAgent: تقرأ قاعدة التقاط طلب HTTP أو استجابته في خدمة مراقَبة. دون كود.
- RUM: أحداث ترسَل من المتصفح أو من تطبيق الجوال.
- API: طلب POST بصيغة CloudEvents إلى
/api/v2/bizevents/ingest، مفيد لنظام خارجي (ERP أو معالجة دفعية).
لا تخلطها بالسجلات: الـ business event منظَّم منذ لحظة الالتقاط، بمخطط تتحكم فيه أنت. لا تحليل نصي ولا regex هش.
المتطلبات
- بيئة SaaS مع OneAgent بنمط Full-Stack على الخدمة التي تستقبل الطلبات التجارية (Java أو .NET أو Node.js أو Go أو PHP أو أي تقنية أخرى يدعمها الالتقاط).
- صلاحية تعديل إعدادات Business Observability.
- للـ API: رمز (token) بالنطاق
bizevents.ingest، أو رمز منصة بالنطاقopenpipeline:bizevents:ingest. - معرفة شكل الطلب المراد التقاطه: المسار والطريقة وحقول جسم JSON.
الخطوة 1: اختيار المؤشر والطلب الحامل له
ابدأ من سؤال دقيق: «كم طلبًا مؤكدًا في الدقيقة، وبأي مبلغ؟». حدد الاستدعاء الذي يجسّده، مثلًا:
POST /api/checkout
Content-Type: application/json
{ "orderId": "A-1029", "amount": 84.90, "currency": "EUR", "paymentMethod": "card" }
دوّن أيضًا ما يدل على الفشل: رمز حالة HTTP غير 200، أو حقل status في الاستجابة.
الخطوة 2: إنشاء قاعدة الالتقاط في OneAgent
- افتح Settings > Business Observability > OneAgent business event sources (قد يختلف الاسم؛ ابحث عن «business event» في الإعدادات).
- أضف قاعدة وسمّها، مثلًا
checkout-order. - Triggers:
request.pathيساوي/api/checkoutوrequest.methodيساويPOST. المشغِّلات مجمّعة بالمنطق AND: يجب أن تتحقق كلها. - Event provider: قيمة ثابتة، مثلًا
shop.checkout. - Event type: قيمة ثابتة، مثلًا
com.shop.order.submitted. - Data fields: أضف
amount(المصدرrequest.bodyوالمسارamount) وcurrencyوpaymentMethodوstatus(المصدرresponse.statusCode). - احفظ. تُطبَّق القاعدة دون إعادة تشغيل في معظم الحالات؛ راجع الوثائق لمعرفة حالة تقنيتك.
نقطة حرجة: لا تلتقط أبدًا بيانات شخصية غير لازمة (الاسم أو العنوان أو رقم البطاقة). وإذا لزم أن يمر حقل حساس فأخفِه في خط المعالجة: انظر إخفاء البيانات الحساسة باستخدام OpenPipeline.
الخطوة 3 (اختيارية): إرسال حدث عبر API
لمصدر لا يراقبه OneAgent يكفي استخدام الـ API:
curl -s -X POST "$DT_ENV/api/v2/bizevents/ingest" \
-H "Authorization: Api-Token $DT_TOKEN" \
-H "Content-Type: application/cloudevent+json" \
-d '{
"specversion": "1.0",
"id": "erp-55102",
"source": "erp.invoicing",
"type": "com.shop.invoice.created",
"data": { "orderId": "A-1029", "amount": 84.90, "currency": "EUR" }
}'
الحقول specversion وid وsource وtype إلزامية. يصبح source مزوِّد الحدث وtype نوعه.
الخطوة 4: استعلام كل business event بـ DQL
تحقق أولًا من وصول الأحداث:
fetch bizevents, from:now()-1h
| filter event.provider == "shop.checkout"
| filter event.type == "com.shop.order.submitted"
| sort timestamp desc
| limit 20
ثم ابنِ المؤشر: الحجم والإيرادات ومعدل النجاح لكل شريحة من خمس دقائق.
fetch bizevents, from:now()-24h
| filter event.type == "com.shop.order.submitted"
| fieldsAdd ok = if(toLong(status) == 200, 1, else: 0)
| makeTimeseries orders = count(),
revenue = sum(toDouble(amount)),
succeeded = sum(ok),
interval:5m
معدل النجاح (succeeded / orders) هو SLI تجاري جاهز للاستخدام. وتجد نماذج استعلامات أخرى في استعلامات DQL للتشغيل.
الخطوة 5: التنبيه على المؤشر
مقاربتان:
- SLO: حدد هدفًا لمعدل نجاح الطلبات ونبّه على استهلاك ميزانية الأخطاء، كما في تنبيهات burn rate.
- كاشف الشذوذ: على السلسلة
orders، يلتقط حد أدنى أو كشف تكيّفي الهبوط المفاجئ في الحجم، وهو عرض نموذجي لعطل في الدفع دون خطأ ظاهر.
لفتح تذكرة تلقائيًا أعد استخدام سير العمل نحو Jira وServiceNow.
كيف تتحقق من أن النتيجة صحيحة
- نفّذ طلب اختبار في بيئة ما قبل الإنتاج.
- شغّل أول استعلام DQL من الخطوة 4: يجب أن يظهر الحدث وحقول
amountوcurrencyوstatusمعبّأة. - إذا وُجد الحدث وكان أحد الحقول فارغًا فمسار حقل البيانات خاطئ (حالة الأحرف أو التداخل). صحّحه في القاعدة.
- إذا لم يصل شيء: الخدمة ليست بنمط Full-Stack، أو الطلب لا يطابق المشغِّلات (مسار ببادئة أو طريقة مختلفة)، أو التقنية لا تتيح قراءة الجسم.
أفضل الممارسات
- سمِّ الأنواع كما تسمّي واجهة API:
com.entreprise.domaine.action، ثابتة عبر الزمن. - حقول قليلة مختارة بعناية: لكل سمة كلفة تخزين وخطر على الخصوصية.
- مؤشر واحد لكل مسار حرج: السلة والدفع والتسجيل. لا أكثر في البداية.
- اربط بالجانب التقني: تحتفظ الأحداث التي يلتقطها OneAgent بسياق التتبع، فتنتقل من طلب فاشل إلى الطلب البطيء الذي يفسره.
- المرجع: وثائق Business Observability.
الأسئلة الشائعة
هل تحل business events Dynatrace محل أداة تحليلات الويب؟
لا. تُستخدم لربط وقائع تجارية بالصحة التقنية، لا لتحليل قمع التسويق. الأداتان تجيبان عن أسئلة مختلفة.
ما كلفة الـ business events؟
تُفوتر عند الاستيعاب والاحتفاظ والاستعلام بحسب عقدك. قدّر الحجم (عدد الأحداث في اليوم مضروبًا في الحجم) قبل تفعيل قاعدة على مسار كثير الطلب.
هل يمكن التقاط الاستجابة بدل الطلب؟
نعم: تشمل مصادر البيانات response.body وresponse.headers وresponse.statusCode. وغالبًا ما توجد هناك النتيجة الفعلية للعملية.
الخلاصة
قاعدة التقاط واستعلاما DQL وSLO واحد: في ساعة يصبح معدل الطلبات الناجحة مؤشرًا مشتركًا بين المنتج والتشغيل. وفي الحادثة القادمة سيكون لسؤال «كم عميلًا تأثر؟» جواب رقمي.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. أسماء الشاشات والخيارات تتغير: تحقق منها في الوثائق الرسمية الخاصة بإصدارك.