ربط New Relic
اربط حساب New Relic لجلب مضيفات البنية التحتية وخدمات APM ومراقبات الاختبارات الاصطناعية إلى Excubius، مع مقاييسها الذهبية (golden metrics) وقضاياها المفتوحة. يوضح هذا الدليل الإعداد بأقل الامتيازات على جانب New Relic، وكيفية إضافة المصدر، وكيفية إرسال القضايا عبر webhook.
قبل البدء
- تحتاج إلى دور Entity admin على الكيان الذي ينتمي إليه الحساب، مثل شركة خان الخليلي.
- في New Relic، تستطيع إنشاء مستخدم أو مستخدم خدمة، ومفتاح API، وسير عمل (workflow) على الحساب.
- الميزة
sources.newrelicمشغّلة. راجع المصادر.
ما الذي يقرؤه Excubius
تُقرأ New Relic عبر NerdGraph باستعلامات GraphQL فقط، وليس mutations أبدًا.
| المرحلة | ما الذي يُقرأ | الفاصل الافتراضي |
|---|---|---|
| Inventory | بحث الكيانات في الحساب: مضيفات البنية التحتية (Windows أو Linux أو macOS بحسب علامة نظام التشغيل)، وتطبيقات APM، ومراقبات الاختبارات الاصطناعية، مع إمكانية تضييقها بشرط بحث عن الكيانات | 15 دقيقة |
| Metrics | الملخصات التي يعيدها البحث نفسه، دون NRQL، لذلك تستهلك حصة قليلة. وتغذّي وحدة المعالجة المركزية والذاكرة والقرص للمضيف فحوص مضيفات Windows وLinux؛ وتغذّي APM والاختبارات الاصطناعية فحوص New Relic | 5 دقائق |
| Alerts | قضايا AI في الحالتين CREATED وACTIVATED خلال آخر 30 يومًا، وتنبيه واحد لكل قضية وكيان | 5 دقائق في Polling؛ ومصالحة كل 15 دقيقة في Hybrid |
تجهيز New Relic
- أنشئ مستخدمًا، أو استخدم مستخدم خدمة، يكون دوره read only على الحساب، مثل الدور المضمّن All product read only.
- سجّل الدخول بذلك المستخدم، وافتح API keys وأنشئ مفتاحًا من النوع User. انسخ المفتاح؛ فهو يبدأ بـ
NRAK-. ولا تعمل مفاتيح الترخيص (license) والمتصفح (browser) والاستيعاب (ingest). - دوّن account ID ومركز البيانات، US أو EU.
مفتاح المستخدم هذا هو كل ما يحتاج إليه Excubius للاستطلاع. أما المصدر في وضع Webhook only فلا يحتاج إلى المفتاح ولا إلى account ID.
إضافة المصدر
- افتح Settings › Sources وحدد Add a source واختر New Relic.
- ضمن General، أدخل Name، مثل New Relic شركة خان الخليلي، واختر Entity.
- ضمن Connection، أدخل Account ID وRegion وUser API key.
- ضمن What to read، أبقِ Hosts وAPM services وSynthetic monitors وGolden metrics، أو ألغِ تحديد ما لا تريده. وبدون Golden metrics تدخل الكيانات دون مقاييسها.
- اختياريًا، أدخل Entity filter، وهو شرط بحث عن كيانات New Relic مثل
tags.environment = 'production'. استخدمه عندما يغطي حساب واحد عدة عملاء. - ضمن Ingest mode، أبقِ Hybrid (recommended).
- اختياريًا، ضمن Webhook، أدخل Webhook secret ترسله New Relic مع كل webhook.
- حدد Create source وانسخ عنوان webhook URL. يُعرض مرة واحدة فقط.
إرسال القضايا عبر webhook
في وضع Hybrid أو Webhook only، اضبط New Relic لدفع قضاياها:
-
في New Relic، افتح Alerts › Destinations وأضف وجهة Webhook بالعنوان الذي عرضه Excubius. وإذا ضبطت webhook secret، فأضف الترويسة
Authorization: Bearer <secret>، أوX-Webhook-Secret: <secret>. -
أنشئ workflow يصفّي القضايا التي تريدها في Excubius ويُشعر تلك الوجهة بقالب الحمولة (payload) هذا:
يعمل قالب New Relic الافتراضي أيضًا.
-
أرسل الإشعار عند activated وclosed، حتى تُغلق التنبيهات في Excubius أيضًا.
الاختبار والمزامنة
- في صفحة المصدر، حدد Test. تُدرج كل قراءة مع نتيجتها: بيانات الاعتماد والحساب والجرد والتنبيهات.
- حدد Sync now لجلب الجرد والمقاييس والتنبيهات دون انتظار.
تظهر المضيفات موارد، تتم مطابقتها مع الخوادم نفسها من المصادر الأخرى. وتظهر خدمات APM موارد من النوع Application (APM)، والمراقبات موارد من النوع Synthetic monitor، مع فحوصها. وتظهر القضايا المفتوحة في Alert inbox، مع رابط إلى New Relic.
اختيار الوضع
| الوضع | ما تحصل عليه |
|---|---|
| Hybrid | القضايا فورًا عبر webhook؛ والجرد والمقاييس عبر الاستطلاع؛ ومصالحة تغلق ما أُغلق في New Relic أثناء فقدان webhook |
| Polling | كل شيء عبر الاستطلاع. وتظهر القضايا خلال فاصل التنبيهات، وهو 5 دقائق افتراضيًا |
| Webhook only | القضايا فقط، دون جرد أو مقاييس، ودون تخزين أي مفتاح |