🎁 تثبيت حزمة المراقبة — Prometheus وGrafana وcAdvisor وNode Exporter على Docker

نشر حزمة مراقبة متكاملة وجاهزة للعمل على Ubuntu عبر Docker — تشمل Prometheus وGrafana وnode-exporter وcAdvisor مع ربط مصدر البيانات ولوحة تحكم تلقائياً لتظهر الرسوم البيانية فور تسجيل الدخول الأول.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

مثبت حزمة مؤتمت — أمر واحد ينشر Prometheus وGrafana وnode-exporter وcAdvisor مربوطة بالكامل مسبقاً. سجل الدخول وستجد لوحة Host Overview تعرض المقاييس المباشرة فوراً.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/stacks/monitoring-stack/monitoring-stack-ubuntu.sh
chmod +x monitoring-stack-ubuntu.sh
./monitoring-stack-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/stacks/monitoring-stack/monitoring-stack-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x monitoring-stack-ubuntu.sh

3 تشغيل المثبت

./monitoring-stack-ubuntu.sh

4 تسجيل الدخول إلى Grafana

http://your-server-ip:3000

المنافذ المستخدمة

المنفذالغرض
3000Grafana — dashboards (generated admin password)
9090Prometheus — metrics database (no auth; keep internal)

نظرة عامة

حزمة المراقبة (Monitoring Stack) هي بيئة رصد وتحليل أداء متكاملة ومجهزة للإنتاج، تهدف لتوفير رؤية شاملة لمقاييس السيرفر المضيف واستهلاك موارد حاويات Docker. بدلاً من تثبيت كل أداة وضبط تكاملها يدوياً، تجمع هذه الحزمة أربعة مكونات قياسية في شبكة Docker Compose واحدة: Prometheus (محرك جمع وتخزين المقاييس الزمنية)، وGrafana (منصة الرسوم البيانية ولوحات التحكم على المنفذ 3000)، وNode Exporter (جامع مقاييس العتاد ونظام التشغيل المضيف)، وcAdvisor (مراقب أداء الحاويات واستهلاكها). يقوم التثبيت بتهيئة Prometheus تلقائياً كمصدر بيانات افتراضي في Grafana إلى جانب استيراد لوحة تحكم Host Overview جاهزة، لتبدأ الرسوم البيانية بالعمل فور تسجيل دخولك.

لماذا تستخدمه

تشغيل الحاويات والخدمات دون مراقبة مستمرة يخلق نقطة عمياء خطيرة في إدارة البنية التحتية. عندما يحدث ارتفاع مفاجئ في استهلاك المعالج أو تسريب في الذاكرة أو نفاد في مساحة التخزين، يكون استكشاف الخطأ بعد تعطل السيرفر صعباً ومكلفاً. تحل هذه الحزمة هذه المعضلة من خلال الجمع المستمر لمقاييس الأداء الدقيقة للمضيف (المعالج، الذاكرة، عمليات الإدخال والإخراج للقرص، وحركة مرور الشبكة) ومقاييس الحاويات المنفردة. وبفضل إمكانيات Grafana، تحصل على لوحات تحكم مرئية وتنبيهات فورية تتيح لك اكتشاف المشكلات قبل تحولها إلى انقطاع في الخدمة.

متى تحتاجه

  • تستضيف عدة حاويات Docker أو خدمات ويب على سيرفر Ubuntu وتحتاج إلى رؤية مركزية لمقاييس استهلاك الموارد
  • تواجه بطئاً غير مبرر في السيرفر أو حالات نفاد الذاكرة (OOM) أو ارتفاعات مفاجئة في المعالج وتحتاج إلى بيانات تاريخية للتشخيص
  • تريد حلاً شاملاً للمراقبة مجهزاً مسبقاً بـ Prometheus وGrafana وNode Exporter وcAdvisor دون الحاجة للربط اليدوي
  • تحتاج إلى تتبع نمو استهلاك التخزين وحركة مرور الشبكة عبر الحاويات مع مرور الوقت
  • ترغب في إعداد تنبيهات تلقائية عبر Telegram أو Discord أو Slack أو البريد الإلكتروني عند تجاوز حدود الأداء الحرجة

من يحتاجه

  • مديرو الأنظمة ومسؤولو السيرفرات السحابية والخاصة الذين يحتاجون إلى قياس أداء مستمر وموثوق للبنية التحتية
  • مهندسو DevOps الذين يديرون خدمات مصغرة وحاويات Docker متعددة
  • هواة الاستضافة الذاتية وأصحاب السيرفرات المنزلية الذين يشغلون خدمات الوسائط وقواعد البيانات على جهاز واحد
  • فرق التطوير والشركات التي تبحث عن نظام مراقبة داخلي يحترم الخصوصية دون تكاليف اشتراكات SaaS الخارجية
  • المسؤولون التقنيون الذين يحتاجون إلى تقارير أداء تاريخية واضحة لتخطيط السعة والترقيات المستقبلية

حالات الاستخدام الشائعة

  • مراقبة صحة عتاد السيرفر بما في ذلك درجات الحرارة ومتوسط الحمل واستهلاك الذاكرة ومساحة الأقراص المثبتة
  • تتبع حدود واستهلاك الذاكرة والمعالج لكل حاوية Docker لاكتشاف الحاويات التي تسبب تسريباً في الموارد وتعديل حدودها
  • تحليل استهلاك النطاق الترددي للشبكة ورصد طفرات الحركة عبر جسور Docker والواجهات الخارجية
  • إعداد تنبيهات آلية عبر Grafana Alerting لإشعار الفريق عبر Discord أو Slack أو البريد عند وصول القرص إلى 90%
  • تخطيط سعة العتاد من خلال استعراض بيانات الأداء التاريخية على مدار أسابيع وشهور لمعرفة متى يلزم ترقية الموارد

الميزات الرئيسية

  • أربعة مكونات مراقبة مدمجة مسبقاً: Prometheus وGrafana وNode Exporter وGoogle cAdvisor
  • تهيئة آلية لمصدر بيانات Prometheus داخل Grafana دون أي خطوات ربط يدوية
  • لوحة تحكم Host Overview جاهزة مسبقاً برسوم بيانية فورية للمعالج والذاكرة والتخزين والشبكة
  • مراقبة دقيقة لكل حاوية عبر cAdvisor لحساب استهلاك الذاكرة النشطة وخنق المعالج ومقاييس I/O
  • جمع مقاييس نظام التشغيل المضيف عبر Node Exporter مع قراءة مباشرة لملفات النظام وإحصائيات الحمل
  • واجهة ويب Grafana على المنفذ 3000 تدعم تخصيص اللوحات وإدارة المستخدمين وقنوات التنبيه
  • قاعدة بيانات السلاسل الزمنية Prometheus على المنفذ 9090 مع دعم استعلامات PromQL وضغط بيانات فعال
  • سياسات إعادة تشغيل Docker لضمان استمرارية الحزمة بالكامل وعودتها للعمل تلقائياً بعد إعادة تشغيل السيرفر

كيفية الاستخدام بعد التثبيت

  • افتح واجهة Grafana في المتصفح عبر http://ip-سيرفرك:3000 باستخدام بيانات الاعتماد التي تم إنشاؤها أثناء التثبيت
  • غيّر كلمة مرور المشرف الافتراضية فوراً من إعدادات الملف الشخصي أسفل يسار الشاشة
  • افتح لوحة تحكم Host Overview للتأكد من تدفق المقاييس بنجاح من Node Exporter وcAdvisor
  • يمكنك استكشاف Prometheus مباشرة عبر http://ip-سيرفرك:9090 لتنفيذ استعلامات PromQL والتحقق من صحة أهداف الجمع
  • اضبط قنوات التنبيه في Grafana (من قسم Alerting → Contact Points) لربط إشعارات Telegram أو Discord أو البريد
  • ضع Grafana خلف وكيل عكسي آمن (مثل Nginx Proxy Manager أو Caddy) مع شهادة SSL لاستخدام نطاق مشفر

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

  • غيّر كلمة مرور حساب المشرف في Grafana فور تسجيل الدخول الأول لمنع الوصول غير المصرح به للوحات التحكم
  • أبقِ منفذ Prometheus 9090 محصوراً في الشبكة المحلية أو شبكة Docker — حيث لا يوفر Prometheus مصادقة مدمجة افتراضياً
  • لا تكشف Node Exporter (المنفذ 9100) أو cAdvisor (المنفذ 8080) للإنترنت العام وأبقهما معزولين داخل شبكة Docker
  • استخدم بروتوكول HTTPS عبر وكيل عكسي مع شهادات Let's Encrypt قبل إتاحة Grafana (المنفذ 3000) عبر الإنترنت
  • طبق صلاحيات الوصول المناسبة (Viewer مقابل Editor مقابل Admin) في Grafana عند منح الوصول لأعضاء الفريق
  • حدّث صور حاويات Docker بانتظام لتطبيق التحديثات والترقيعات الأمنية الدورية

المنافذ وإعدادات جدار الحماية

تتيح حزمة المراقبة واجهة Grafana عبر منفذ TCP 3000 للوصول إلى لوحات التحكم، بينما يستمع Prometheus على منفذ TCP 9090. في بيئة الإنتاج، يجب أن يكون المنفذ 3000 (أو منفذ HTTPS 443 عبر الوكيل العكسي) هو المتاح فقط للمستخدمين. ونظراً لأن Prometheus لا يحتوي على مصادقة مستخدمين في إعداده الافتراضي، يجب حظر المنفذ 9090 عن الإنترنت العام وقصره على الوصول الداخلي. تتواصل مكونات Node Exporter وcAdvisor عبر شبكة Docker الداخلية (`mon-net`) ولا تتطلب فتح أي منافذ خارجية في جدار الحماية.

النسخ الاحتياطي والصيانة

  • انسخ مجلد بيانات Grafana (./grafana-data) احتياطياً، حيث يحتوي على حسابات المستخدمين واللوحات المخصصة وقواعد التنبيه
  • انسخ مجلد بيانات Prometheus (./prometheus-data) احتياطياً إذا كنت بحاجة للحفاظ على السجلات التاريخية طويلة المدى
  • احتفظ بنسخة من ملفات الإعداد بما فيها prometheus.yml وملفات تهيئة مصادر البيانات واللوحات
  • استخدم أدوات النسخ الاحتياطي التلقائي مثل restic أو rsync لأخذ نسخ دورية من مجلد الحزمة (/root/docker/monitoring-stack)
  • اختبر استعادة النسخة الاحتياطية في بيئة تجريبية للتأكد من عمل لوحات التحكم واسترجاع الإعدادات بنجاح

الأخطاء الشائعة

  • فتح منفذ Prometheus 9090 للإنترنت العام دون مصادقة، مما يتيح لأي شخص الاطلاع على مقاييس السيرفر وتفاصيل بنيته
  • ترك بيانات اعتماد Grafana الافتراضية دون تغيير على السيرفرات المتصلة بالإنترنت
  • تشغيل cAdvisor دون المجلدات المثبتة المطلوبة أو بدون وضع privileged، مما يؤدي إلى فقدان إحصائيات الحاويات
  • نسيان تثبيت مجلدات التخزين الدائمة لـ Prometheus وGrafana، مما يسبب فقدان البيانات واللوحات عند إعادة تشغيل الحاوية
  • تحديد فترات احتفاظ طويلة للبيانات في Prometheus على أقراص صغيرة دون ضبط حد تخزين مناسب (--storage.tsdb.retention.time)

استكشاف الأخطاء وإصلاحها

  • لوحات Grafana تظهر 'No data' — تأكد من تشغيل Prometheus (docker ps) وإمكانية الوصول إليه من Grafana عبر http://mon-prometheus:9090
  • أهداف Prometheus متوقفة (Down) — افتح http://ip-سيرفرك:9090/targets وافحص رسائل الخطأ الخاصة بـ node-exporter أو cadvisor
  • فشل بدء حاوية cAdvisor — تحقق من ربط مسارات Docker daemon socket وملفات النظام rootfs ومنح الحاوية الصلاحيات اللازمة
  • استهلاك مفرط لمساحة القرص — افحص مجلد ./prometheus-data وعدل معايير فترة الاحتفاظ بالبيانات في docker-compose.yml
  • فشل تسجيل الدخول إلى Grafana — أعد تعيين كلمة مرور المشرف عبر الطرفية: docker exec -it mon-grafana grafana-cli admin reset-admin-password <كلمة_المرور_الجديدة>

البدائل

تطبيق Netdata هو بديل سريع يقدم مراقبة فورية بدقة ثانية واحدة مع إعداد تلقائي بالكامل، لكنه أقل مرونة في تخصيص اللوحات طويلة الأمد. نظاما Zabbix وNagios هما حلول مراقبة تقليدية للشركات تدعم بروتوكول SNMP ومراقبة الوكلاء، لكن إعدادهما أكثر تعقيداً. VictoriaMetrics هو بديل متوافق تماماً مع Prometheus ومحسن لتقليل استهلاك الذاكرة وتخزين المقاييس الضخمة. منصات Datadog وNew Relic هي حلول سحابية تجارية تقدم مراقبة شاملة ولكن باشتراكات دورية مرتفعة.

متى لا تستخدمه

تجنب تشغيل حزمة المراقبة الكاملة على سيرفرات ذات موارد شديدة المحدودية (أقل من 1 جيجابايت RAM)، حيث تستهلك الحزمة مجتمعة حوالي 500-800 ميجابايت من الذاكرة. لمراقبة سيرفر منفرد خفيف، قد تكون أدوات مثل Glances أو Netdata أو Uptime Kuma خياراً أكثر ملاءمة. إذا كانت مؤسستك تمتلك بالفعل خادم مراقبة مركزي ضخم (مثل VictoriaMetrics أو Datadog)، يكفي تثبيت المصدرات (Exporters) محلياً وإرسال البيانات للخادم المركزي بدلاً من تشغيل Grafana/Prometheus كاملين محلياً.

هل تحتاج مساعدة احترافية؟

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

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

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

ما هي المكونات المتضمنة في حزمة المراقبة هذه؟

تتضمن الحزمة أربعة برامج: Prometheus لجمع وتخزين المقاييس الزمنية، وGrafana لإنشاء لوحات التحكم والتنبيهات، وNode Exporter لمقاييس عتاد ونظام المضيف، وcAdvisor لمراقبة استهلاك حاويات Docker.

لماذا يجب إبقاء منفذ Prometheus 9090 داخلياً؟

لا يوفر Prometheus نظام مصادقة وتسجيل دخول للمستخدمين بشكل افتراضي. كشف المنفذ 9090 يتيح للعامة فحص مقاييس السيرفر ومعرفة الخدمات الداخلية، لذلك يجب الوصول إليه عبر Grafana فقط أو من وراء وكيل عكسي محمي.

كم تستهلك حزمة المراقبة من الذاكرة العشوائية (RAM)؟

في الاستخدام العادي للسيرفرات الصغيرة والمتوسطة، تستهلك الحاويات الأربع معاً ما بين 400 إلى 800 ميجابايت من الذاكرة. يزداد استهلاك Prometheus مع زيادة عدد الأهداف المجمعة وحجم الاستعلامات.

كيف يمكنني إضافة سيرفرات أخرى للمراقبة عبر نفس خادم Prometheus؟

قم بتثبيت Node Exporter على السيرفرات البعيدة، ثم أضف عناوين IP الخاصة بها والمنفذ 9100 ضمن قسم scrape_configs في ملف prometheus.yml على الخادم الرئيسي، ثم أعد تحميل إعدادات Prometheus لبدء سحب المقاييس.

هل يمكنني إرسال التنبيهات إلى Telegram أو Discord؟

نعم. من خلال واجهة Grafana، انتقل إلى قسم Alerting → Contact Points، حيث يمكنك إضافة روابط Webhook لـ Discord أو روبوتات Telegram أو Slack أو البريد الإلكتروني، وضبط شروط التنبيه التلقائي.