مضمّن في ClickHouse

استخدام ClickStack المضمّن في خادم ClickHouse - حزمة observability الخاصة بـ ClickHouse

يأتي ClickStack مضمّنًا مباشرةً داخل الملف التنفيذي لخادم ClickHouse. وهذا يعني أنه يمكنك الوصول إلى واجهة مستخدم ClickStack ‏(HyperDX) من خلال مثيل ClickHouse لديك من دون الحاجة إلى نشر أي مكوّنات إضافية. ويشبه هذا النشر العرض التوضيحي العام المتاح على play-clickstack.clickhouse.com، لكنه يعمل على مثيل ClickHouse وبياناتك الخاصة.

​

مناسب لـ

• تجربة ClickStack بأقل قدر من الإعداد
• استكشاف بيانات ClickHouse الخاصة بك باستخدام واجهة Observability
• العروض التوضيحية والتقييمات

​

القيود

هذه النسخة المضمّنة غير مصممة للاستخدام في بيئات الإنتاج. الميزات التالية غير متاحة مقارنةً بـ عمليات نشر OSS الجاهزة للإنتاج:

• التنبيهات
• استمرارية لوحة المعلومات والبحث — لا تُحفَظ لوحات المعلومات وعمليات البحث المحفوظة بين الجلسات
• إعدادات الاستعلام القابلة للتخصيص
• أنماط الأحداث

​

خطوات النشر

Docker

1. ​

   ابدأ ClickHouse

   اسحب صورة خادم ClickHouse وشغّلها مع تعيين كلمة مرور:

   docker run --rm -it -p 8123:8123 -e CLICKHOUSE_PASSWORD=password clickhouse/clickhouse-server:head-alpine
   

   التشغيل من دون كلمة مرور

   إذا كنت تفضّل التشغيل من دون كلمة مرور، فيجب تمكين إدارة الوصول الافتراضية صراحةً:

   docker run --rm -it -p 8123:8123 -e CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT=1 clickhouse/clickhouse-server:head-alpine
   
2. ​

   افتح واجهة ClickStack

   افتح http://localhost:8123 في المتصفح وانقر على ClickStack.

   أدخل اسم المستخدم default وكلمة المرور password للاتصال بالمثيل المحلي.

3. ​

   أنشئ مصدرًا

   إذا كانت لديك جداول OpenTelemetry موجودة، فسيكتشفها ClickStack وينشئ المصادر تلقائيًا.

   في التثبيت الجديد، سيُطلب منك إنشاء مصدر. املأ حقل Table باسم الجدول المناسب (مثل otel_logs) ثم انقر على Save New Source.

   إذا لم تكن لديك بيانات بعد، فراجع إدخال البيانات للاطلاع على الخيارات المتاحة.

الملف التنفيذي

1. ​

   ابدأ ClickHouse

   نزّل ClickHouse وابدأ تشغيله:

   curl https://clickhouse.com/ | sh
   

   اختياري: فعّل جداول سجلات النظام

   لاستكشاف السجلات والمقاييس الداخلية الخاصة بـ ClickHouse نفسه، أنشئ مقتطف تهيئة في دليل العمل قبل بدء الخادم:

   mkdir -p config.d && cat > config.d/query_logs.xml << 'EOF'
   <clickhouse>
       <query_log>
           <database>system</database>
           <table>query_log</table>
       </query_log>
       <query_thread_log>
           <database>system</database>
           <table>query_thread_log</table>
       </query_thread_log>
       <query_views_log>
           <database>system</database>
           <table>query_views_log</table>
       </query_views_log>
       <metric_log>
           <database>system</database>
           <table>metric_log</table>
       </metric_log>
       <asynchronous_metric_log>
           <database>system</database>
           <table>asynchronous_metric_log</table>
       </asynchronous_metric_log>
   </clickhouse>
   EOF
   

   بعد تفعيل ذلك، يمكنك إنشاء Log Source يشير إلى system.query_log بعد فتح ClickStack:

   الإعداد	القيمة
   Name	Query Logs
   Database	system
   Table	query_log
   Timestamp Column	event_time
   Default Select	event_time, query_kind, query, databases, tables, initial_user, projections, memory_usage, written_rows, read_rows, query_duration_ms

   ابدأ تشغيل الخادم:

   ./clickhouse server
   
2. ​

   افتح واجهة ClickStack

   افتح http://localhost:8123 في المتصفح وانقر على ClickStack. سيُنشأ اتصال بالمثيل المحلي تلقائيًا.

3. ​

   أنشئ مصدرًا

   إذا كانت لديك جداول OpenTelemetry موجودة، فسيكتشفها ClickStack وينشئ المصادر تلقائيًا.

   إذا لم تكن لديك بيانات بعد، فراجع إدخال البيانات للاطلاع على الخيارات المتاحة.

​

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

إذا كنت مستعدًا للانتقال إلى ما بعد مرحلة التقييم، ففكّر في نشرٍ جاهزٍ للإنتاج:

• All-in-One — حاوية واحدة تضم جميع المكونات، بما في ذلك التخزين الدائم والمصادقة
• Docker Compose — مكونات منفصلة لمزيد من التحكم
• Helm — موصى به لعمليات النشر على Kubernetes في بيئات الإنتاج
• Managed ClickStack — مُدار بالكامل على ClickHouse Cloud