📊 تثبيت VictoriaMetrics — قاعدة بيانات السلاسل الزمنية المتوافقة مع Prometheus على Docker

نشر VictoriaMetrics على Ubuntu باستخدام Docker — قاعدة بيانات السلاسل الزمنية (TSDB) فائقة السرعة والبديل المباشر والأخف لـ Prometheus مع دعم لغة MetricsQL ولوحات Grafana على المنفذ 8428.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر VictoriaMetrics على المنفذ 8428 مع التخزين الدائم للمقاييس ومستكشف VMUI واستقبال البيانات جاهزاً.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Monitoring/victoriametrics/victoriametrics-ubuntu.sh
chmod +x victoriametrics-ubuntu.sh
sudo bash victoriametrics-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Monitoring/victoriametrics/victoriametrics-ubuntu.sh

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

chmod +x victoriametrics-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للمقاييس (`./vm-data`) وضبط فترات الاحتفاظ وتشغيل VictoriaMetrics على المنفذ 8428.

sudo bash victoriametrics-ubuntu.sh

4 فحص الجاهزية وربط لوحات Grafana

افتح متصفحك على الرابط http://ip-سيرفرك:8428/vmui/ لفتح مستكشف الاستعلامات. وفي Grafana، أضف مصدر بيانات Prometheus برابط `http://ip-سيرفرك:8428` لبدء بناء ومراقبة لوحات التحكم الرسومية.

http://<your-server-ip>:8428

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

المنفذالغرض
8428HTTP API, Web UI & Remote Write

نظرة عامة

تعد VictoriaMetrics منصة مراقبة وقاعدة بيانات سلاسل زمنية (Time-Series Database) مفتوحة المصدر وفائقة السرعة والكفاءة وقابلة للتوسع الهائل. تعمل المنصة عبر المنفذ 8428 كبديل مباشر ومطابق تماماً لخوادم Prometheus وThanos وInfluxDB، وتستقبل تدفقات المقاييس عبر Prometheus `remote_write` وبروتوكولات InfluxDB وOpenTelemetry مع استهلاك ذاكرة RAM أقل بـ 7 أضعاف ومساحة قرص أقل بـ 5 أضعاف مقارنة بـ Prometheus التقليدي. وتدعم لغة الاستعلامات الممتدة MetricsQL مع واجهة ويب تفاعلية مدمجة في مسار `/vmui/`.

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

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

متى تحتاجه

  • تريد تخزيناً طويل الأمد لمقاييس Prometheus دون الدخول في تعقيدات معمارية Thanos أو Cortex
  • تحتاج إلى قاعدة بيانات سلاسل زمنية تستهلك ذاكرة RAM أقل بما يصل إلى 7 أضعاف مقارنة بـ Prometheus
  • تريد استقبال المقاييس من Prometheus عبر `remote_write` أو Telegraf أو OpenTelemetry أو Node Exporter
  • تحتاج لعرض لوحات Grafana الرسومية بسرعة فائقة حتى عند استعراض مقاييس شهور وسنوات ماضية
  • تبحث عن قاعدة مقاييس خفيفة مفتوحة المصدر قادرة على معالجة ملايين المقاييس بالثانية بسهولة

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

  • توجيه كافة مقاييس Prometheus عبر `remote_write` إلى مسار `http://ip-سيرفرك:8428/api/v1/write`
  • ربط لوحات Grafana مباشرة كـ Prometheus Data Source برابط `http://ip-سيرفرك:8428` لعرض الرسوم البيانية
  • الاحتفاظ بمقاييس استهلاك المعالج والرام والشبكة لسيرفراتك لمدة 12 شهراً بأقل مساحة قرص ممكنة
  • سحب المقاييس (Scraping) مباشرة عبر أداة `vmagent` المدمجة من خلال ملف إعدادات Prometheus
  • تنفيذ استعلامات رياضية وتحليلية متقدمة بلغة MetricsQL عبر واجهة VMUI الرسومية

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

  • محرك سلاسل زمنية فائق السرعة على المنفذ 8428: تنفيذ الاستعلامات التحليلية بسرعة تفوق Prometheus بـ 10 أضعاف
  • ضغط استثنائي لمساحة القرص: توفير مساحة التخزين بما يصل إلى 5 أضعاف مقارنة بقواعد الـ TSDB التقليدية
  • توافق كامل مع PromQL وMetricsQL: دعم فوري لكافة لوحات Grafana وقواعد التنبيهات الخاصة بـ Prometheus
  • دعم واسع لبروتوكولات الإدخال: استقبال مقاييس Prometheus `remote_write` وOpenTelemetry وInfluxDB وGraphite
  • مستكشف ويب تفاعلي (VMUI): محرر استعلامات MetricsQL ورسوم بيانية مدمجة في مسار `/vmui/`
  • إدارة تلقائية لمدد الاحتفاظ: ضبط سهل لسياسات تدوير المقاييس القديمة (مثل `-retentionPeriod=12m`)
  • استهلاك فائق الضآلة للموارد: ملف تنفيذي واحد بلغة Go بأقل استهلاك للمعالج والذاكرة
  • معمارية Docker Compose تجمع VictoriaMetrics مع ربط مجلد `./vm-data` لحفظ المقاييس على القرص

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8428/vmui/ لفتح مستكشف المقاييس
  • في ملف إعدادات Prometheus (`prometheus.yml`)، أضف رابط الإرسال: `remote_write: - url: "http://ip-سيرفرك:8428/api/v1/write"`
  • في Grafana: توجه إلى Connections ← Data Sources ← Add Prometheus، واكتب الرابط `http://ip-سيرفرك:8428`
  • استورد لوحات التحكم الجاهزة (مثل لوحة Node Exporter Full برقم #1860) لمراقبة السيرفر فورياً
  • ضع VictoriaMetrics خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع كلمة مرور
  • أعد سكريبت نسخ احتياطي دوري لمجلد المقاييس `./vm-data` باستخدام أداة `vmbackup`

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

  • تنبيه أمني حاسم: لا يحتوي VictoriaMetrics على نظام مصادقة مدمج؛ ضعه دائماً خلف وكيل عكسي محمي بكلمة مرور
  • لا تفتح منفذ الاستقبال 8428 للإنترنت العام مباشرة نهائياً
  • اقصر الاتصال بالمنفذ 8428 على سيرفرات Prometheus ولوحات Grafana وشبكة الإدارة الداخلية (`ufw allow 8428/tcp`)
  • احمِ مجلد البيانات `./vm-data` بصلاحيات نظام صارمة بالسيرفر (`chmod 700`)
  • استخدم تشفير TLS لحركة مرور `remote_write` عند نقل المقاييس عبر شبكات الإنترنت العامة
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الأداء

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

يعمل VictoriaMetrics عبر منفذ TCP 8428 (للواجهة البرمجية ومستكشف VMUI واستقبال `remote_write`). اسمح بالمنفذ 8428 للشبكة الداخلية الموثوقة لخوادم Prometheus ولوحات Grafana (`ufw allow 8428/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 مع كلمة مرور للمديرين.

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

  • انسخ مجلد `./vm-data` احتياطياً، والذي يحتوي على فهارس وكتل السلاسل الزمنية المضغوطة
  • استخدم أداة `vmbackup` المخصصة لأخذ لقطات حية دون إيقاف الخدمة: `vmbackup -storageDataPath=./vm-data -dst=fs:///backup/metrics`
  • احتفظ بنسخة من ملف `docker-compose.yml` وملفات إعدادات المراقبة
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية وتنفيذ استعلامات MetricsQL للتأكد من قراءة المقاييس

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

  • كشف المنفذ 8428 للإنترنت العام بدون كلمة مرور مما يتيح لأي زائر استعراض أو حذف مقاييس البنية التحتية
  • عدم ربط مجلد التخزين الدائم `./vm-data`، مما يسبب مسح كافة المقاييس التاريخية عند تحديث الحاوية
  • امتلاء مساحة القرص بسبب نسيان ضبط معامل مدة الاحتفاظ بالسجلات `-retentionPeriod` (مثل `-retentionPeriod=6m`)
  • سحب المقاييس بفواصل زمنية مفرطة (مثل ثانية واحدة) بدلاً من الفواصل القياسية (15 أو 30 ثانية)
  • إيقاف الحاوية بالقوة عبر `docker kill` بدلاً من الإيقاف السلس مما قد يترك أجزاء غير مضغوطة مؤقتاً

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

  • رفض الاتصال بالواجهة أو الـ API — تأكد من عمل الحاوية بالأمر `docker compose ps` وافحص السجلات: `docker logs victoriametrics -f`
  • Grafana يظهر خطأ في مصدر البيانات — تأكد من قدرة Grafana على الوصول لرابط `http://ip-سيرفرك:8428` وافحص `curl http://ip-سيرفرك:8428/health`
  • المقاييس لا تظهر في VMUI — راجع سجلات Prometheus للتأكد من نجاح إرسال `remote_write` وعدم وجود أخطاء شبكية
  • استهلاك مرتفع للذاكرة أثناء الاستعلامات المعقدة — حدد استهلاك الذاكرة عبر معامل `-search.maxMemoryPerQuery`
  • امتلاء مساحة القرص بالكامل — قلل مدة الاحتفاظ بالسجلات أو انقل النسخ القديمة للتخزين البارد عبر `vmbackup`

البدائل

خادم Prometheus القياسي من CNCF. منصة Thanos السحابية الموزعة. قاعدة بيانات InfluxDB للسلاسل الزمنية. منصة Grafana Mimir الموزعة. قاعدة TimescaleDB المبنية على PostgreSQL.

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

تجنب استخدام VictoriaMetrics إذا كنت تبحث عن منصة لتجميع سجلات النصوص والأخطاء (حيث صُممت VictoriaLogs أو Loki لسجلات النصوص؛ بينما صُممت VictoriaMetrics للأرقام والمقاييس). وإذا كنت تحتاج لعلاقات SQL وجداول وبيانات مالية، فإن PostgreSQL أو TimescaleDB هي الأنسب.

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

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

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

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

ما هو VictoriaMetrics وما الفرق بينه وبين Prometheus؟

تعد VictoriaMetrics قاعدة بيانات سلاسل زمنية فائقة السرعة متوافقة 100% مع استعلامات وواجهات Prometheus (PromQL)، لكنها تستهلك ذاكرة RAM أقل بـ 7 أضعاف، ومساحة قرص أقل بـ 5 أضعاف، وتنفذ الاستعلامات التاريخية بسرعة تفوق بروميثيوس بكثير.

ما هي لغة MetricsQL؟

تعد MetricsQL امتداداً محسناً للغة PromQL تم تطويرها بواسطة VictoriaMetrics. وتدعم كافة استعلامات PromQL القياسية بالإضافة لدوال تحليلية وحسابية متطورة لتسهيل بناء الرسوم البيانية.

كيف أقوم بربط VictoriaMetrics مع منصة Grafana؟

في Grafana، أضف مصدر بيانات جديد واختر نوع 'Prometheus'، واكتب الرابط `http://ip-سيرفرك:8428`. وستعمل كافة لوحات تحكم Prometheus الجاهزة فورياً وبدون أي تعديلات.

كيف تعمل سياسة الاحتفاظ بالبيانات في VictoriaMetrics؟

يتم ضبط مدة الاحتفاظ عبر معامل التشغيل `-retentionPeriod` (مثل `-retentionPeriod=12m` لـ 12 شهراً أو `-retentionPeriod=30d` لـ 30 يوماً). ويتم حذف البيانات الأقدم تلقائياً بالخلفية دون استهلاك موارد المعالج.

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

تتميز VictoriaMetrics بخفة استثنائية، حيث تستهلك عادة ما بين 150 إلى 500 ميجابايت فقط من الرام داخل Docker لبيئات الإنتاج المتوسطة التي تعالج عشرات الآلاف من المقاييس بالثانية.