أمثلة Workflows في Dynatrace: الشروط وJavaScript والتكاليف والحدود

أمثلة Workflows في Dynatrace: Problem trigger وDQL وJavaScript وشروط المهام وworkflow hours والحدود الموثقة لأتمتة العمل دون مفاجآت.
Exemples Workflows Dynatrace : conditions, JavaScript, coûts et limites

تُفتح مشكلة (problem) في الساعة الثانية فجرًا. فيكرر مهندس المناوبة (on-call) الخطوات نفسها: يتحقق من استمرار المشكلة، ويشغّل الاستعلام نفسه، وينسخ النتيجة إلى قناة الحادثة. هذا الجهد المتكرر (toil) هو بالضبط ما تؤتمته Workflows. يجمع هذا المقال أمثلة Workflows في Dynatrace عملية، من الأبسط إلى الأغنى، ثم يفصّل ما تقوله الوثائق عن الشروط وJavaScript والتكاليف والحدود.

الهدف ليس إعادة التعريف بـ Workflows، فقد تناولته الوحدة 7 من تدريب SaaS، ولا التكامل مع أنظمة إدارة الخدمات (ITSM) الذي شرحناه في مقالنا عن Jira وServiceNow. نركّز هنا على الآليات التي تُبقي سير العمل موثوقًا في الإنتاج: الشروط وخيارات المهام وJavaScript والميزانية.

النطاق: Workflows تطبيق في منصة Dynatrace SaaS (latest Dynatrace). أما Dynatrace Managed فلا يتوفر فيه؛ ويُستعاض عنه بملفات تعريف التنبيه (Alerting profiles) وتكاملات الإشعارات.

أمثلة Workflows في Dynatrace خطوة بخطوة

تذكير: لكل سير عمل مشغّل (trigger) واحد فقط، ومهام تنفّذ إجراءات، ويعمل بهوية actor لا يتجاوز صلاحياتها أبدًا. سير العمل البسيط (simple workflow) فيه مهمة واحدة ولا يدعم JavaScript، بينما يتيح سير العمل القياسي (standard workflow) الفروع والحلقات وJavaScript.

المثال 1 — إشعار بمشكلة دون تكلفة سير عمل

الحاجة الأكثر شيوعًا هي تنبيه قناة Slack أو عنوان بريد إلكتروني عند فتح مشكلة. يكفي simple workflow: المشغّل Problem trigger ومهمة إرسال واحدة. توضح الوثائق أنه لا يستهلك workflow hours؛ وإنما تُحتسب فقط استدعاءات الدوال (Standard Function Calls) المرتبطة بالإرسال.

المثال 2 — الانتظار حتى تستمر المشكلة ثم الإثراء

لكي لا توقظ المناوب بسبب مشكلة تُغلق وحدها خلال دقيقتين، اضبط Problem trigger كما يلي:

  1. Problem state: active؛
  2. Minimum duration (الخيارات المتقدمة): 5 أو 10 أو 15 أو 30 دقيقة، وصولًا إلى أسبوع؛
  3. تفعيل Wait for root cause analysis، وتوصي به الوثائق لتجنب البيانات الناقصة.

ثم أضف مهمة Execute DQL Query باسم dql_task. هناك فخ معروف: المشكلة المُطلِقة ليست بالضرورة مكتوبة في Grail لحظة تنفيذ المهمة. فبدل fetch أدخل الحدث مباشرة في الاستعلام:

data json: """{{ event()|to_json }}"""
| fields timestamp, event.name, event.id

الخيار الموثق الآخر هو ضبط Wait before بين 30 و45 ثانية على المهمة. ومثل هذا التأخير يقلل الضجيج أيضًا، كما يشرح مقالنا عن تقليل ضجيج تنبيهات Davis.

المثال 3 — تحويل نتيجة باستخدام JavaScript

يمكن لمهمة Run JavaScript موضوعة بعد dql_task أن تلخّص السجلات قبل الإشعار. يصدّر السكربت دالة غير متزامنة افتراضية، وقيمتها المُرجعة تصبح نتيجة المهمة.

import { result } from '@dynatrace-sdk/automation-utils';

export default async function () {
  const res = await result('dql_task');          // résultat de la tâche précédente
  const records = res.records ?? [];              // tableau renvoyé par la requête DQL
  if (records.length === 0) {
    return { count: 0, summary: 'aucun enregistrement' };
  }
  return {
    count: records.length,
    summary: records.slice(0, 5).map(r => r['event.name']).join(', ')
  };
}

تقرأ المهمة التالية هذه القيم عبر {{ result("run_javascript_1")["summary"] }}. ولا تستطيع المهمة قراءة إلا نتائج سابقاتها المباشرة، وإلا فشل التعبير برسالة «Undefined variables».

مقتطفات من وثائق Dynatrace: سكربت Run JavaScript يقرأ نتيجة المهمة my_task، وشرط Jinja يتحقق من أن استعلام DQL أعاد سجلات

المثال 4 — تقرير مجدول

مشغّل من نوع schedule، واستعلام DQL على أسبوع (fetch …, from: -7d)، ومهمة بريد إلكتروني. انتبه: بدون from يستعلم إجراء DQL عن آخر ساعتين بتوقيت UTC، ويعيد 1000 سجل على الأكثر افتراضيًا. ولكتابة الاستعلام يقدّم دليلنا عن أوامر DQL ثلاثين مثالًا.

الشروط: التحكم فيما يُنفَّذ

لكل مهمة قسم Conditions يُقرأ كجملة: «Run this task if» متبوعة بالحالة المتوقعة لكل سابق.

شرط الحالة تُنفَّذ المهمة إذا كان السابق…
success or skipped (الافتراضي) نجح أو تم تجاهله
success نجح
error or cancelled فشل أو أُلغي
error فشل
any انتهى، أيًّا كانت النتيجة

يُضاف إلى ذلك شرط مخصص، وهو تعبير Jinja يعيد قيمة منطقية، مثل {{ result("task_1").foo == "bar" }}. ويحدد قسم Else ما يحدث إذا لم يتحقق أي شرط: Skip (تُتجاهل المهمة ويستمر التنفيذ) أو Stop (لا يُنفَّذ شيء آخر على هذا الفرع).

الحالة success في مهمة DQL تعني فقط أن الاستعلام عمل، لا أنه وجد شيئًا. وثمة حلان موثقان: تفعيل Fail on empty result والتفرع عند error، أو اختبار الطول قبل الوصول إلى سجل:

{{ result("dql_task")["records"] | length > 0 and result("dql_task")["records"][0]["event.name"] != "" }}

لا يمكن أن يكون للمهمة الأولى بعد المشغّل شرط حالة لعدم وجود سابق، لكن يمكن أن يكون لها شرط مخصص على سياق الحدث.

خيارات المهمة التي يجب ضبطها

  • Wait before: 0 ثانية افتراضيًا، وحتى 86 400 ثانية، أو تعبير Jinja.
  • Loop task: تكرار على قائمة؛ التزامن الافتراضي 1. وتفشل المهمة إذا فشلت أي دورة.
  • Retry on error: محاولتان إضافيتان بفاصل 30 ثانية افتراضيًا.
  • Timeout: 60 دقيقة افتراضيًا، وحتى سبعة أيام للمهمة؛ وكل إجراء يبقى مقيّدًا ببيئة التشغيل (120 ثانية افتراضيًا).

JavaScript: ما يجب معرفته

  • حدود بيئة التشغيل: 120 ثانية و256 MB من الذاكرة؛ ونتيجة المهمة محدودة بـ 6 MB.
  • لا تعابير Jinja في مدخل السكربت (حماية من الحقن)، فاستخدم حزمة SDK المسماة @dynatrace-sdk/automation-utils (result وexecution وexecutionId…).
  • واجهات Dynatrace البرمجية: fetch("/api/v2/...") بعنوان URL نسبي، وتُضاف المصادقة تلقائيًا. لا تضف ترويسة Authorization: فهي تُستبدل وتسبب الخطأ 403.
  • الخدمات الخارجية: عنوان URL مطلق، ونطاق مسموح به في Settings > General > External requests. وتُستورد المكتبات الخارجية بعنوان URL من هذه النطاقات، بإجمالي 6 MB.
  • الأسرار: credentialVaultClient، مع نطاق AppEngine وخيار «Allow access without app context» وصلاحية وصول لـ actor إلى السر. لا تُرجع السر أبدًا ضمن النتيجة: فكل من يقرأ سير العمل يستطيع قراءته.
  • غير متاح في simple workflows.

التكاليف: workflow hours واستدعاءات الدوال

في ترخيص DPS تُقاس سعة Automation Workflow بوحدة workflow hours: عدد الساعات التي يوجد فيها سير عمل قياسي منذ إنشائه، سواء كان يعمل أم لا. فسير عمل قياسي موجود 14 يومًا يستهلك 24 × 14 = 336 workflow hours. أما simple workflows وسير العمل الموجود كمسودة فقط فلا تستهلك منها مباشرة.

ويطلق كل تنفيذ إضافة إلى ذلك Standard Function Calls، ويستهلك استعلام DQL داخل سير العمل من سعة استعلامات Grail. ولمتابعة الاستهلاك تقترح الوثائق:

fetch dt.system.events, scanLimitGBytes: -1
| filter event.kind == "BILLING_USAGE_EVENT"
| filter event.type == "Automation Workflow"
| summarize takeAny(event.id), by: {timestamp = bin(timestamp, 1d), event.id}
| summarize WorkflowHours = count(), by: {timestamp}
| sort timestamp asc

والنتيجة العملية: سير العمل القياسي المهجور يستمر في الاحتساب؛ أزِله من الوضع الحي (live) فيعود مسودة، أو احذفه. وتفاصيل النموذج في مقالنا عن ترخيص DPS.

الحدود التي يجب معرفتها

الحد القيمة الموثقة
التنفيذات المُطلَقة بحدث 1000 في الساعة لكل سير عمل؛ وما زاد عنها يُقابَل بالرمز HTTP 429 لمدة تصل إلى ساعة؛ ويُعطَّل المشغّل بعد ثلاث مرات تجاوز خلال سبعة أيام
تعبير تصفية المشغّل 1000 حرف، لجميع الحقول مجتمعة
نتيجة إجراء 6 MB مطروحًا منها حجم السجل
المدخل الافتراضي ونتيجة سير العمل 10 MB
الاحتفاظ بالتنفيذات 30 يومًا (أي مهلة تنفيذ قدرها 30 يومًا)
إجراء DQL 1000 سجل وساعتان افتراضيًا، بتوقيت UTC

وتذكّر الوثائق بأن محرك الأتمتة ينسّق العمليات ولا يمثل خط معالجة بيانات (data pipeline). وللأحجام الكبيرة، اكتب البيانات مباشرة إلى وجهتها من مهمة JavaScript.

أما الصلاحيات فتضبط الوصول أذونات IAM التالية: automation:workflows:read وautomation:workflows:write وautomation:workflows:run وautomation:workflows:admin؛ ويتطلب Problem trigger الإذن storage:events:read لـ actor.

كيف تتحقق من أن كل شيء يعمل

شغّل المسودة بالزر Run: يتيح لك Problem trigger تعديل سياق الحدث. ويعرض execution monitor الرسم البياني وحالة كل مهمة ومدتها وسجلها ومدخلاتها ونتائجها.

تحقق خصوصًا من المهام ذات الحالة Skipped أو Discarded: فهي تكشف شرطًا مكتوبًا بشكل خاطئ. ثم انشر في الوضع الحي؛ فسير العمل الحي وحده يُشغَّل تلقائيًا.

أفضل الممارسات

  • ابدأ بـ simple workflow، وانتقل إلى القياسي حين تحتاج إلى عدة خطوات أو JavaScript.
  • عدّل عبر المسودة لا مباشرة في الوضع الحي: فتغييرات الوضع الحي تسري فورًا.
  • اختر actor عن قصد (افتراضيًا هو آخر من حرّر) وقيّد صلاحياته بالقدر اللازم.
  • أضف مهمة Request Approval قبل أي إجراء إصلاح تلقائي.
  • سمِّ المهام تسمية صريحة: فاسمها هو مفتاح result().

الأسئلة الشائعة

لماذا تنجح مهمة DQL رغم أنها لا تجد شيئًا؟

النجاح يعني أن الاستعلام نُفِّذ فقط. فعّل Fail on empty result، أو اختبر | length > 0 في شرط المهمة التالية.

هل يستمر سير العمل المُزال من الوضع الحي في استهلاك workflow hours؟

سير العمل المُزال من الوضع الحي (undeploy) يعود مسودة فقط، وتشير الوثائق إلى أن سير العمل الموجود كمسودة فقط لا يستهلك workflow hours مباشرة. تحقق من النتيجة في Account Management ضمن سعة Automation Workflow.

هل يمكن استخدام Workflows مع Dynatrace Managed؟

لا، فـ Workflows جزء من منصة SaaS. في Managed استخدم Alerting profiles وتكاملات الإشعارات وواجهة API.

الخلاصة

يقوم سير العمل الموثوق على قواعد قليلة: مشغّل يصفّي جيدًا، وشروط صريحة، وJavaScript قصير لا يُرجع أي سر، وعين على workflow hours. انطلق من هذه الأمثلة، واختبرها في المسودة، وارجع إلى وثائق Workflows لمعرفة الإجراءات المتاحة.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لمالكها. الأمثلة مقدّمة على سبيل الاسترشاد: تحقق منها في بيئتك قبل استخدامها في الإنتاج.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Commandes DQL : filter, in(), summarize et timeseries en 30 exemples commentés

أوامر DQL: filter و in() و summarize و timeseries في 30 مثالًا موضحًا

Next Post
Grail vs Classic : ce qui change pour les permissions, les primary Grail tags et l'architecture

Grail مقابل Classic: ما يتغير في الصلاحيات ووسوم primary Grail والمعمارية

Related Posts