البدء مع ClickStack المُدار

البدء مع ClickStack المُدار

أسهل طريقة للبدء هي نشر Managed ClickStack على ClickHouse Cloud، الذي يوفّر واجهة خلفية آمنة ومُدارة بالكامل مع الاحتفاظ بتحكّم كامل في الاستيعاب، والمخطط، ومسارات عمل observability. وهذا يلغي الحاجة إلى تشغيل ClickHouse بنفسك ويقدّم مجموعة من المزايا:

• التوسّع التلقائي لقدرات المعالجة بشكل مستقل عن التخزين
• احتفاظ منخفض التكلفة وغير محدود عمليًا استنادًا إلى تخزين الكائنات
• إمكانية عزل أعباء عمل القراءة والكتابة بشكل مستقل باستخدام warehouses.
• مصادقة متكاملة
• نسخ احتياطية مؤتمتة
• ميزات الأمان والامتثال
• ترقيات سلسة

1. ​

   التسجيل في ClickHouse Cloud

   لإنشاء خدمة Managed ClickStack في ClickHouse Cloud، أكمل أولًا الخطوة الأولى من دليل البدء السريع لـ ClickHouse Cloud.

   Scale مقابل Enterprise

   نوصي باستخدام فئة Scale لمعظم أعباء عمل ClickStack. اختر فئة Enterprise إذا كنت بحاجة إلى ميزات أمان متقدمة مثل SAML أو CMEK أو التوافق مع HIPAA. كما توفّر ملفات تعريف عتادية مخصّصة لعمليات نشر ClickStack الكبيرة جدًا. في هذه الحالات، نوصي بالتواصل مع الدعم.

   حدّد موفّر Cloud والمنطقة.

   

   عند تحديد CPU والذاكرة، قدِّر ذلك بناءً على معدل نقل إدخال البيانات المتوقع في ClickStack. يوفّر الجدول أدناه إرشادات لتحديد حجم هذه الموارد.

   حجم إدخال البيانات الشهري	موارد الحوسبة الموصى بها
   < 10 TB / شهر	2 vCPU × 3 نسخ متماثلة
   10–50 TB / شهر	4 vCPU × 3 نسخ متماثلة
   50–100 TB / شهر	8 vCPU × 3 نسخ متماثلة
   100–500 TB / شهر	30 vCPU × 3 نسخ متماثلة
   1 PB+ / شهر	59 vCPU × 3 نسخ متماثلة

   تستند هذه التوصيات إلى الافتراضات التالية:

   • يشير حجم البيانات إلى حجم إدخال البيانات غير المضغوط شهريًا، وينطبق على كلٍّ من السجلات وآثار التتبع.
   • تُعد أنماط الاستعلام نموذجية لحالات استخدام المراقبة، إذ تستهدف معظم الاستعلامات البيانات الحديثة، وعادةً آخر 24 ساعة.
   • يكون إدخال البيانات منتظمًا نسبيًا على مدار الشهر. إذا كنت تتوقع حركة مرور متقطعة أو ارتفاعات مفاجئة، فينبغي توفير هامش سعة إضافي.
   • تُدار السعة التخزينية بشكل منفصل عبر تخزين الكائنات في ClickHouse Cloud، وليست عاملًا مقيِّدًا لفترة الاحتفاظ بالبيانات. ونفترض أن البيانات المحتفَظ بها لفترات أطول يُجرى الوصول إليها على نحو غير متكرر.

   قد تكون هناك حاجة إلى موارد حوسبة أكبر لأنماط الوصول التي تستعلم بانتظام عن نطاقات زمنية أطول، أو تُجري عمليات تجميع كثيفة، أو تدعم عددًا كبيرًا من المستخدمين المتزامنين.

   على الرغم من أن نسختين متماثلتين يمكن أن تلبّيا متطلبات CPU والذاكرة لمعدل إدخال بيانات معيّن، فإننا نوصي باستخدام ثلاث نسخ متماثلة حيثما أمكن لتحقيق السعة الإجمالية نفسها وتحسين التكرار في الخدمة.

   هذه القيم تقديرية فقط ويجب استخدامها كخط أساس أولي. تعتمد المتطلبات الفعلية على تعقيد الاستعلامات، والتزامن، وسياسات الاحتفاظ، والتباين في معدل نقل إدخال البيانات. راقب دائمًا استخدام الموارد وقم بالتوسعة حسب الحاجة.

   بمجرد تحديد المتطلبات، ستستغرق خدمة Managed ClickStack الخاصة بك عدة دقائق لإتمام التجهيز. لا تتردد في استكشاف بقية ClickHouse Cloud console أثناء انتظار اكتمال التجهيز.

   بمجرد اكتمال التجهيز، سيتم تفعيل خيار ‘ClickStack’ في القائمة اليسرى.

2. ​

   إعداد الاستيعاب

   بعد توفير خدمتك، تأكد من تحديد الخدمة ثم انقر على “ClickStack” من القائمة اليمنى.

   

   اختر “Start Ingestion”، وسيُطلب منك تحديد مصدر للاستيعاب. يدعم Managed ClickStack كلاً من OpenTelemetry وVector باعتبارهما المصدرين الرئيسيين للاستيعاب. ومع ذلك، يمكن للمستخدمين أيضًا إرسال البيانات مباشرةً إلى ClickHouse ضمن المخطط الخاص بهم باستخدام أي من التكاملات التي يدعمها ClickHouse Cloud.

   

   يُنصح باستخدام OpenTelemetry

   يُنصح بشدة باستخدام OpenTelemetry كتنسيق للاستيعاب. فهو يوفّر أبسط تجربة وأكثرها كفاءة، مع مخططات جاهزة صُممت خصيصًا للعمل بكفاءة مع ClickStack.

   OpenTelemetry

   لإرسال بيانات OpenTelemetry إلى Managed ClickStack، يُنصح باستخدام OpenTelemetry Collector. يعمل الـ collector كبوابة تستقبل بيانات OpenTelemetry من تطبيقاتك (ومن collectors أخرى) وتُمرّرها إلى ClickHouse Cloud.

   إذا لم يكن لديك collector قيد التشغيل بالفعل، فابدأ تشغيله باتباع الخطوات أدناه. وإذا كانت لديك collectors موجودة، فستجد أيضًا مثالًا على التهيئة.

   ​

   ابدأ collector

   يفترض ما يلي المسار الموصى به، وهو استخدام توزيعة ClickStack من OpenTelemetry Collector، التي تتضمن معالجة إضافية ومُحسّنة خصيصًا لـ ClickHouse Cloud. إذا كنت تريد استخدام OpenTelemetry Collector الخاص بك، فراجع “تهيئة collectors الموجودة.”

   للبدء بسرعة، انسخ أمر Docker الموضّح وشغّله.

   

   يجب أن يتضمن هذا الأمر بيانات اعتماد الاتصال الخاصة بك مُعبأة مسبقًا.

   النشر إلى بيئة production

   رغم أن هذا الأمر يستخدم المستخدم default للاتصال بـ Managed ClickStack، ينبغي لك إنشاء مستخدم مخصص عند الانتقال إلى بيئة production وتعديل التهيئة الخاصة بك.

   يؤدي تشغيل هذا الأمر الواحد إلى بدء ClickStack collector مع إتاحة OTLP endpoints على المنفذين 4317 ‏(gRPC) و4318 ‏(HTTP). إذا كان لديك بالفعل instrumentation وagents لـ OpenTelemetry، فيمكنك البدء فورًا في إرسال بيانات telemetry إلى هذه endpoints.

   ​

   تهيئة collectors الموجودة

   يمكنك أيضًا تهيئة OpenTelemetry Collectors الموجودة لديك أو استخدام التوزيعة الخاصة بك من collector.

   يتطلب ClickHouse exporter

   إذا كنت تستخدم التوزيعة الخاصة بك، مثل contrib image، فتأكد من أنها تتضمن ClickHouse exporter.

   ولهذا الغرض، نوفّر مثالًا على تهيئة OpenTelemetry Collector يستخدم ClickHouse exporter مع الإعدادات المناسبة ويُفعّل OTLP receivers. تتوافق هذه التهيئة مع الواجهات والسلوك المتوقعين من توزيعة ClickStack.

   

   لمزيد من التفاصيل حول تهيئة OpenTelemetry collectors، راجع “إدخال البيانات باستخدام OpenTelemetry.”

   ​

   ابدأ إدخال البيانات (اختياري)

   إذا كانت لديك تطبيقات أو بنية تحتية قائمة تريد تزويدها بأدوات OpenTelemetry، فانتقل إلى الأدلة ذات الصلة المرتبطة من خلال UI.

   لتزويد تطبيقاتك بالأدوات لجمع traces وlogs، استخدم language SDKs المدعومة التي ترسل البيانات إلى OpenTelemetry Collector الخاص بك، والذي يعمل كبوابة لإدخالها إلى Managed ClickStack.

   يمكن جمع السجلات باستخدام OpenTelemetry Collectors التي تعمل في وضع agent، مع إعادة توجيه البيانات إلى collector نفسها. ولمراقبة Kubernetes، اتبع الدليل المخصص. وللتكاملات الأخرى، راجع أدلة البدء السريع الخاصة بنا.

   ​

   بيانات تجريبية

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

   • مجموعة بيانات نموذجية - حمّل مجموعة بيانات نموذجية من العرض التجريبي العام الخاص بنا. شخّص مشكلة بسيطة.
   • الملفات المحلية وmetrics - حمّل ملفات محلية وراقب النظام على OSX أو Linux باستخدام OTel collector محلي.

   
   

   متجه

   Vector هو مسار بيانات observability عالي الأداء ومحايد للمورّدين، ويشتهر بشكل خاص باستيعاب السجلات بفضل مرونته وانخفاض استهلاكه للموارد.

   عند استخدام Vector مع ClickStack، يكون المستخدمون مسؤولين عن تحديد المخططات الخاصة بهم. وقد تتبع هذه المخططات اصطلاحات OpenTelemetry، لكنها قد تكون أيضًا مخصّصة بالكامل لتمثيل بنى أحداث يحدّدها المستخدم.

   الطابع الزمني مطلوب

   الشرط الصارم الوحيد في Managed ClickStack هو أن تتضمن البيانات عمود timestamp (أو حقلًا زمنيًا مكافئًا)، ويمكن تعريفه عند تهيئة data source في ClickStack UI.

   يفترض ما يلي أن لديك مثيلًا من Vector قيد التشغيل ومهيّأ مسبقًا باستخدام ingest pipelines لتسليم البيانات.

   ​

   أنشئ قاعدة بيانات وجدولًا

   يتطلب Vector تعريف جدول ومخطط قبل استيعاب البيانات.

   أنشئ أولًا قاعدة بيانات. ويمكن تنفيذ ذلك عبر ClickHouse Cloud console.

   على سبيل المثال، أنشئ قاعدة بيانات للسجلات:

   CREATE DATABASE IF NOT EXISTS logs
   

   ثم أنشئ جدولًا يتطابق مخططه مع بنية بيانات السجل لديك. يفترض المثال أدناه تنسيقًا تقليديًا لسجل الوصول في Nginx:

   CREATE TABLE logs.nginx_logs
   (
       `time_local` DateTime,
       `remote_addr` IPv4,
       `remote_user` LowCardinality(String),
       `request` String,
       `status` UInt16,
       `body_bytes_sent` UInt64,
       `http_referer` String,
       `http_user_agent` String,
       `http_x_forwarded_for` LowCardinality(String),
       `request_time` Float32,
       `upstream_response_time` Float32,
       `http_host` String
   )
   ENGINE = MergeTree
   ORDER BY (toStartOfMinute(time_local), status, remote_addr);
   

   يجب أن يتوافق جدولك مع مخطط الإخراج الذي يُنتجه Vector. عدّل المخطط حسب الحاجة لبياناتك، مع اتباع أفضل ممارسات المخطط الموصى بها.

   نوصي بشدة بفهم كيفية عمل المفاتيح الأساسية في ClickHouse واختيار مفتاح ترتيب بناءً على أنماط الوصول لديك. راجع الإرشادات الخاصة بـ ClickStack بشأن اختيار مفتاح أساسي.

   بمجرد إنشاء الجدول، انسخ مقتطف الإعدادات المعروض. عدّل المُدخل لاستهلاك مسارات المعالجة الحالية لديك، وكذلك الجدول الهدف وقاعدة البيانات إذا لزم الأمر. يُفترض أن تكون بيانات الاعتماد مُعبأة مسبقًا.

   

   للمزيد من أمثلة إدخال البيانات باستخدام Vector، راجع “الإدخال باستخدام Vector” أو توثيق ClickHouse sink في Vector للاطلاع على الخيارات المتقدمة.

   
   
3. ​

   الانتقال إلى واجهة ClickStack

   اختر ‘Launch ClickStack’ للوصول إلى واجهة ClickStack ‏(HyperDX). ستتم مصادقتك تلقائيًا وسيُعاد توجيهك.

   OpenTelemetry

   سيتم إنشاء مصادر البيانات مسبقًا لأي بيانات OpenTelemetry.

   

   Vector

   إذا كنت تستخدم Vector، فستحتاج إلى إنشاء مصادر البيانات الخاصة بك. سيُطلب منك إنشاء مصدر بيانات عند أول تسجيل دخول. نعرض أدناه مثالًا على إعداد مصدر بيانات للسجلات.

   

   يفترض هذا الإعداد مخططًا بأسلوب Nginx مع عمود time_local مستخدمًا كطابع زمني. ويُفترض أن يكون هذا، حيثما أمكن، عمود الطابع الزمني المعرَّف في المفتاح الأساسي. هذا العمود إلزامي.

   نوصي أيضًا بتحديث Default SELECT لتحديد الأعمدة التي ستُعرض في عرض السجلات بشكل صريح. وإذا كانت هناك حقول إضافية متاحة، مثل اسم الخدمة أو مستوى السجل أو عمود body، فيمكن إعدادها أيضًا. كما يمكن تجاوز عمود عرض الطابع الزمني إذا كان مختلفًا عن العمود المستخدم في المفتاح الأساسي للجدول والمُعد أعلاه.

   في المثال أعلاه، لا يوجد عمود Body في البيانات. وبدلًا من ذلك، يُعرَّف باستخدام تعبير SQL يعيد تكوين سطر سجل Nginx من الحقول المتاحة.

   للاطلاع على خيارات أخرى ممكنة، راجع مرجع الإعدادات.

   بمجرد إنشائه، ينبغي أن يتم توجيهك إلى عرض البحث حيث يمكنك البدء فورًا في استكشاف بياناتك.

   

   
   

   وهذا كل شيء — لقد أصبحت جاهزًا تمامًا. 🎉

   انطلق واستكشف ClickStack: ابدأ بالبحث في السجلات والتتبعات، واطّلع على كيفية ترابط السجلات والتتبعات والمقاييس في الوقت الفعلي، وأنشئ لوحات المعلومات، واستكشف خرائط الخدمات، واكتشف Event deltas وPatterns، وأعدّ التنبيهات لتبقى سبّاقًا في معالجة المشكلات.

4. ​

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

   سجّل بيانات الاعتماد الافتراضية

   إذا لم تكن قد سجّلت بيانات الاعتماد الافتراضية أثناء الخطوات أعلاه، فانتقل إلى الخدمة واختر Connect، مع تسجيل كلمة المرور ونقاط نهاية HTTP وnative. خزّن بيانات اعتماد المسؤول هذه بأمان، إذ يمكن إعادة استخدامها في الأدلة اللاحقة.

   لتنفيذ مهام مثل توفير مستخدمين جدد أو إضافة المزيد من مصادر البيانات، راجع دليل النشر لـ Managed ClickStack.