المكوّن الإضافي لمصدر بيانات ClickHouse لـ Grafana

باستخدام Grafana، يمكنك استكشاف جميع بياناتك ومشاركتها عبر لوحات المعلومات. يتطلب Grafana مكوّنًا إضافيًا للاتصال بـ ClickHouse، ويمكن تثبيته بسهولة من داخل واجهته.

اجمع تفاصيل الاتصال الخاصة بك

للاتصال بـ ClickHouse باستخدام native TCP، ستحتاج إلى المعلومات التالية:

المعلمات	الوصف
`HOST` and `PORT`	يكون المنفذ عادةً 9440 عند استخدام TLS، أو 9000 عند عدم استخدام TLS.
`DATABASE NAME`	توجد افتراضيًا قاعدة بيانات باسم `default`؛ استخدم اسم قاعدة البيانات التي تريد الاتصال بها.
`USERNAME` and `PASSWORD`	يكون اسم المستخدم افتراضيًا هو `default`. استخدم اسم المستخدم المناسب لحالة الاستخدام الخاصة بك.

تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في ClickHouse Cloud console. حدّد الخدمة التي ستتصل بها، ثم انقر على Connect:

اختر Native، وستتوفر التفاصيل ضمن مثال لأمر clickhouse-client.

تفاصيل اتصال ClickHouse Cloud عبر Native TCP

إذا كنت تستخدم ClickHouse مُدارًا ذاتيًا، فسيحدّد مسؤول ClickHouse لديك تفاصيل الاتصال.

إنشاء مستخدم للقراءة فقط

عند توصيل ClickHouse بأداة لتصور البيانات مثل Grafana، يُوصى بإنشاء مستخدم للقراءة فقط لحماية بياناتك من التعديلات غير المرغوب فيها.لا يتحقق Grafana من أن الاستعلامات آمنة. إذ يمكن أن تتضمن الاستعلامات أي عبارة SQL، بما في ذلك DELETE وINSERT.لتهيئة مستخدم للقراءة فقط، اتبع الخطوات التالية:

أنشئ ملف تعريف المستخدم readonly باتباع دليل Creating Users and Roles in ClickHouse.
تأكد من أن المستخدم readonly لديه أذونات كافية لتعديل الإعداد max_execution_time الذي يتطلبه clickhouse-go client الأساسي.
إذا كنت تستخدم ClickHouse instance عامًا، فلا يُنصح بتعيين readonly=2 في ملف تعريف readonly. بدلًا من ذلك، اترك readonly=1 وعيّن نوع القيد لـ max_execution_time إلى changeable_in_readonly للسماح بتعديل هذا الإعداد.

ثبّت مكوّن ClickHouse الإضافي لـ Grafana

قبل أن يتمكن Grafana من الاتصال بـ ClickHouse، تحتاج إلى تثبيت مكوّن Grafana الإضافي المناسب. بافتراض أنك سجلت الدخول إلى Grafana، اتبع الخطوات التالية:

من صفحة Connections في الشريط الجانبي، حدّد علامة التبويب Add new connection.
ابحث عن ClickHouse وانقر على المكوّن الإضافي الموقّع من Grafana Labs:
في الشاشة التالية، انقر على زر Install:

تحديد مصدر بيانات ClickHouse

بعد اكتمال التثبيت، انقر على زر إضافة مصدر بيانات جديد. (يمكنك أيضًا إضافة مصدر بيانات من علامة التبويب مصادر البيانات في صفحة Connections.)
مرّر إلى أسفل وابحث عن نوع مصدر البيانات ClickHouse، أو ابحث عنه في شريط البحث في صفحة إضافة مصدر بيانات. حدّد مصدر بيانات ClickHouse، وستظهر الصفحة التالية:

أدخل إعدادات الخادم وبيانات الاعتماد. والإعدادات الأساسية هي:

عنوان مضيف الخادم: اسم المضيف لخدمة ClickHouse لديك.
منفذ الخادم: المنفذ الخاص بخدمة ClickHouse لديك. ويختلف حسب إعدادات الخادم والبروتوكول.
البروتوكول: البروتوكول المستخدم للاتصال بخدمة ClickHouse لديك.
اتصال آمن: فعِّله إذا كان خادمك يتطلب اتصالًا آمنًا.
اسم المستخدم وكلمة المرور: أدخل بيانات اعتماد مستخدم ClickHouse لديك. إذا لم تكن قد أعددت أي مستخدمين، فجرّب default كاسم مستخدم. ويُوصى بإعداد مستخدم بصلاحية القراءة فقط.

للاطلاع على المزيد من الإعدادات، راجع وثائق تهيئة المكوّن الإضافي.

انقر على زر Save & test للتحقق من أن Grafana يمكنه الاتصال بخدمة ClickHouse لديك. وإذا نجحت العملية، فسترى الرسالة Data source is working:

الخطوات التالية

أصبح مصدر البيانات جاهزًا الآن للاستخدام! تعرّف على المزيد حول كيفية إنشاء الاستعلامات باستخدام query builder.للمزيد من التفاصيل حول التهيئة، راجع وثائق تهيئة المكوّن الإضافي.إذا كنت تبحث عن معلومات إضافية غير متوفرة في هذه الوثائق، فراجع مستودع المكوّن الإضافي على GitHub.

ترقية إصدارات المكوّن الإضافي

بدءًا من الإصدار v4، يمكن ترقية الإعدادات والاستعلامات مع صدور إصدارات جديدة. تُنقَل الإعدادات والاستعلامات من v3 إلى v4 عند فتحها. ومع أن الإعدادات القديمة ولوحات المعلومات ستُحمَّل في v4، فلن يُحفَظ هذا الترحيل نهائيًا حتى تُحفَظ مرة أخرى في الإصدار الجديد. إذا لاحظت أي مشكلات عند فتح إعداد/استعلام قديم، فتجاهل تغييراتك وأبلغ عن المشكلة على GitHub. لا يمكن للمكوّن الإضافي الرجوع إلى إصدارات سابقة إذا كان الإعداد/الاستعلام قد أُنشئ باستخدام إصدار أحدث.

​ترقية إصدارات المكوّن الإضافي

ترقية إصدارات المكوّن الإضافي