🪵 تثبيت VictoriaLogs — قاعدة بيانات تحليل السجلات فائقة الكفاءة على Docker
نشر VictoriaLogs على Ubuntu باستخدام Docker — محرك إدارة وتحليل سجلات السيرفرات والتطبيقات فائق الكفاءة والبديل الأخف لـ Elasticsearch وLoki على المنفذ 9428.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/monitoring/victorialogs/victorialogs-ubuntu.sh
chmod +x victorialogs-ubuntu.sh
./victorialogs-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/monitoring/victorialogs/victorialogs-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x victorialogs-ubuntu.sh
3 تشغيل المثبت
./victorialogs-ubuntu.sh
4 استكشاف السجلات واستقبال البيانات
http://your-server-ip:9428/select/vmui/
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 9428 | VictoriaLogs ingestion API and query UI at /select/vmui/ |
نظرة عامة
تعد VictoriaLogs قاعدة بيانات لإدارة وتحليل سجلات النظام والتطبيقات (Log Management & Analytics Database) مفتوحة المصدر وفائقة الكفاءة تم تطويرها من قبل فريق VictoriaMetrics. تعمل المنصة عبر المنفذ 9428 وتستقبل تدفقات السجلات من أدوات Vector وFluentbit وPromtail وLogstash، وتتميز باستهلاك ذاكرة RAM أقل بما يصل إلى 30 ضعفاً، وضغط للبيانات على القرص أعلى بـ 15 ضعفاً مقارنة بـ Elasticsearch وGrafana Loki. مع لغة الاستعلامات السلسة LogsQL وواجهة VMUI الرسومية المدمجة في مسار `/select/vmui/`.
لماذا تستخدمه
تتطلب منظومات إدارة السجلات التقليدية مثل حزمة ELK (Elasticsearch وLogstash وKibana) أو Grafana Loki خوادم ضخمة واستهلاكاً هائلاً لذاكرة الرام وإعدادات معقدة لتدوير الفهارس. تأتي VictoriaLogs كملف تنفيذي واحد بلغة Go داخل Docker يستقبل ملايين أسطر السجلات في الثانية بأقل استهلاك ممكن للمعالج والذاكرة، مع ضغط خيالي للبيانات على القرص ودون أي تعقيدات صيانة على سيرفرك الخاص.
متى تحتاجه
- تحتاج إلى نظام مركزي لتجميع السجلات دون استهلاك جيجابايتات من الذاكرة كما تفعل Elasticsearch
- تريد جمع وتحليل سجلات حاويات Docker، وأحداث systemd، وسجلات خوادم Nginx وتطبيقاتك البرمجية
- تريد توفير مساحات التخزين بفضل الضغط الفائق للاحتفاظ بسجلات شهور طويلة دون امتلاء القرص
- تبحث عن واجهة مستكشف ويب سهلة (VMUI) ولغة استعلام قوية (LogsQL) للبحث في السجلات المهيكلة والنصية
- تريد قاعدة سجلات مفتوحة المصدر تعمل بسلاسة على جهاز منزلي صغير أو خوادم سحابية عملاقة
من يحتاجه
- مهندسو الـ DevOps والـ SRE لتجميع سجلات خوادم الإنتاج وحاويات Docker مركزياً
- مديرو الأنظمة لاستكشاف أخطاء خوادم الويب (Nginx 5xx) وأعطال النظام وسجلات المصادقة
- مهندسو الأمان السيبراني للبحث في سجلات محاولات تسجيل الدخول بـ SSH وهجمات الـ Brute Force
- المطورون لتتبع الاستثناءات وأخطاء البرمجيات وسجلات التتبع في الخدمات المصغرة الموزعة
- أصحاب السيرفرات المنزلية للحصول على لوحة مراقبة سجلات سريعة وخفيفة على عتاد متواضع
حالات الاستخدام الشائعة
- إرسال سجلات كافة حاويات Docker عبر Vector أو Fluentbit مباشرة إلى المنفذ 9428 في VictoriaLogs
- الاستعلام عن أخطاء سيرفرات Nginx بلغة LogsQL: `_stream:{app="nginx"} status:>=500 | stats count() by (request_uri)`
- تخزين سجلات نظام لينكس لـ 6 أشهر كاملة في مساحة قرص مضغوطة تقل عن 10 جيجابايت
- مراقبة محاولات تسجيل الدخول الفاشلة عبر SSH عبر 20 سيرفر في الوقت الفعلي
- البحث في ملايين سجلات الـ JSON للتطبيقات بمعرّف العميل أو رقم العملية في أجزاء من الثانية
الميزات الرئيسية
- استهلاك فائق الضآلة للذاكرة على المنفذ 9428: يعمل بسلاسة على أجهزة بذاكرة تبدأ من 256 ميجابايت RAM
- ضغط استثنائي للقرص: معدل ضغط أعلى بما يصل إلى 15 ضعفاً مقارنة بالسجلات النصية غير المضغوطة
- سرعة استقبال خارقة: معالجة مئات آلاف أسطر السجلات في الثانية على نواة معالج واحدة
- محرك LogsQL الذكي: تصفية مبنية على الأنابيب (Pipes)، ومطابقة التعابير النمطية، والتحويلات الإحصائية
- مستكشف ويب مدمج (VMUI): واجهة بصرية لتصفح السجلات والرسوم البيانية في مسار `/select/vmui/`
- توافق واسع مع برامج الإرسال: منافذ أصلية لاستقبال السجلات من Vector وFluentbit وLogstash وPromtail وcurl
- دعم تعدد المستأجرين (Multi-Tenancy): عزل سجلات العملاء والمشاريع المختلفة عبر ترويسات `AccountID`
- معمارية Docker Compose تجمع VictoriaLogs مع ربط مجلد `./vlogs-data` لحفظ السجلات المضغوطة على القرص
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:9428/select/vmui/ لفتح مستكشف السجلات
- أرسل سطر سجل تجريبي بـ curl: `curl -X POST 'http://ip-سيرفرك:9428/insert/jsonline?_stream_fields=app&_time_field=time' -d '{"time":"2026-08-20T12:00:00Z","app":"test","msg":"Hello VictoriaLogs"}'`
- اضبط برنامج Vector أو Fluentbit على سيرفراتك لتوجيه سجلات Docker وsystemd للمنفذ 9428
- احفظ استعلامات LogsQL المكررة لفلاتر الأخطاء الشائعة ومراقبة الخدمات في لوحة VMUI
- ضع VictoriaLogs خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع مصادقة Basic Auth
- أعد سكريبت نسخ احتياطي دوري لمجلد السجلات `./vlogs-data`
أفضل ممارسات الأمان
- تنبيه أمني حاسم: لا يحتوي VictoriaLogs على نظام مصادقة مدمج؛ ضعه دائماً خلف وكيل عكسي محمي بكلمة مرور
- لا تفتح منفذ الاستقبال 9428 للإنترنت العام مباشرة نهائياً
- اقصر الاتصال بالمنفذ 9428 على برامج إرسال السجلات (Vector/Fluentbit) وشبكة الإدارة الداخلية
- احمِ مجلد السجلات `./vlogs-data` بصلاحيات نظام صارمة بالسيرفر (`chmod 700`)
- استخدم تشفير TLS بين برامج إرسال السجلات والوكيل العكسي لحماية بيانات السجلات الحساسة المنقولة بالشبكة
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار
المنافذ وإعدادات جدار الحماية
يعمل VictoriaLogs عبر منفذ TCP 9428 (للواجهة البرمجية ومستكشف السجلات VMUI في مسار `/select/vmui/`). اسمح بالمنفذ 9428 للشبكة الداخلية الموثوقة لبرامج إرسال السجلات (`ufw allow 9428/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 مع كلمة مرور للمديرين.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./vlogs-data` احتياطياً، والذي يحتوي على كافة أقسام وفهارس السجلات المضغوطة
- استخدم أداة `vmbackup` المخصصة لأخذ لقطات حية دون إيقاف الخدمة: `vmbackup -storageDataPath=./vlogs-data -dst=fs:///backup/vlogs`
- احتفظ بنسخة من ملف `docker-compose.yml` وملفات إعدادات برامج إرسال السجلات
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية وتنفيذ استعلامات LogsQL للتأكد من قراءة السجلات
الأخطاء الشائعة
- كشف المنفذ 9428 للإنترنت العام بدون كلمة مرور مما يكشف سجلات سيرفراتك وبيانات المستخدمين بالكامل
- فهرسة حقول متغيرة لا نهائية (High-Cardinality) كحقول تدفق (Stream Fields)، حيث يجب أن تعبر حقول التدفق عن مصدر السجل فقط كـ `app` و`host`
- عدم ربط مجلد التخزين الدائم `./vlogs-data`، مما يسبب مسح كافة السجلات التاريخية عند تحديث الحاوية
- إرسال سجلات بتنسيقات توقيت متباينة دون تحديد حقل الوقت `_time_field`
- امتلاء القرص بسبب تعطيل خيارات مدة الاحتفاظ بالسجلات (Retention) في البيئات كثيفة السجلات
استكشاف الأخطاء وإصلاحها
- رفض الاتصال بالواجهة أو الـ API — تأكد من عمل الحاوية بالأمر `docker compose ps` وافحص السجلات: `docker logs victorialogs -f`
- السجلات لا تظهر في VMUI — تأكد من أن نطاق الوقت المحدد في شاشة البحث يغطي تاريخ ووقت السجلات المرسلة
- رفض استلام السجلات بخطأ 400 Bad Request — تأكد من صحة تنسيق الـ JSON ومطابقة ترويسات حقول التدفق للبيانات
- استهلاك مرتفع للذاكرة أثناء الاستعلامات الضخمة — حدد استهلاك الذاكرة عبر إضافة معامل `-search.maxMemoryPerQuery`
- امتلاء مساحة القرص بسرعة — اضبط مدة الاحتفاظ التلقائي بالسجلات عبر معامل `-retentionPeriod=30d`
البدائل
منصة Grafana Loki لتجميع السجلات بالوسوم. محرك Elasticsearch المؤسسي للسجلات والبحث. محرك OpenSearch مفتوح المصدر. منصة Graylog لإدارة السجلات. قاعدة بيانات ClickHouse العمودية لتحليلات السجلات الضخمة.
متى لا تستخدمه
تجنب استخدام VictoriaLogs إذا كنت تبحث عن محرك بحث للمنتجات بمتجر إلكتروني مع دعم التسامح مع الأخطاء الإملائية (حيث صُممت Typesense أو Meilisearch لبحث المنتجات؛ بينما صُممت VictoriaLogs لسجلات السيرفرات). وإذا كنت تحتاج حصراً لجمع المقاييس الزمنية كاستهلاك المعالج والرام والرسوم البيانية، فإن VictoriaMetrics مخصصة للمقاييس.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو VictoriaLogs وما الفرق بينه وبين Grafana Loki وElasticsearch؟
تعد VictoriaLogs قاعدة بيانات سجلات فائقة الكفاءة مبرمجة بـ Go. وعلى عكس Elasticsearch، تستهلك ذاكرة RAM أقل بـ 30 ضعفاً ولا تتطلب إدارة فهارس معقدة. وعلى عكس Loki، تفهرس النصوص الكاملة وتدعم الحقول المتغيرة بكفاءة بالغة.
ما هي لغة LogsQL؟
تعد LogsQL لغة الاستعلام الخاصة بـ VictoriaLogs. وتعتمد على بنية الأنابيب السلسة (`_stream:{app="nginx"} | filter status:500 | stats count()`) مما يجعل البحث والتصفية وحساب الإحصائيات سريعاً وبديهياً.
كيف أقوم بتوجيه سجلات حاويات Docker إلى VictoriaLogs؟
يمكنك استخدام برامج إرسال خفيفة مثل Vector أو Fluentbit. اضبط Vector ليقرأ من مقبس Docker (Docker Socket) ويرسل الأسطر بتنسيق JSON إلى مسار `http://ip-سيرفرك:9428/insert/jsonline`.
هل يدعم VictoriaLogs سياسات الاحتفاظ التلقائي بالسجلات (Retention)؟
نعم! يمكنك ضبط مدة الاحتفاظ بالسجلات عبر معامل تشغيل الحاوية `-retentionPeriod` (مثل `-retentionPeriod=90d` لحذف السجلات التي يتجاوز عمرها 90 يوماً تلقائياً).
كم يستهلك VictoriaLogs من الذاكرة العشوائية (RAM) والمعالج؟
يتميز VictoriaLogs بخفة استثنائية، حيث يستهلك عادة ما بين 100 إلى 300 ميجابايت فقط من الرام مع استهلاك طفيف للمعالج داخل Docker للبيئات التي تستقبل آلاف السجلات بالثانية.