Set up docs MCPيأتي ClickStack مضمّنًا مباشرةً داخل الملف التنفيذي لخادم ClickHouse. وهذا يعني أنه يمكنك الوصول إلى واجهة مستخدم ClickStack (HyperDX) من خلال مثيل ClickHouse لديك من دون الحاجة إلى نشر أي مكوّنات إضافية. ويشبه هذا النشر العرض التوضيحي العام المتاح على play-clickstack.clickhouse.com، لكنه يعمل على مثيل ClickHouse وبياناتك الخاصة.
مناسب لـ
- تجربة ClickStack بأقل قدر من الإعداد
- استكشاف بيانات ClickHouse الخاصة بك باستخدام واجهة Observability
- العروض التوضيحية والتقييمات
القيود
هذه النسخة المضمّنة غير مصممة للاستخدام في بيئات الإنتاج. الميزات التالية غير متاحة مقارنةً بـ عمليات نشر OSS الجاهزة للإنتاج:
- التنبيهات
- استمرارية لوحة المعلومات والبحث — لا تُحفَظ لوحات المعلومات وعمليات البحث المحفوظة بين الجلسات
- إعدادات الاستعلام القابلة للتخصيص
- أنماط الأحداث
خطوات النشر
ابدأ ClickHouse
اسحب صورة خادم ClickHouse وشغّلها مع تعيين كلمة مرور:
docker run --rm -it -p 8123:8123 -e CLICKHOUSE_PASSWORD=password clickhouse/clickhouse-server:head-alpineافتح واجهة مستخدم ClickStack
افتح http://localhost:8123 في المتصفح وانقر على ClickStack.
أدخل اسم المستخدم default وكلمة المرور password للاتصال بالمثيل المحلي.
أنشئ مصدرًا
إذا كانت لديك جداول OpenTelemetry موجودة، فسيكتشفها ClickStack وينشئ المصادر تلقائيًا.
في التثبيت الجديد، سيُطلب منك إنشاء مصدر. املأ حقل Table باسم الجدول المناسب (مثل otel_logs) ثم انقر على Save New Source.
إذا لم تكن لديك بيانات بعد، فراجع إدخال البيانات للاطلاع على الخيارات المتاحة.
ابدأ 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افتح واجهة مستخدم ClickStack
افتح http://localhost:8123 في المتصفح وانقر على ClickStack. سيُنشأ اتصال بالمثيل المحلي تلقائيًا.
أنشئ مصدرًا
إذا كانت لديك جداول OpenTelemetry موجودة، فسيكتشفها ClickStack وينشئ المصادر تلقائيًا.
إذا لم تكن لديك بيانات بعد، فراجع إدخال البيانات للاطلاع على الخيارات المتاحة.
الخطوات التالية
إذا كنت مستعدًا للانتقال إلى ما بعد مرحلة التقييم، ففكّر في نشر جاهز لبيئة الإنتاج:
- الكل في واحد — حاوية واحدة تضم جميع المكونات، بما في ذلك التخزين الدائم والمصادقة
- Docker Compose — مكونات منفصلة لمزيد من التحكم
- Helm — موصى به لعمليات النشر على Kubernetes في بيئة الإنتاج
- Managed ClickStack — مُدار بالكامل على ClickHouse Cloud