واجهة برمجة التطبيقات لنقطة نهاية Prometheus لاسترداد مقاييس ClickHouse Cloud
مرجع واجهة برمجة تطبيقات
نقطة نهاية المقاييس على مستوى المؤسسة (
GET /v1/organizations/{organizationId}/prometheus) مهملة لصالح الاكتشاف التلقائي للخدمات. يمكن للمؤسسات الحالية الاستمرار في استخدامها، بينما تستخدم المؤسسات المنشأة حديثًا نقطة نهاية الاكتشاف بدلًا منها. تواصل مع دعم ClickHouse إذا كنت بحاجة إلى الوصول إلى نقطة النهاية هذه.
تتوفر مخططات الطلب والاستجابة الكاملة لهذه الـنقاط النهاية في مرجع Cloud واجهة برمجة تطبيقات.
المصادقة
استجابة نموذجية
تسميات المقاييس
بالنسبة إلى ClickPipes، ستتضمن المقاييس أيضًا التسميات التالية:
مقاييس المعلومات
ClickHouse_ServiceInfo، وهو من نوع gauge وتكون قيمته دائمًا 1. يحتوي هذا المقياس على جميع تسميات المقاييس بالإضافة إلى التسميات التالية:
لن تؤدي طلبات استرجاع المقاييس إلى استئناف خدمة في حالة
idle. وإذا كانت الخدمة في الحالة idle، فلن يُرجع سوى المقياس ClickHouse_ServiceInfo.
بالنسبة إلى ClickPipes، يوجد مقياس gauge مشابه باسم ClickPipes_Info يحتوي، بالإضافة إلى تسميات المقاييس، على التسميات التالية:
تهيئة Prometheus
honor_labels يجب تعيينها إلى true لكي يُملأ وسم المثيل بشكل صحيح. بالإضافة إلى ذلك، ضُبطت filtered_metrics على true في المثال أعلاه، ولكن ينبغي تهيئتها وفقًا لتفضيل المستخدم.
الاكتشاف التلقائي للخدمات
http_sd). يُحدِّث Prometheus قائمة الأهداف عند كل عملية poll للاكتشاف ويجري جمعًا لكل هدف مُكتشَف، لذلك تُكتشف الخدمات المنشأة حديثًا تلقائيًا وتُزال الخدمات المحذوفة من قائمة الأهداف. ولا تُدرج إلا الخدمات التي يملك مفتاح واجهة برمجة تطبيقات صلاحية عرضها؛ وتُستبعد الخدمات التي يجري حذفها أو التي حُذفت بالفعل.
لاستخدامها، وجّه job http_sd_configs إلى نقطة نهاية الاكتشاف:
basic_auth في كلا الموضعين: إذ تتولى الكتلة ضمن http_sd_configs مصادقة عمليات استقصاء الاكتشاف، بينما تتولى الكتلة في مهمة الجمع مصادقة جمع المقاييس لكل خدمة. وكما في التكوين الثابت، اضبط honor_labels: true لضمان تعبئة تسمية المثيل بشكل صحيح.
استجابة نموذجية للاكتشاف:
filtered_metrics=true. ولاكتشاف الأهداف التي تجمع المجموعة الكاملة من المقاييس، أضف ?filtered_metrics=false إلى URL الاكتشاف. تتوفر المواصفة الكاملة لنقطة النهاية في مرجع Cloud واجهة برمجة تطبيقات.
التكامل مع Grafana
- نقطة نهاية المقاييس – تمتاز هذه الطريقة بأنها لا تتطلب أي مكونات أو بنية تحتية إضافية. يقتصر هذا الخيار على Grafana Cloud، ولا يتطلب سوى endpoint URL لـ نقطة نهاية Prometheus في ClickHouse Cloud وبيانات الاعتماد.
- Grafana Alloy - Grafana Alloy هو توزيعة غير مرتبطة بمورّد معيّن من OpenTelemetry (OTel) Collector، ويحل محل Grafana Agent. ويمكن استخدامه كـ scraper، كما يمكن نشره ضمن بنيتك التحتية الخاصة، وهو متوافق مع أي نقطة نهاية Prometheus.
Grafana Cloud مع نقطة نهاية المقاييس
- سجّل الدخول إلى حسابك في Grafana Cloud
- أضف اتصالًا جديدًا باختيار نقطة نهاية المقاييس
- اضبط عنوان URL الخاص بـ Scrape بحيث يشير إلى نقطة نهاية Prometheus، واستخدم المصادقة الأساسية لإعداد اتصالك باستخدام مفتاح واجهة برمجة تطبيقات/السر
- اختبر الاتصال للتأكد من أنك قادر على الاتصال
بعد إكمال التهيئة، ينبغي أن ترى المقاييس في القائمة المنسدلة التي يمكنك اختيارها لتهيئة لوحات المعلومات:
Grafana Cloud مع Alloy
من المفترض أن يُعِدّ ذلك Alloy باستخدام مكوّن
prometheus.remote_write لإرسال البيانات إلى نقطة نهاية في Grafana Cloud باستخدام رمز مصادقة. بعد ذلك، لن يحتاج المستخدمون إلا إلى تعديل ملف إعداد Alloy (الموجود في /etc/alloy/config.alloy على Linux) لتضمين مكوّن scrape لـ نقطة نهاية Prometheus في ClickHouse Cloud.
يوضح ما يلي مثالاً لإعداد Alloy يتضمن مكوّن prometheus.scrape لجمع المقاييس من نقطة نهاية ClickHouse Cloud، بالإضافة إلى مكوّن prometheus.remote_write الذي يُضبط تلقائيًا. لاحظ أن مكوّن الإعداد basic_auth يحتوي على معرّف مفتاح Cloud واجهة برمجة تطبيقات والقيمة السرية الخاصة به باعتبارهما اسم المستخدم وكلمة المرور، على الترتيب.
honor_labels على true لكي يُملأ وسم المثيل بشكل صحيح.
Grafana المُدارة ذاتيًا مع Alloy
prometheus.scrape أدناه جعل Alloy يجمع المقاييس من نقطة نهاية ClickHouse Cloud. ونفترض أن prometheus.remote_write يستقبل المقاييس التي جُمعت. عدّل forward_to key ليشير إلى الوجهة المستهدفة إذا لم يكن موجودًا.
تجدر الإشارة إلى أن معلمة الضبط
honor_labels يجب ضبطها على true لكي تتم تعبئة وسم المثيل بشكل صحيح.
التكامل مع Datadog
- نظرة عامة على المراقبة — قارِن جميع أساليب المراقبة في ClickHouse Cloud
- المراقبة في Cloud Console — لوحات معلومات مدمجة لا تتطلب أي أدوات خارجية
- تكاملات المجتمع والشركاء — تكامل Datadog agent وحلول من المجتمع
- الاستعلام عن جداول النظام — وصول مباشر عبر SQL إلى مقاييس النظام
- نقطة نهاية Prometheus لـ ClickHouse Managed Postgres — اجلب المقاييس من خدمات ClickHouse Managed Postgres لديك