إرسال OpenTelemetry إلى ClickStack عبر Bindplane

توجيه بيانات القياس عن بُعد إلى ClickStack باستخدام Bindplane للإدارة المركزية للمجمّع

باختصار

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

• إعداد ClickStack كوجهة في Bindplane
• إنشاء تهيئة لمعالجة بيانات القياس عن بُعد وتوجيهها
• نشر التهيئات عن بُعد إلى مجمّعات OTel وبدء جمع البيانات
• عرض بيانات القياس عن بُعد في ClickStack

يجمع هذا التكامل بين الاستيعاب عالي الأداء في ClickStack والإدارة المركزية للمجمّعات في Bindplane، ما يسهّل توسيع observability من دون أعباء تشغيلية إضافية.

الوقت المطلوب: 10-15 دقيقة

​

ما هو Bindplane؟

Bindplane هو مسار بيانات القياس عن بُعد مبني على OpenTelemetry يوفّر إدارة مركزية لـ OpenTelemetry مجمّعات. وهو يبسّط تشغيل أعداد كبيرة من وحدات مجمّع من خلال توفير تحرير مرئي للإعدادات، وعمليات نشر تدريجي آمنة، وذكاء المسارات.

​

لماذا Bindplane + ClickStack؟

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

يعالج Bindplane ذلك من خلال توفير:

• إدارة مركزية لـ OpenTelemetry Collectors، من الآلاف إلى أكثر من مليون
• تحرير مرئي للإعدادات مع عمليات طرح آمنة بنقرة واحدة
• اكتشاف تلقائي للموارد وإثراء يُطبَّقان بشكل متسق قبل وصول البيانات إلى ClickStack
• التوجيه المتشعّب، بحيث يمكن إرسال تدفقات بيانات القياس عن بُعد نفسها إلى ClickStack ووجهات أخرى في الوقت نفسه
• رؤية كاملة لخط المعالجة، بما في ذلك صحة المجمعات ومعدل النقل والأداء من طرف إلى طرف

أهم النقاط

• يتعامل ClickStack مع أحجام استيعاب هائلة، وتخزين واسع النطاق، واستعلامات تحليلية سريعة
• يدير Bindplane مسار الاستيعاب والتعقيد التشغيلي لتشغيل أساطيل المجمعات

​

المتطلبات الأساسية

• مثيل ClickStack قيد التشغيل (محليًا، أو على الخادم، أو على ClickHouse Cloud)
• حساب على Bindplane (أنشئ حسابًا على app.bindplane.com)
• تثبيت Bindplane OTel مجمّع (راجع تثبيت أول مجمّع لك)
• توفّر اتصال شبكي من مجمّعات Bindplane إلى نقطة نهاية OTLP الخاصة بـ ClickStack
• مفتاح API لإدخال البيانات في ClickStack (يمكن العثور عليه في ClickStack Team Settings > API Keys، راجع الوثائق هنا)
• فتح منافذ الشبكة المناسبة (4318 لـ HTTP/s أو 4317 لـ gRPC)

​

دمج ClickStack مع Bindplane

1. ​

   تهيئة ClickStack كوجهة

   1. سجّل الدخول إلى حسابك في Bindplane
   2. انتقل إلى Library
   3. انقر على Add Destination
   4. اختر ClickStack من قائمة الوجهات المتاحة
   5. هيّئ الاتصال:
      • Protocol: اختر HTTP أو gRPC (الافتراضي: HTTP على المنفذ 4318)
      • Hostname: أدخل اسم مضيف نقطة نهاية OTLP الخاصة بـ ClickStack أو عنوان IP
      • Port: أدخل المنفذ (4318 لـ HTTP و4317 لـ gRPC)
      • API Ingestion Key: أدخل مفتاح API لإدخال البيانات الخاص بـ ClickStack
   6. سمِّ الوجهة (على سبيل المثال: “ClickStack Production”)
   7. انقر على Save لإنشاء الوجهة

   أهم النقاط

   تدعم وجهة ClickStack بروتوكولي HTTP وgRPC. وفي السيناريوهات ذات الأحجام الكبيرة، يُنصح باستخدام gRPC مع الضغط (gzip أو zstd أو snappy) للحصول على أداء أفضل.

2. ​

   إنشاء تهيئة

   بعد تهيئة وجهة ClickStack، أنشئ تهيئة لمعالجة بيانات القياس عن بُعد وتوجيهها:

   1. انتقل إلى Configurations → Create Configuration
   2. امنح التهيئة اسمًا (على سبيل المثال: “ClickStack Pipeline”)
   3. اختر Collector Type وPlatform لعملية النشر لديك
   4. أضف المصادر:
      • انقر على Add Source للاختيار من بين أكثر من 80 مصدرًا متاحًا
      • للاختبار، يمكنك إضافة مصدر لمولّد بيانات القياس عن بُعد لمحاكاة الحركة
      • في بيئة الإنتاج، أضف مصادر بيانات القياس عن بُعد الفعلية لديك (السجلات والمقاييس والتتبعات)
   5. أضف وجهة ClickStack:
      • انقر على Add Destination
      • اختر وجهة ClickStack التي أنشأتها في الخطوة السابقة
      • اختر أنواع بيانات القياس عن بُعد التي تريد إرسالها (Logs أو Metrics أو Traces أو جميعها)

   أهم النقاط

   يمكنك إضافة معالجات للتصفية وأخذ العينات والإخفاء والإثراء والتجميع على دفعات وغير ذلك، لتشكيل بيانات القياس عن بُعد قبل وصولها إلى ClickStack. ويضمن ذلك وصول بيانات متسقة ومنظمة إلى ClickHouse.

3. ​

   إضافة المعالجات (اختياري)

   يوفّر Bindplane إمكانات pipeline intelligence وتوصيات للمعالجات. يمكنك إضافة معالجات من أجل:

   • Filter: تقليل حجم البيانات عبر استبعاد بيانات القياس عن بُعد غير الضرورية
   • Sample: تطبيق استراتيجيات أخذ العينات على التتبعات ذات الحجم الكبير
   • Enrich: إضافة resource attributes أو labels أو metadata
   • Transform: تعديل بنية بيانات القياس عن بُعد أو محتواها
   • Batch: تحسين أحجام الدُفعات لتحقيق نقل أكثر كفاءة

   تُطبَّق هذه المعالجات بشكل متسق على جميع المجمّعات لديك قبل وصول البيانات إلى ClickStack.

4. ​

   نشر المجمّعات وبدء الطرح

   1. أضف مجمّعًا (BDOT Collector) إلى التهيئة الخاصة بك:

      • انتقل إلى Agents في Bindplane
      • ثبّت مجمّع Bindplane على أنظمتك المستهدفة باتباع تعليمات التثبيت الخاصة بـ Bindplane
      • سيظهر المجمّع في قائمة المجمّعات لديك بمجرد اتصاله

   2. عيّن التهيئة إلى المجمّعات لديك:

      • اختر المجمّعات التي تريد استخدامها
      • عيّن إليها تهيئة ClickStack الخاصة بك

   3. ابدأ عملية طرح:

      • انقر على Start Rollout لنشر التهيئة
      • سيتحقق Bindplane من التهيئة قبل طرحها
      • راقب حالة الطرح في واجهة Bindplane

   أهم النقاط

   يوفّر Bindplane عمليات طرح آمنة بنقرة واحدة مع التحقق. ويمكنك مراقبة صحة المجمّعات ومعدل النقل وأي أخطاء في الوقت الفعلي من خلال واجهة Bindplane.

5. ​

   التحقق من بيانات القياس عن بُعد في ClickStack

   بمجرد طرح التهيئة، تبدأ بيانات القياس عن بُعد بالتدفق إلى ClickStack من مجموعة المجمّعات المُدارة لديك:

   1. سجّل الدخول إلى مثيل ClickStack لديك (واجهة HyperDX)
   2. انتقل إلى مستكشف Logs أو Metrics أو Traces
   3. ينبغي أن ترى بيانات القياس عن بُعد الواردة من المجمّعات التي يديرها Bindplane
   4. تكون البيانات التي تصل إلى ClickStack مُثرّاة ومنظمة مسبقًا بواسطة معالجات Bindplane

​

التهيئة المتقدمة

​

التوجيه المتشعّب

يدعم Bindplane التوجيه المتشعّب، ما يتيح لك إرسال تدفقات بيانات القياس عن بُعد نفسها إلى وجهات متعددة في الوقت نفسه. يمكنك:

• إرسال logs وmetrics وtraces إلى ClickStack للتخزين طويل الأمد والتحليل
• توجيه البيانات نفسها إلى منصات observability أخرى للتنبيه في الوقت الفعلي
• إعادة توجيه بيانات القياس عن بُعد محددة إلى منصات SIEM لتحليل الأمان

يُضبط ذلك بإضافة وجهات متعددة إلى تهيئة الخاصة بـ Bindplane.

​

الضغط والأداء

في السيناريوهات ذات الحجم المرتفع، قم بتكوين الضغط في وجهة ClickStack لديك:

• HTTP: يدعم gzip وdeflate وsnappy وzstd أو none (الافتراضي: gzip)
• gRPC: يدعم gzip وsnappy وzstd أو none (الافتراضي: gzip)

يقلل الضغط من استهلاك عرض النطاق الترددي عند إرسال بيانات القياس عن بُعد إلى ClickStack، وهو مهم خصوصًا عند التشغيل على نطاق واسع.

​

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

الآن بعد أن أصبحت بيانات القياس عن بُعد تتدفق من Bindplane إلى ClickStack، يمكنك:

• إنشاء لوحات معلومات: أنشئ مرئيات في ClickStack (HyperDX) للسجلات والمقاييس والتتبعات
• إعداد التنبيهات: اضبط التنبيهات في ClickStack للحالات الحرجة
• توسيع نطاق النشر: أضف المزيد من المجمّعات والمصادر مع تزايد احتياجات observability لديك
• تحسين مسار المعالجة: استخدم ميزة pipeline intelligence في Bindplane لتحديد فرص التحسين

​

اطّلع على المزيد

• تكامل ClickStack في وثائق Bindplane