المقدمة
يوضح هذا المستند كيفية تكوين الأحداث المخصصة في AppDynamics باستخدام واجهة برمجة تطبيقات REST وربطها بقواعد الصحة للتنبيه التلقائي.
المتطلبات الأساسية
- الوصول إلى مثيل AppDynamics SaaS أو مثيل وحدة التحكم المحلية
- أذونات لإنشاء الأحداث وقواعد الصحة والنهج وإدارتها
- وحدة التحكم الإصدار 21.x أو إصدار أحدث
- تم تكوين قنوات الإعلام (البريد الإلكتروني أو رسائل SMS أو عمليات التكامل الخاصة بجهة خارجية)
- الفهم الأساسي لواجهات برمجة تطبيقات REST وواجهة مستخدم AppDynamics
المتطلبات
تأكد من استيفاء هذه المتطلبات قبل البدء:
- AppDynamics Controller الإصدار 21.x أو إصدار أحدث (لأحدث الأحداث وميزات التنبيه)
- تمكين وصول REST API لوحدة التحكم لديك
- قنوات الإشعارات (البريد الإلكتروني أو رسائل SMS أو عمليات التكامل) التي تم تكوينها لتسليم التنبيه
المكونات المستخدمة
- وحدة التحكم في AppDynamics
- وكلاء AppDynamics
- قنوات الإخطار
تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.
معلومات أساسية
في عالم يتسم ببنية شبكية أصلية تزداد ديناميكية، يعد الرصد الاستباقي أمرا أساسيا لضمان مرونة النظام وتقليل متوسط الوقت المستغرق لحل المشكلات (MTTR). يوفر AppDynamics قدرات مراقبة قوية، بما في ذلك القدرة على إنشاء أحداث وتنبيهات مخصصة تساعد فرق العمليات على اكتشاف الحالات الشاذة بشكل أسرع والاستجابة بدقة.
تعد القياسات الحديثة عند إخراج الجهاز من عبوته أمرا بالغ الأهمية، إلا أن الأنظمة الحديثة تتطلب في كثير من الأحيان ملاحظة السياق الخاص. سواء أكنت تقوم بدمج خطوط أنابيب CI/CD أو أدوات التشغيل التلقائي المخصصة أو الأنظمة الخارجية، فإن إدخال أحداث مخصصة في AppDynamics يضمن:
- إمكانية رؤية موحدة عبر مقاييس النظام والأعمال
- الكشف في الوقت الفعلي عن الحالات الشاذة الخاصة بالتطبيق
- تقليل التدخل اليدوي من خلال الإجراءات التلقائية
في بعض الأحيان يكون من المنطقي أن تقوم بإنشاء أحداث مخصصة لمراقبة جوانب معينة من تطبيقك. الغرض من هذه المقالة هو توجيهك حول كيفية إنشاء أحداث مخصصة عبر واجهة برمجة تطبيقات REST في وحدة التحكم AppDynamics وكيفية إعداد تنبيه استنادا إلى الحدث المخصص.
التكوين
يغطي هذا القسم العملية التدريجية لإنشاء أحداث مخصصة وتكوين التنبيهات في وحدة التحكم في AppDynamics.
التكوينات
الخطوة 1: إنشاء أحداث مخصصة عبر واجهة برمجة تطبيقات REST
يمكن إنشاء أحداث مخصصة باستخدام واجهة برمجة تطبيقات AppDynamics REST. يكون هذا مفيدا لدمج الأنظمة الخارجية أو البرامج النصية المخصصة أو إطار عمل التشغيل التلقائي أو أداة من إنتاج جهة خارجية:
مثال إستدعاء واجهة برمجة التطبيقات:
POST https:///controller/rest/applications//events?severity=ERROR&summary=Application+Stopped&eventtype=CUSTOM&customeventtype=App_Stop&comment=Please_start_application
المعلمات الرئيسية:
- استبدلت <controller-url> و<application_id>مع وحدة التحكم التفاصيل.
- المعلمات المطلوبة:
- الخطورة (معلومات، تحذير، خطأ)
- ملخص (وصف مختصر)
- EventType (يجب أن يكون CUSTOM)
- CustomEventType (تسمية نوع الحدث المخصص)
- تعليق (رسالة مفصلة إختيارية)
يقوم طلب ناجح بإرجاع معرف حدث يؤكد الإنشاء
مثال: "تم إنشاء معرف الحدث بنجاح:550346816"
تلميح الرؤية: لا تنس تمكين عامل التصفية المخصص في واجهة مستخدم الأحداث لعرض الأحداث التي تم حقنها.

الخطوة 2: تصفية الأحداث المخصصة ومراقبتها
- في واجهة مستخدم وحدة التحكم، انتقل إلى قسم الأحداث.
- أستخدم عامل التصفية حسب الأحداث المخصصة لإضافة نوع الحدث أو خصائصه.
- يمكنك تحديد أزواج المفاتيح/القيم لمزيد من التصفية التفصيلية.
- إستخدام الكل للمنطق (يجب أن تتطابق جميع الخصائص)، أو Any ل OR للمنطق (تطابقات خاصية واحدة على الأقل)
وهذا يسمح بالتتبع والتحقيق المستهدفين للأحداث التي تم حقنها عبر التطبيق الخاص بك.
الخطوة 3: تكوين التنبيهات: الإجراءات والسياسات
الإجراءات:
- حدد ما يحدث عند تشغيل حدث مخصص (مثل إرسال بريد إلكتروني أو رسائل SMS أو إستدعاء إرتباط ويب):

السياسات:
- إنشاء نهج جديد أو تحرير نهج موجود:

- في النهج، قم بتكوين عامل تصفية الحدث المخصص لمطابقة الحدث المخصص الذي قمت بتعريفه.


- في علامة التبويب إجراءات السياسة، قم بإضافة إجراء جديد وحدد الإجراء المخصص الذي قمت بإنشائه:

- حفظ التنبيه: بعد تكوين التنبيه، انقر فوق حفظ" لإنشائه:

بمجرد إنشاء التنبيه، يتم تشغيله كلما تم إنشاء حدث مخصص يطابق المعايير المحددة في وحدة التحكم.
التحقق من الصحة
- نشر حدث مخصص للاختبار عبر واجهة برمجة تطبيقات REST:

- تأكيد إمكانية الرؤية في واجهة مستخدم الأحداث (مرشحات الفحص):

- تحقق من تشغيل هذا الإجراء للحدث المخصص:

- التحقق من صحة التسليم من خلال قناة الإعلام المكونة:


استكشاف الأخطاء وإصلاحها
مسألة |
خطوات أستكشاف الأخطاء وإصلاحها |
الحدث غير مرئي
|
- تأكد من تمكين نوع حدث عامل التصفية المخصص في واجهة مستخدم الأحداث
- تحقق بشكل مزدوج من معلمات EventType و CustomEventType في إستدعاء API.
|
أخطاء API
|
- خطأ شائع: "لم يتم تحديد ملخص الحدث". توفير ملخص دائما في طلبك
- التحقق من معرف المصادقة والتطبيق في إستدعاء API.
|
لم يتم تشغيل التنبيه
|
- تأكد من تكوين قاعدة الحماية والنهج بشكل صحيح.
- التحقق من إعداد قناة الإعلام (تكوين خادم البريد الإلكتروني/SMS).
|
حدود الحدث المخصص
|
- تحتوي وحدة التحكم على حدود لعدد مخطط الحدث المخصص وحجم الحدث.
- مراجعة الوثائق في حالة ترحيل وحدات تخزين كبيرة أو مخططات معقدة
|
القرار
توفر الأحداث المخصصة والتنبيهات في AppDynamics طريقة فعالة لإثراء إستراتيجية إمكانية الملاحظة الخاصة بك. سواء أكنت تقوم بالتكامل مع أدوات CI/CD أو الخدمات الخارجية أو تقوم فقط بتوسيع نطاق الرؤية في مهام سير العمل الرئيسية، فإن هذه القدرات تضمن اكتشاف المشكلات وحلها بشكل أسرع قبل أن تؤثر على المستخدمين. ابدأ في الاستفادة من ميزات ملاحظة مخصصة لرفع مستوى المراقبة لديك من مرحلة التفاعل إلى مرحلة التنبؤ.
الحاجة إلى مزيد من المساعدة
إذا كان لديك سؤال أو أنك تواجه مشاكل، فيرجى الوصول إلى دعم AppDynamics وتضمين تفاصيل مثل رسائل الخطأ أو معلومات التكوين أو السجلات ذات الصلة للمساعدة في تسريع أستكشاف الأخطاء وإصلاحها.
معلومات ذات صلة