Loki: مثل Prometheus، لكن للسجلات.

Loki هو نظام تجميع سجلات قابل للتوسع أفقيًا، عالي التوافر، ومتعدد المستأجرين، مستوحى من Prometheus. صُمم ليكون فعالًا جدًا من حيث التكلفة وسهل التشغيل. لا يقوم بفهرسة محتويات السجلات، بل يفهرس مجموعة من التسميات (labels) لكل تدفق سجلات.

بالمقارنة مع أنظمة تجميع السجلات الأخرى، يتميز Loki بما يلي:

• لا يقوم بفهرسة النص الكامل للسجلات. من خلال تخزين سجلات مضغوطة وغير منظمة وفهرسة البيانات الوصفية فقط، يكون Loki أبسط في التشغيل وأقل تكلفة.
• يفهرس ويجمّع تدفقات السجلات باستخدام نفس التسميات التي تستخدمها بالفعل مع Prometheus، مما يتيح لك التبديل بسلاسة بين المقاييس والسجلات باستخدام نفس التسميات التي تستخدمها بالفعل مع Prometheus.
• مناسب بشكل خاص لتخزين سجلات Pod الخاصة بـ Kubernetes. يتم جمع وفهرسة البيانات الوصفية مثل تسميات Pod تلقائيًا.
• يتمتع بدعم أصلي في Grafana (يتطلب Grafana v6.0).

تتكون حزمة تسجيل مبنية على Loki من 3 مكونات:

• Alloy هو الوكيل (agent)، المسؤول عن جمع السجلات وإرسالها إلى Loki.
• Loki هو الخدمة الرئيسية، المسؤولة عن تخزين السجلات ومعالجة الاستعلامات.
• Grafana للاستعلام عن السجلات وعرضها.

لاحظ أن Alloy حل محل Promtail في الحزمة، لأن Promtail يُعتبر مكتمل الميزات (feature complete)، وسيكون التطوير المستقبلي لجمع السجلات في Grafana Alloy.

Loki يشبه Prometheus، لكنه مخصص للسجلات: نحن نفضّل نهجًا متعدد الأبعاد قائمًا على التسميات للفهرسة، ونريد نظامًا أحادي الثنائي (single-binary) سهل التشغيل دون أي تبعيات. يختلف Loki عن Prometheus بتركيزه على السجلات بدلاً من المقاييس، وتوصيل السجلات عبر الدفع (push) بدلاً من السحب (pull).

البدء

• تثبيت Loki
• تثبيت Alloy
• بدء الاستخدام

⚠️ ترحيل Helm Chart

اعتبارًا من 16 مارس 2026، سيتم تفرع مخطط Helm الخاص بـ Grafana Loki إلى مستودع جديد grafana-community/helm-charts. سيستمر الاحتفاظ بالمخطط الموجود في مستودع Loki وصيانته لمستخدمي GEL فقط. راجع #20705 للحصول على التفاصيل.

الترقية

• ترقية Loki

التوثيق

• أحدث إصدار
• الإصدار القادم، على رأس الفرع الرئيسي

الأقسام الشائعة الاستخدام:

• توثيق API لإدخال السجلات إلى Loki.
• التسميات (Labels)
• العمليات
• عميل Docker Driver هو إضافة Docker لإرسال السجلات مباشرة إلى Loki من حاويات Docker.
• LogCLI يوفر واجهة سطر أوامر للاستعلام عن السجلات.
• Loki Canary يراقب تثبيت Loki لديك بحثًا عن السجلات المفقودة.
• استكشاف الأخطاء وإصلاحها يقدم مساعدة في التعامل مع رسائل الأخطاء.
• Loki في Grafana يصف كيفية إعداد مصدر بيانات Loki في Grafana.

الحصول على المساعدة

إذا كان لديك أي أسئلة أو ملاحظات بخصوص Loki:

• ابحث في المواضيع الموجودة في منتدى مجتمع Grafana Labs الخاص بـ Loki: https://community.grafana.com
• اطرح سؤالًا على قناة Loki في Slack. لتنضم بنفسك إلى Grafana Slack، قم بزيارة https://slack.grafana.com/ وانضم إلى قناة #loki.
• أنشئ مشكلة (issue) للإبلاغ عن الأخطاء والمشكلات واقتراحات الميزات.
• أرسل بريدًا إلكترونيًا إلى [email protected]، أو استخدم الواجهة الإلكترونية.
• يجب الإبلاغ عن مشكلات واجهة المستخدم مباشرة في Grafana.

ملاحظاتك مرحب بها دائمًا.

قراءات إضافية

• مستند التصميم الأصلي لـ Loki هو مصدر جيد لمناقشة الدوافع وقرارات التصميم.
• محاضرة Callum Styan في DevOpsDays Vancouver مارس 2019 "Grafana Loki: تجميع السجلات لتحقيقات الحوادث".
• مقال مدونة Grafana Labs "كيف صممنا Loki ليعمل بسهولة سواء كخدمات مصغرة أو كبنية أحادية".
• محاضرة Tom Wilkie في CNCF Paris/FOSDEM أوائل 2019 "Grafana Loki: مثل Prometheus، لكن للسجلات" (الشرائح, الفيديو).
• محاضرة David Kaltschmidt في KubeCon 2018 "على مسار OSS نحو المراقبة الكاملة مع Grafana" (الشرائح, الفيديو) حول كيفية تناسب Loki مع بيئة سحابية أصلية (cloud-native).
• مقال مدونة Goutham Veeramachaneni "Loki: تسجيل مفتوح المصدر مستوحى من Prometheus للبيئات السحابية الأصلية" حول تفاصيل بنية Loki.
• مقال مدونة David Kaltschmidt "نظرة أقرب على واجهة مستخدم Grafana لـ Loki" حول الأفكار التي ساهمت في تصميم واجهة مستخدم التسجيل.

المساهمة

راجع CONTRIBUTING.md

البناء من المصدر

يمكن تشغيل Loki على مضيف واحد، في وضع خالٍ من التبعيات، باستخدام الأوامر التالية.

تحتاج إلى إصدار محدث من Go، ونوصي باستخدام الإصدار الموجود في Makefile الخاص بنا

# Checkout source code
$ git clone https://github.com/grafana/loki
$ cd loki

# Build binary
$ go build ./cmd/loki

# Run executable
$ ./loki -config.file=./cmd/loki/loki-local-config.yaml

بدلاً من ذلك، على أنظمة Unix يمكنك استخدام make لبناء الثنائي، حيث يضيف وسائط إضافية إلى أمر go build.

# Build binary
$ make loki

# Run executable
$ ./cmd/loki/loki -config.file=./cmd/loki/loki-local-config.yaml

لتشغيل عدة مستأجرين من Loki محليًا، تأكد من ضبط auth_enabled على true وقدم إعداد وقت تشغيل (runtime config) مع أي تجاوزات خاصة بمستأجر معين.

# Build binary
$ make loki

# Run executable
./loki -config.file=./cmd/loki/loki-local-multi-tenant-config.yaml -runtime-config.file=./cmd/loki/loki-overrides.yaml

المستخدمون

يرجى الاطلاع على ADOPTERS.md للتعرف على بعض المؤسسات التي تستخدم Loki حاليًا. إذا كنت ترغب في إضافة مؤسستك إلى القائمة، فيرجى فتح PR لإضافتها إلى القائمة.

الترخيص

يتم توزيع Grafana Loki بموجب AGPL-3.0-only. للاستثناءات المتعلقة بـ Apache-2.0، راجع LICENSING.md.