بروميثيوس

تفضل بزيارة prometheus.io للحصول على الوثائق الكاملة والأمثلة والأدلة.

يعد Prometheus، وهو مشروع تابع لمؤسسة Cloud Native Computing Foundation، نظامًا لمراقبة الأنظمة والخدمات. فهو يجمع المقاييس من الأهداف التي تم تكوينها على فترات زمنية محددة، ويقيم تعبيرات القاعدة، ويعرض النتائج، ويمكنه إطلاق التنبيهات عند ملاحظة شروط محددة.

الميزات التي تميز بروميثيوس عن المقاييس وأنظمة المراقبة الأخرى هي:

نموذج بيانات متعدد الأبعاد (سلسلة زمنية محددة باسم المقياس ومجموعة أبعاد المفتاح/القيمة)
PromQL، لغة استعلام قوية ومرنة للاستفادة من هذه الأبعاد
عدم الاعتماد على التخزين الموزع؛ عقد الخادم الواحد مستقلة
نموذج سحب HTTP لجمع السلاسل الزمنية
يتم دعم دفع السلاسل الزمنية عبر بوابة وسيطة للوظائف المجمعة
يتم اكتشاف الأهداف من خلال اكتشاف الخدمة أو التكوين الثابت
أوضاع متعددة للرسوم البيانية ودعم لوحة المعلومات
دعم الاتحاد الهرمي والأفقي

نظرة عامة على الهندسة المعمارية

QQ浏览器截图20241111113051.png

ثَبَّتَ

هناك طرق مختلفة لتثبيت بروميثيوس.

الثنائيات المترجمة مسبقا

تتوفر الثنائيات المترجمة مسبقًا للإصدارات التي تم إصدارها في قسم التنزيل على prometheus.io. يعد استخدام أحدث إصدار ثنائي للإنتاج هو الطريقة الموصى بها لتثبيت Prometheus. راجع فصل التثبيت في الوثائق للحصول على كافة التفاصيل.

صور عامل الميناء

تتوفر صور Docker على Quay.io أو Docker Hub.

يمكنك تشغيل حاوية Prometheus لتجربتها

 تشغيل عامل الميناء - اسم بروميثيوس -d -p 127.0.0.1:9090:9090 حفلة موسيقية/بروميثيوس

يمكن الآن الوصول إلى Prometheus على http://localhost:9090/.

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

لبناء بروميثيوس من التعليمات البرمجية المصدر، تحتاج إلى:

انتقل إلى الإصدار 1.17 أو أحدث.
NodeJS الإصدار 16 أو أحدث.
npm الإصدار 7 أو أكبر.

ابدأ باستنساخ المستودع:

 استنساخ بوابة https://github.com/prometheus/prometheus.gitcd بروميثيوس

يمكنك استخدام أداة go لإنشاء وتثبيت ثنائيات prometheus و promtool في GOPATH الخاص بك:

 GO111MODULE=ابدأ بتثبيت github.com/prometheus/prometheus/cmd/...
بروميثيوس --config.file=your_config.yml

ومع ذلك ، عند استخدام go install لإنشاء Prometheus، يتوقع Prometheus أن يكون قادرًا على قراءة أصول الويب الخاصة به من أدلة نظام الملفات المحلية ضمن web/ui/static و web/ui/templates . من أجل العثور على هذه الأصول، سيتعين عليك تشغيل Prometheus من جذر المستودع المستنسخ. لاحظ أيضًا أن هذه الأدلة لا تشتمل على واجهة مستخدم React ما لم يتم إنشاؤها بشكل صريح باستخدام make assets أو make build .

يمكن العثور على مثال لملف التكوين أعلاه هنا.

يمكنك أيضًا البناء باستخدام make build ، والذي سيتم تجميعه في أصول الويب بحيث يمكن تشغيل Prometheus من أي مكان:

 جعل بناء
./prometheus --config.file=your_config.yml

يوفر Makefile عدة أهداف:

البناء : إنشاء الثنائيات prometheus و promtool (بما في ذلك إنشاء أصول الويب وتجميعها)
اختبار : تشغيل الاختبارات
اختبار قصير : تشغيل الاختبارات القصيرة
التنسيق : تنسيق الكود المصدري
الطبيب البيطري : تحقق من الكود المصدري بحثًا عن الأخطاء الشائعة
الأصول : إنشاء واجهة مستخدم React

المكونات الإضافية لاكتشاف الخدمة

تم تضمين Prometheus مع العديد من المكونات الإضافية لاكتشاف الخدمة. عند إنشاء Prometheus من المصدر، يمكنك تحرير ملف plugins.yml لتعطيل بعض اكتشافات الخدمة. الملف عبارة عن قائمة بتنسيق yaml لمسار استيراد go الذي سيتم دمجه في ملف Prometheus الثنائي.

بعد أن قمت بتغيير الملف، تحتاج إلى تشغيل make build مرة أخرى.

إذا كنت تستخدم طريقة أخرى لتجميع Prometheus، فسيقوم make plugins بإنشاء ملف المكونات الإضافية وفقًا لذلك.

إذا قمت بإضافة مكونات إضافية خارج الشجرة، وهو ما لا نؤيده في الوقت الحالي، فقد تكون هناك حاجة إلى خطوات إضافية لضبط ملفات go.mod و go.sum . كما هو الحال دائمًا، كن حذرًا جدًا عند تحميل تعليمات برمجية لجهة خارجية.

بناء صورة عامل الميناء

تم تصميم هدف make docker للاستخدام في نظام CI الخاص بنا. يمكنك إنشاء صورة عامل إرساء محليًا باستخدام الأوامر التالية:

 اصنع عرضًا ترويجيًا
promu crossbuild -p linux/amd64
قم بإنشاء npm_licenses
جعل عامل الإرساء المشترك AMD64

استخدام بروميثيوس كمكتبة Go

الكتابة عن بعد

نقوم بنشر نموذج الكتابة عن بعد الخاص بنا بشكل مستقل على buf.build.

يمكنك استخدامه كمكتبة:

 اذهب واحصل على buf.build/gen/go/prometheus/prometheus/protocolbuffers/go@latest

هذا تجريبي.

قاعدة كود بروميثيوس

من أجل الامتثال لقواعد go mod، لا يتطابق رقم إصدار Prometheus تمامًا مع إصدارات وحدة Go. بالنسبة لإصدارات Prometheus v2.yz، فإننا ننشر علامات v0.yz المكافئة.

لذلك، يمكن للمستخدم الذي يرغب في استخدام Prometheus v2.35.0 كمكتبة القيام بما يلي:

 اذهب واحصل على github.com/prometheus/[email protected]

يوضح هذا الحل أننا قد نقوم بفصل واجهات برمجة التطبيقات Go الداخلية الخاصة بنا بين الإصدارات الثانوية التي تواجه المستخدم، حيث يُسمح بكسر التغييرات في الإصدار الرئيسي صفر.

رد فعل تطوير واجهة المستخدم

لمزيد من المعلومات حول إنشاء واجهة المستخدم المستندة إلى React وتشغيلها وتطويرها، راجع ملف README.md الخاص بتطبيق React.

مزيد من المعلومات

وثائق Godoc متاحة عبر pkg.go.dev. نظرًا لخصائص وحدات Go، سيتم عرض v2.xy كـ v0.xy
راجع صفحة المجتمع لمعرفة كيفية الوصول إلى مطوري ومستخدمي Prometheus عبر قنوات الاتصال المختلفة.