ccfos/nightingaleمحرك تنبيه مفتوح المصدر لبيانات المراقبة الزمنية. يتصل بـ Prometheus وVictoriaMetrics وElasticSearch ومصادر بيانات أخرى. يدعم أكثر من 20 قناة إشعار، تقليل ضوضاء التنبيهات، التصعيد، وأتمتة الإصلاح الذاتي.
<p align="center">
<a href="https://github.com/ccfos/nightingale">
<img src="https://assets.kitploit.com/production/public/readmes/6912/478fc7d999847e20a15fb5b231650ebbb0d483edba4ce0b313091fac474416f2.png" alt="Nightingale" width="100" />
</a>
</p>
<p align="center">
<b>تنبيهات مفتوحة المصدر لحزمة الأدوات التي تستخدمها بالفعل</b>
</p>
<p align="center">
<a href="https://github.com/ccfos/nightingale/releases"><img alt="Latest release" src="https://img.shields.io/github/v/release/ccfos/nightingale" /></a>
<a href="https://github.com/ccfos/nightingale/blob/main/LICENSE"><img alt="Apache-2.0 license" src="https://img.shields.io/badge/license-Apache--2.0-blue" /></a>
<a href="https://github.com/ccfos/nightingale/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/ccfos/nightingale" /></a>
<a href="https://hub.docker.com/r/flashcatcloud/nightingale"><img alt="Docker pulls" src="https://img.shields.io/docker/pulls/flashcatcloud/nightingale" /></a>
<a href="https://join.slack.com/t/n9e/shared_invite/zt-480klxytf-P9qm3C1M87kDmRPp_H30Kw"><img alt="Join the Nightingale Slack community" src="https://img.shields.io/badge/Slack-join%20the%20community-brightgreen" /></a>
</p>
<p align="center">
<a href="#quick-start">البدء السريع</a> ·
<a href="https://n9e.github.io/docs">التوثيق</a> ·
<a href="https://n9e.github.io/download">التنزيل</a> ·
<a href="https://github.com/ccfos/nightingale/releases">الإصدارات</a> ·
<a href="#community">المجتمع</a>
</p>
[English](https://github.com/ccfos/nightingale/blob/main/README.md) | [中文](https://github.com/ccfos/nightingale/blob/main/README_zh.md)
يجمع Nightingale قواعد التنبيه ومعالجة الأحداث وتوجيه الإشعارات في مكان واحد. اربط Prometheus وVictoriaMetrics وElasticsearch وLoki وClickHouse وغيرها من مصادر البيانات التي تشغّلها بالفعل، ثم أوصل التنبيهات إلى Slack وPagerDuty والأدوات التي يستخدمها فريقك بالفعل.
**استضافة ذاتية · Apache-2.0 · وكيل ذكاء اصطناعي مدمج · خادم MCP**
## لماذا Nightingale؟
- **امنح الفرق ملكية تنبيهاتها.** نظّم القواعد في مجموعات أعمال، وخصّص أذونات الفرق، وأدِر القواعد وإعدادات الإشعارات عبر واجهة المستخدم وواجهة API.
- **اجمع التنبيهات المتناثرة في مكان واحد.** قيّم القواعد مقابل مصادر بيانات المقاييس والسجلات وSQL مع الاحتفاظ بجامعاتك ومخازنك ولوحات Grafana الحالية.
- **افهم ما حدث للتنبيه.** افحص سجلات تقييم القواعد والأحداث التاريخية ونتائج الإشعارات لتتبّع الاستعلام حتى وصول الإشعار.
## البدء السريع
بعد تثبيت Git وDocker Compose، شغّل حزمة التقييم المرفقة:
```bash
git clone https://github.com/ccfos/nightingale.git
cd nightingale/docker/compose-bridge
docker compose up -d
```
يبدأ هذا Nightingale وMySQL وRedis وVictoriaMetrics وCategraf. افتح [http://localhost:17000](http://localhost:17000) وسجّل الدخول باستخدام **`root` / `root.2020`**.
للحصول على أول تنبيه لديك:
1. **اربط مصدر بيانات.** أضف نقطة النهاية المتوافقة مع Prometheus الموجودة لديك، أو استخدم `http://victoriametrics:8428` لنسخة VictoriaMetrics في حزمة Compose هذه.
2. **أنشئ قاعدة تنبيه.** اختر مجموعة أعمال ومصدر بيانات، ثم أدخل تعبير PromQL. لاختبار يُطلق دائمًا، استخدم `vector(1) > 0` واضبط المدة على `0`.
3. **اضبط التسليم.** أعدّ قناة إشعارات، وأنشئ قاعدة إشعارات، وأرفقها بقاعدة التنبيه. تحقق من وصول إشعار الاختبار، ثم عطّل تنبيه الاختبار.
تستخدم حزمة Compose بيانات اعتماد تجريبية وتكشف منافذ الخدمات للتقييم المحلي. غيّر بيانات الاعتماد وراجع الوصول إلى الشبكة قبل النشر على مضيف مشترك أو عام. راجع [خيارات النشر](#deployment) لطرق أخرى لتشغيل Nightingale.
## كيف يتناسب مع بنيتك التقنية
يستعلم Nightingale من مصادر بياناتك، ويقيّم شروط التنبيه، ويعالج الأحداث، ويوجّه الإشعارات. تبقى بياناتك الحالية في مخازنها الحالية.
أبقِ Grafana للتصور ومنصة on-call الخاصة بك للجدولة والتصعيد والاستجابة للحوادث. يتضمن Nightingale أيضًا لوحات معلومات للفرق التي ترغب في استكشاف البيانات إلى جانب تنبيهاتها.
هل تبدأ بدون حزمة مراقبة؟ يتضمن الإعداد المستقل قاعدة بيانات سلاسل زمنية (TSDB) مدمجة اختيارية للنشرات الصغيرة أحادية النسخة. [Categraf](https://github.com/flashcatcloud/categraf) هو جامع اختياري للمضيفين والبرمجيات الوسيطة وقواعد البيانات وأجهزة الشبكة.
## القدرات الرئيسية
| القدرة | ما يمكنك فعله |
| --- | --- |
| التنبيه عبر مصادر البيانات | استخدم PromQL أو استعلامات السجلات أو SQL لتعريف الشروط. طبّق قاعدة على نسخ متعددة من نفس نوع مصدر البيانات. |
| ملكية الفريق | جمّع القواعد ولوحات المعلومات حسب مجموعة الأعمال، وعيّن أذونات الفريق، واربط OIDC أو OAuth2 أو LDAP أو CAS لتسجيل الدخول. |
| معالجة الأحداث وتوجيهها | كتم الإشعارات، والاشتراك في التنبيهات، وإثراء التسميات أو إعادة كتابتها، وتوجيه الأحداث عبر مسارات شرطية. |
| سجلات تنفيذ التنبيهات | راجع استعلامات التقييم ونتائجها، والأحداث النشطة والتاريخية، وسجلات تسليم الإشعارات. |
| تكاملات قابلة لإعادة الاستخدام | ابدأ بإعدادات الجامع المرفقة وقواعد التنبيه ولوحات المعلومات. راجع الاستعلامات والحدود الدنيا لبيئتك قبل تمكينها. |
| التقييم الموزع | وزّع القواعد عبر محركات التنبيه واستخدم `n9e-edge` لتقييم التنبيهات بالقرب من مصادر البيانات البعيدة. |
تشمل تكاملات الإشعارات **Slack وPagerDuty وDiscord وEmail وTelegram وMattermost وJira وJira Service Management**، مع خطافات HTTP webhooks ونصوص برمجية للوجهات المخصصة. راجع [مرجع قنوات الإشعارات الأصلية](https://github.com/ccfos/nightingale/blob/main/doc/api/notify-channel-native.md) للحصول على تفاصيل الإعداد.
للاستجابات الآلية، اربط [ibex](https://github.com/flashcatcloud/ibex) لتشغيل نصوص المعالجة المعرّفة مسبقًا عند إطلاق تنبيه.
<a id="-mcp-server"></a>
<a id="ai-assistant-and-mcp"></a>
## وكيل الذكاء الاصطناعي المدمج
يتضمن Nightingale وكيل ذكاء اصطناعي يمكنك استخدامه مباشرة في واجهة الويب. يعمل الوكيل داخل Nightingale، ويستدعي الأدوات لفحص بيانات المراقبة والإعدادات لديك، وينجز المهام عبر خطوات متعددة.
- **تحقّق من التنبيهات.** استعلم عن المقاييس والسجلات ذات الصلة، وافحص المضيفين المتأثرين، واشرح النتائج باستخدام البيانات التي يسترجعها.
- **استكشف مشكلات عملية التنبيه.** افحص القواعد وسجلات التقييم وإعدادات كتم التنبيهات ومعالجة الأحداث ونتائج الإشعارات لمعرفة سبب عدم إطلاق التنبيه أو عدم وصوله إلى وجهته.
- **أنشئ التكوين وحدّثه.** ابنِ قواعد التنبيه ولوحات المعلومات، وأنشئ استعلامات PromQL وSQL، واضبط قواعد الإشعارات وإعدادات كتم التنبيهات والاشتراكات عبر المحادثة. تعرض الأدوات المدمجة لتحديث قواعد التنبيه ولوحات المعلومات الموجودة التغييرات المقترحة لتأكيدها.
- **وسّعه باستخدام المهارات (Skills).** تغطي المهارات المرفقة سير عمل المراقبة الشائعة. أضف إجراءات فريقك والمواد المرجعية والسكربتات كمهارات مخصصة، بما في ذلك المهارات المستوردة من Git.
على سبيل المثال:
> لماذا أُطلق هذا التنبيه؟ افحص مقاييس المضيف المتأثر وسجلاته حول وقت الإطلاق.
> أنشئ تنبيهًا لاستخدام الذاكرة لمضيفي الإنتاج وأبلغ فريقنا عبر Slack.
اضبط نقطة نهاية لنموذج للبدء. يدعم الوكيل واجهات برمجة التطبيقات المتوافقة مع OpenAI وClaude وGemini والنماذج المستضافة ذاتيًا المتوافقة. أنت تختار خدمة النموذج وبيانات الاعتماد؛ ويعمل التنبيه الأساسي بشكل مستقل عن الوكيل.
[تكوين مزوّد النموذج](https://github.com/ccfos/nightingale/blob/main/doc/api/ai-llm-config.md) · [إدارة المهارات](https://github.com/ccfos/nightingale/blob/main/doc/api/ai-skill.md) · [المهارات المرفقة](https://github.com/ccfos/nightingale/blob/main/aiagent/skill/embedded/builtin)
### ربط الوكلاء الخارجيين
- يتيح **MCP** للمساعدين الخارجيين استدعاء أدوات Nightingale. يعمل الخادم داخل Nightingale على المسار `/mcp`، ويكشف أدوات القراءة افتراضيًا، ويطبّق أذونات واجهة برمجة التطبيقات الحالية للمستدعي. تتطلب أدوات الكتابة تكوينًا صريحًا. راجع [إعداد MCP](https://github.com/ccfos/nightingale/blob/main/doc/api/mcp-server.md).
- يتيح **A2A** لوكيل آخر تفويض مهمة إلى الوكيل المدمج في Nightingale. راجع [تكامل A2A](https://github.com/ccfos/nightingale/blob/main/doc/api/a2a-integration.md).
## لقطات شاشة المنتج
إدارة قواعد التنبيه حسب مصدر البيانات ومجموعة الأعمال:
## النشر
| الخيار | ابدأ من هنا |
| --- | --- |
| التقييم المحلي باستخدام Docker Compose | [حزمة Compose المرفقة](https://github.com/ccfos/nightingale/blob/main/docker/compose-bridge/docker-compose.yaml) |
| حِزم Linux الثنائية لمعماريتي amd64 وarm64 | [تنزيلات الإصدارات](https://github.com/ccfos/nightingale/releases) و[مرجع التكوين](https://github.com/ccfos/nightingale/blob/main/etc/config.toml) |
| Kubernetes | [مخطط Helm وتعليمات التثبيت](https://github.com/flashcatcloud/n9e-helm) |
في بيئة الإنتاج، ثبّت إصدارًا محددًا، واضبط بيانات الاعتماد وTLS، وانسخ قاعدة بيانات البيانات الوصفية احتياطيًا، وراقب حالات فشل تقييم القواعد والإشعارات. تشترك عدة نسخ من Nightingale في قاعدة بيانات البيانات الوصفية وRedis؛ استخدم تخزينًا خارجيًا للسلاسل الزمنية في عمليات النشر متعددة النسخ. يخزّن TSDB المدمج البيانات على القرص المحلي لنسخة واحدة.
راجع [التوثيق](https://n9e.github.io/docs)، و[دليل التثبيت](https://n9e.github.io/docs/install/overview)، و[ملاحظات الإصدار](https://github.com/ccfos/nightingale/releases)، و[سياسة الأمان](https://github.com/ccfos/nightingale/blob/main/SECURITY.md) للحصول على مزيد من الإرشادات والإصدارات المدعومة.
## الأسئلة الشائعة
**هل أحتاج إلى استبدال أدوات الجمع لديّ أو نقل بيانات المراقبة الخاصة بي؟**
لا. يمكن لـ Nightingale الاستعلام مباشرةً من مصادر البيانات الموجودة لديك. احتفظ بأدوات التصدير والجمع لديك. تتوفر Categraf وTSDB المدمج عندما تحتاج إلى الجمع أو التخزين المحلي.
**هل يمكنني استيراد قواعد تنبيه Prometheus الموجودة؟**
نعم. يدعم استيراد القواعد ملفات Prometheus YAML، بما في ذلك التعبيرات والمدد والتسميات والتعليقات التوضيحية. راجع القواعد المحوّلة وأعد بناء توجيه الإشعارات في Nightingale. الاستيراد ليس تحويلًا كاملًا لملف `alertmanager.yml`؛ شغّل كلا النظامين أثناء التقييم قبل نقل الإشعارات.
**هل يمكنني إدارة القواعد عبر Git وCI؟**
يمكن تصدير القواعد بصيغة JSON وإنشاؤها أو تحديثها عبر واجهة برمجة التطبيقات HTTP، بحيث يمكنك بناء سير عمل حول تكوين مُدار بنظام التحكم في الإصدارات. لا يوفر Nightingale حاليًا سجل مراجعات مدمجًا للقواعد أو إمكانية الرجوع إلى مراجعات سابقة.
**هل الذكاء الاصطناعي مطلوب، وإلى أين تذهب طلبات النموذج؟**
يعمل التنبيه دون الحاجة إلى الذكاء الاصطناعي. يرسل المساعد المدمج المطالبات والبيانات التي يستخدمها إلى نقطة نهاية النموذج التي قمت بتكوينها؛ ويمكنك استخدام نموذج مستضاف في شبكتك الخاصة. تستخدم عملاء MCP الخارجيون إعدادات النموذج الخاصة بهم. وتُدار بيانات اعتماد خدمة النموذج وتكاليف الاستخدام بواسطتك أنت.
**هل يوفر Nightingale جدولة المناوبات وتصعيدها؟**
اربط منصة مناوبات مثل PagerDuty للجداول وسياسات التصعيد والاستجابة للحوادث. يتولى Nightingale تقييم القواعد ومعالجة الأحداث وتوجيه الإشعارات.
## المجتمع
نرحب بالأسئلة وتقارير الأخطاء وتحسينات التوثيق والمساهمات باللغة الإنجليزية.
- [GitHub Discussions](https://github.com/ccfos/nightingale/discussions) — اطرح الأسئلة وشارك الأفكار.
- [GitHub Issues](https://github.com/ccfos/nightingale/issues) — أبلغ عن الأخطاء واطلب الميزات. أدرج الإصدار وطريقة النشر وخطوات إعادة إنتاج المشكلة.
- [Slack](https://join.slack.com/t/n9e/shared_invite/zt-480klxytf-P9qm3C1M87kDmRPp_H30Kw) — انضم إلى المجتمع.
- [تقارير المتبنين](https://github.com/ccfos/nightingale/issues/897) — اطّلع على كيفية استخدام الآخرين لـ Nightingale وشارك تجربتك الخاصة.
- [سياسة الأمان](https://github.com/ccfos/nightingale/blob/main/SECURITY.md) — أبلغ عن الثغرات بشكل خاص وتحقق من دعم الإصدارات.
بالنسبة للتغييرات الجوهرية، افتح issue لمناقشة النهج قبل إرسال pull request. يُرجى اتباع [مدونة قواعد السلوك](https://github.com/ccfos/nightingale/blob/main/CODE_OF_CONDUCT.md).
طُوّر Nightingale في الأصل في DiDi وتم التبرع به إلى CCF ODC في عام 2022. تعرّف على [حوكمة المشروع](https://github.com/ccfos/nightingale/blob/main/doc/community-governance.md)، و[المساهمين المعتمدين](https://github.com/ccfos/nightingale/blob/main/doc/committers.md)، و[المساهمين](https://github.com/ccfos/nightingale/graphs/contributors).
<a href="https://github.com/ccfos/nightingale/graphs/contributors">
<img alt="Nightingale contributors" src="https://contrib.rocks/image?repo=ccfos/nightingale" />
</a>
## المتابعون عبر الزمن
[](https://star-history.dera.page/#ccfos/nightingale&Date)
## الترخيص
يتوفر Nightingale بموجب [Apache License 2.0](https://github.com/ccfos/nightingale/blob/main/LICENSE).
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=3f539666-22f5-468d-914d-1e344945d3d8" alt="" />
