Set up docs MCPباستخدام 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 مُدارًا ذاتيًا، فسيحدّد مسؤول 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.
لا يمكن للمكوّن الإضافي الرجوع إلى إصدارات سابقة إذا كان الإعداد/الاستعلام قد أُنشئ باستخدام إصدار أحدث.