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

مقدمة لاستخدام ClickHouse مع Grafana

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

​

1. جهّز تفاصيل الاتصال الخاصة بك

للاتصال بـ 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 مُدارًا ذاتيًا، فسيحدّد مسؤول ClickHouse لديك تفاصيل الاتصال.

​

2. إنشاء مستخدم بصلاحية القراءة فقط

عند توصيل ClickHouse بأداة لتصوّر البيانات مثل Grafana، يُنصح بإنشاء مستخدم بصلاحية القراءة فقط لحماية بياناتك من التعديلات غير المرغوب فيها.

لا يتحقق Grafana من أمان الاستعلامات. فقد تتضمن الاستعلامات أي تعليمة SQL، بما في ذلك DELETE وINSERT.

لتهيئة مستخدم بصلاحية القراءة فقط، اتبع الخطوات التالية:

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

​

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

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

1. من صفحة Connections في الشريط الجانبي، اختر علامة التبويب Add new connection.

2. ابحث عن ClickHouse وانقر على المكوّن الإضافي الموقَّعة من Grafana Labs:

3. في الشاشة التالية، انقر على الزر Install:

​

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

1. بعد اكتمال التثبيت، انقر على زر إضافة مصدر بيانات جديد. (يمكنك أيضًا إضافة مصدر بيانات من علامة التبويب مصادر البيانات في صفحة Connections.)

2. مرّر إلى أسفل وابحث عن نوع مصدر البيانات ClickHouse، أو ابحث عنه في شريط البحث في صفحة إضافة مصدر بيانات. حدّد مصدر بيانات ClickHouse، وستظهر الصفحة التالية:

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

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

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

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

​

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

أصبح مصدر البيانات لديك جاهزًا الآن للاستخدام! تعرّف على المزيد حول كيفية إنشاء الاستعلامات باستخدام منشئ الاستعلامات.

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

إذا كنت تبحث عن مزيد من المعلومات غير الواردة في هذه الوثائق، فراجع مستودع المكوّن الإضافي على GitHub.

​

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

بدءًا من الإصدار v4، يمكن ترقية الإعدادات والاستعلامات مع صدور إصدارات جديدة.

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

لا يمكن للمكوّن الإضافي الرجوع إلى إصدارات سابقة إذا كان الإعداد/الاستعلام قد أُنشئ باستخدام إصدار أحدث.