workflow Dynatrace Jira أو ServiceNow: فتح تذكرة تلقائيًا عند حدوث مشكلة

workflow Dynatrace Jira أو ServiceNow: افتح تذكرة فور ظهور مشكلة Davis، دون تكرار ومع السياق، ثم تحقق من التنفيذ خطوة بخطوة.
Workflow Dynatrace Jira ou ServiceNow : ouvrir un ticket automatiquement sur problème

تُفتح مشكلة Davis، فيراها المناوب، ثم ينسخ أحدهم يدويًا العنوان والكيان المتأثر والرابط إلى Jira أو ServiceNow. تستغرق هذه الحركة خمس دقائق، وتُنجز بصورة سيئة في الثالثة صباحًا، وتُنسى مرة من كل عشر. يلغي workflow Dynatrace Jira (أو ServiceNow) هذا العمل الروتيني (toil): تُفتح التذكرة وحدها، مع السياق، بمجرد تأكيد المشكلة.

المكسب ملموس للموثوقية: التذكرة موجودة قبل أن يتصل المهندس أصلًا، وطابع وقت الفتح دقيق، وحساب زمن الحل (MTTR) يقوم على بيانات نظيفة بدل إدخالات متأخرة.

هدف هذا الدرس: بناء workflow ينشئ تذكرة Jira أو حادثة ServiceNow عند فتح مشكلة، دون تكرار، ثم التحقق من أنه يعمل. النطاق: توجد Workflows (AutomationEngine) في Dynatrace SaaS. أما في Dynatrace Managed فيمر الاحتياج نفسه عبر تكاملات إشعارات المشكلات، الموصوفة في آخر المقال.

المتطلبات المسبقة

  • بيئة Dynatrace SaaS مع تطبيق Workflows وصلاحيات إنشاء workflow وتنفيذه.
  • من جهة Jira: عنوان الموقع وحساب خدمة ورمز API من Jira ومشروع هدف. ومن جهة ServiceNow: نسخة (instance) وحساب تكامل له حق إنشاء الحوادث.
  • تطبيق الاتصال المقابل مثبّتًا من Hub (موصل Jira أو ServiceNow). قد تختلف الأسماء الدقيقة للتطبيقات والإجراءات بين الإصدارات: تحقق منها في Hub وفي وثائق Workflows.
  • مشكلات محددة النطاق جيدًا: إن كانت بيئتك تولّد الكثير منها، فابدأ بـ تقليل ضجيج تنبيهات Davis. فتذكرة تلقائية على تنبيه مزعج لا تفعل سوى نقل الضجيج.

بناء workflow Dynatrace Jira خطوة بخطوة

الخطوة 1: أنشئ الاتصال

في إعدادات تطبيق الاتصال بـ Jira أضف اتصالًا: عنوان الموقع (مثل https://your-company.atlassian.net) وبريد حساب الخدمة ورمز API من Jira. وفي ServiceNow أدخل عنوان النسخة وبيانات اعتماد حساب التكامل.

استخدم حساب خدمة مخصصًا لا حسابًا شخصيًا: ففي اليوم الذي يغادر فيه الشخص الفريق تستمر التذاكر في الفتح. وقصر صلاحياته على المشروع الهدف وحده.

الخطوة 2: اختر المشغّل (trigger)

أنشئ workflow واختر مشغّل حدث مشكلة Davis. اضبطه ليتفاعل مع المشكلات النشطة فقط، وصفِّ النطاق:

  • فئة المشكلة: التوافر والأخطاء مثلًا، بدل كل الفئات؛
  • الكيانات المعنية: تصفية على وسم مثل team:paiement، ليكون لكل فريق workflow ومشروعه.

هذه التصفية أهم قرار في الدرس. فـ workflow يفتح تذكرة لكل مشكلة ثانوية ينتج طابورًا لا يقرؤه أحد.

الخطوة 3: تجنب التكرار

قد تُحدَّث المشكلة الواحدة مرات عدة فتعيد تشغيل الـ workflow بحسب الإعدادات. أضف مهمة «Run JavaScript» تقرأ الحدث المشغِّل وتجهّز مفتاح إزالة التكرار:

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

export default async function ({ execution_id }) {
  const ex = await execution(execution_id);
  const event = ex.params.event;

  return {
    displayId: event['display_id'],
    label: 'dt-' + String(event['display_id']).toLowerCase(),
    title: event['event.name'],
    category: event['event.category'],
  };
}

السطر الحاسم: ex.params.event يحتوي الحدث الذي شغّل الـ workflow. أما المفتاح label (مثل dt-p-240123) فيصلح وسمًا في Jira أو مرجع ارتباط في ServiceNow: نبحث عن تذكرة تحمله قبل إنشاء أخرى.

بعد ذلك أضف مهمة بحث في Jira (إجراء بحث عن التذاكر بـ JQL إن كان موصلك يتيحه) بالاستعلام:

project = OPS AND labels = "{{ result("prepare_key").label }}" AND statusCategory != Done

أعطِ مهمة الإنشاء شرطًا يشغّلها فقط إذا لم يُرجع البحث أي تذكرة. يقبل محرر شروط المهمة تعبيرًا؛ تحقق من صيغته الدقيقة في المساعدة السياقية للمحرر.

الخطوة 4: أنشئ تذكرة Jira

أضف إجراء إنشاء تذكرة Jira، واختر اتصال الخطوة 1، ثم املأ الحقول بتعبيرات:

Projet      : OPS
Type        : Incident
Résumé      : [{{ result("prepare_key").displayId }}] {{ result("prepare_key").title }}
Étiquettes  : {{ result("prepare_key").label }}, dynatrace
Description :
  Problème Dynatrace {{ event()["display_id"] }}
  Catégorie : {{ event()["event.category"] }}
  Début : {{ event()["event.start"] }}
  Ouvert automatiquement par un workflow. Analyse et cause racine dans Dynatrace.

أضف إلى الوصف رابط المشكلة في بيئتك. تتوقف الصيغة الدقيقة للرابط على تطبيق Problems في إصدارك؛ انسخ واحدًا من الواجهة لبناء القالب.

الخطوة 4 مكرر: صيغة ServiceNow

مع موصل ServiceNow استبدل إجراء Jira بإجراء إنشاء حادثة. الحقول المعتادة في الجدول incident:

short_description : [{{ result("prepare_key").displayId }}] {{ result("prepare_key").title }}
description       : Problème Dynatrace {{ event()["display_id"] }}, catégorie {{ event()["event.category"] }}
correlation_id    : {{ result("prepare_key").label }}
urgency           : 2
impact            : 2
assignment_group  : <votre-groupe>

يحل الحقل correlation_id محل وسم Jira لإزالة التكرار. طابق الاستعجال والأثر مع مصفوفة الأولويات في ITSM لديك، بدل إرسال كل شيء بأولوية 1.

الخطوة 5: تفاعل مع إغلاق المشكلة

أنشئ workflow ثانيًا يُشغَّل على المشكلات المغلقة، يجد التذكرة بوسمها ويضيف تعليق «تم الحل من جهة Dynatrace». اترك إغلاق التذكرة لإنسان: فهذه لحظة استكمال السبب والقرار بشأن مراجعة لاحقة (postmortem). ولتنظيم هذه المراجعة راجع المراجعة اللاحقة بلا لوم باستخدام DQL.

كيف تتحقق من أنه يعمل

  1. شغّل الـ workflow يدويًا من المحرر، مع اختيار مشكلة حديثة حدثًا تجريبيًا إن كان الخيار متاحًا.
  2. افتح سجل التنفيذات: يجب أن تكون كل مهمة خضراء. وتعرض المهمة الفاشلة الخطأ الذي أعاده Jira أو ServiceNow (401 = بيانات الاعتماد، 400 = حقل إلزامي مفقود، وغالبًا نوع التذكرة).
  3. تحقق في Jira من وجود تذكرة تحمل الوسم dt-p-…. ثم أعد التنفيذ: يجب ألا تظهر تذكرة ثانية.
  4. في SaaS قارن مع المشكلات الفعلية:
    fetch dt.davis.problems, from:now()-24h
    | filter event.status == "ACTIVE"
    | fields display_id, event.name, event.category

    يجب أن تكون لكل مشكلة في النطاق المصفّى تذكرتها.

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

  • workflow لكل فريق، مصفّى بوسم، بدل workflow عام: فتصل كل تذكرة إلى المشروع الصحيح.
  • أزل التكرار دائمًا بمعرّف المشكلة: طابور مليء بالتكرارات يفقد ثقة الفرق.
  • سياق لا حجم: أضف استعلام DQL لسجلات الأخطاء للكيان المعني، كما في وحدة Workflows من مسار SaaS، بدل نص عام.
  • راقب الـ workflow نفسه: رمز Jira منتهي الصلاحية يوقف إنشاء التذاكر بصمت. ويكفي إشعار عند فشل التنفيذ.
  • اختبر في مشروع تجريبي قبل التوجيه إلى مشروع الإنتاج.

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

كيف أفعل الشيء نفسه في Dynatrace Managed؟

لا يملك Managed ميزة Workflows. استخدم تكاملات إشعارات المشكلات (Jira أو ServiceNow أو webhook مخصص)، مقترنة بملف تنبيه يصفّي النطاق. والطريقة مفصلة في ملفات التنبيه وتكاملات الإشعارات.

هل أحتفظ بتكامل الإشعارات إن كان لدي workflow؟

لا، ليس للنطاق نفسه: فكلاهما سينشئ تذاكر مكررة. انتقل فريقًا فريقًا وعطّل التكامل القديم بعد اعتماد الـ workflow.

هل أستطيع استدعاء API الخاصة بـ Jira مباشرة بطلب HTTP؟

نعم، يتيح ذلك إجراء طلب HTTP، مع تخزين بيانات الاعتماد بصورة آمنة والسماح بنطاق Jira في إعدادات البيئة. ويبقى الموصل أسهل صيانة؛ ويُستخدم طلب HTTP لحقل أو نقطة وصول لا يغطيها.

الخلاصة

يحوّل workflow مصفّى جيدًا وخالٍ من التكرار كل مشكلة Davis إلى تذكرة قابلة للاستغلال دون إدخال يدوي. يكسب المناوب دقائق في كل حادثة، ويصبح MTTR قابلًا للقياس، وتنطلق مراجعة الحادثة من بيانات موثوقة. ابدأ بفريق ومشروع واحد، ثم وسّع.

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

Total
0
Shares
Leave a Reply

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

Previous Post
Requêtes DQL exemples : 15 requêtes prêtes à copier avec DQL summarize, filter et timeseries

أمثلة استعلامات DQL: 15 استعلامًا جاهزًا للنسخ مع DQL summarize وfilter وtimeseries

Next Post
OpenTelemetry Python FastAPI : instrumenter une API vers Dynatrace sans OneAgent

OpenTelemetry Python FastAPI: قياس واجهة API وإرسالها إلى Dynatrace دون OneAgent

Related Posts