Skip to main content
باختصاريوضّح لك هذا الدليل كيفية إرسال telemetry إلى ClickStack من OpenTelemetry Collectors التي تديرها Telflo. ستتعلّم كيفية:
  • إنشاء تهيئة collector في المحرر المرئي لـ Telflo أو باستخدام CLI
  • إرسال telemetry إلى ClickStack مفتوح المصدر أو Managed ClickStack، أو كتابتها مباشرةً في ClickHouse
  • نشر التهيئة عن بُعد على أسطول من collectors
  • التأكد من وصول telemetry إلى ClickStack أو إلى جداول ClickHouse الخاصة بك
الوقت المطلوب: 15-20 دقيقة

​
ما هو Telflo؟

Telflo هو control plane محايد تجاه المزوّدين لـ OpenTelemetry Collectors، ويوفّر إدارة مركزية لتهيئة collector عبر أسطول كامل. وهو يجعل الأساطيل الكبيرة سهلة الإدارة عبر محرر مرئي، واختبارات pipeline، ونشر التهيئة عن بُعد. ويدير Telflo إصدارات builds القياسية من upstream لـ OpenTelemetry collector، دون أي distribution خاص بـ Telflo ودون أي agent مملوك، وبذلك تبقى الـ collectors التي تشغّلها فرقك بالفعل على الـ build نفسه. ويمكن أيضاً الوصول إلى Telflo من خارج المتصفح عبر واجهة سطر الأوامر. وبدمج ذلك مع ClickStack MCP server، يصبح بإمكان الـ agent نفسه الذي يستعلم عن الـ telemetry أن يُصلح الـ pipeline الذي أنتجها.

​
لماذا Telflo + ClickStack؟

يتولى ClickStack استقبال البيانات وتخزينها وتنفيذ الاستعلامات التحليلية بأحجام كبيرة. أما Telflo فيدير مركزيًا أسطول OpenTelemetry Collectors الذي يغذّيه، عبر المضيفات والعناقيد والمناطق. يوفّر Telflo:
  • إدارة مركزية لـ OpenTelemetry Collectors عبر المضيفات والحاويات وKubernetes
  • تحريرًا مرئيًا لمسارات البيانات، مع طرح مُحكم للأسطول بأكمله أو لمجموعة واحدة
  • التحقق من التغييرات باستخدام عيّنة من بيانات القياس قبل وصولها إلى المجمّعات في بيئة الإنتاج
  • توجيه بيانات القياس نفسها إلى ClickStack وإلى وجهات أخرى في الوقت ذاته
  • رؤية شاملة للأسطول: أي المجمّعات متصلة، وما الذي يشغّله كل منها، وأيها انحرف عن الإعداد المعتمد
أهم النقاط
  • يستقبل ClickStack البيانات ويخزّنها ويستعلم عنها على نطاق واسع
  • يدير Telflo أسطول المجمّعات الذي يغذّيه

​
المتطلبات المسبقة

  • وجهة: Open Source ClickStack، أو Managed ClickStack، أو نسخة ClickHouse ذاتية الإدارة
  • حساب Telflo (أنشئ حسابًا على telflo.com)
  • مكان لتشغيل الـ collectors: جهاز افتراضي أو عنقود Kubernetes
  • Open Source ClickStack: نقطة نهاية OTLP الخاصة بـ ClickStack (المنفذ 4318 لـ HTTP و4317 لـ gRPC) ومفتاح واجهة برمجة التطبيقات الخاص بالاستيعاب، وتجده في HyperDX ضمن Team Settings → API Keys (راجع الوثائق هنا)
  • Managed ClickStack: نقطة نهاية خدمة ClickHouse Cloud الخاصة بك (المنفذ 8443) ومستخدم للاستيعاب (راجع إنشاء مستخدم للاستيعاب)
  • ClickHouse ذاتي الإدارة: نقطة نهاية ClickHouse الخاصة بك، وقاعدة بيانات لـ جداول ClickStack، ومستخدم قادر على إنشائها والكتابة فيها (راجع إنشاء مستخدم للاستيعاب)
  • اتصال شبكي من الـ collectors إلى نقطة نهاية ClickStack أو ClickHouse الخاصة بك

​
دمج ClickStack مع Telflo

1

إنشاء تهيئة لـ collector

  1. سجّل الدخول إلى Telflo. في قائمة Configurations، انقر على New Configuration، ثم Blank configuration.
  2. في Name Your Configuration، أدخل اسمًا وانقر على Create.
  3. أضف مكوّنات receivers: اسحب واحدًا من لوحة المكوّنات إلى مساحة العمل لكل نوع من بيانات telemetry التي تجمعها.
  4. أضف مكوّنات processors: Memory Limiter وBatch، إلى جانب أي مكوّنات أخرى تحتاجها لتشكيل البيانات قبل خروجها من الـ collector. راجع القائمة الكاملة لمكوّنات processors التي يدعمها Telflo.
2

أضِف المُصدِّر

تستخدم المسارات الثلاثة جميعها المحرر نفسه، وخطوة النشر نفسها، والأسطول نفسه؛ ولا يختلف بينها سوى المُصدِّر. اختر علامة التبويب المناسبة لطريقة النشر لديك: يستقبل ClickStack مفتوح المصدر بيانات OTLP باستخدام مفتاح استيعاب؛ أما ClickStack المُدار وClickHouse ذاتي الإدارة فيستقبلان عمليات كتابة مباشرة إلى جداول ClickStack.
  1. اسحب مُصدِّر OTLP/HTTP إلى لوحة العمل.
  2. اضبط Endpoint على نقطة نهاية OTLP HTTP الخاصة بـ ClickStack، على سبيل المثال http://clickstack.example.com:4318.
  3. ضمن HTTP Headers، انقر على Add header، ثم أدخل authorization في Header name و${env:CLICKSTACK_INGESTION_KEY} في Header value. يطلب Telflo هذه القيمة عند تثبيت المجمّعات، لذا لا يُخزَّن المفتاح مطلقًا في التهيئة.
أما مع gRPC، فاستخدم مُصدِّر OTLP على المنفذ 4317 مع الترويسة نفسها ضمن gRPC Metadata Headers.
ارسم الأسهم (edges) من المستقبلات (receivers) مروراً بالمعالجات (processors) وصولاً إلى المُصدِّر (exporter)، بواقع pipeline واحد لكل إشارة. ويعرض صف الـ status إما config valid أو عدد الأخطاء التي يلزم إصلاحها، بينما يعرض تبويب YAML الإعداد (configuration) المُولَّد.قبل نشر أي شيء، يمكنك تمرير عيّنة من بيانات التتبع (telemetry) عبر التكوين والتحقق من الناتج في الطرف الآخر. راجع الاختبار في Telflo. أو بدلاً من ذلك، يمكنك وصف ما تريد تحقيقه، فيقوم مساعد الذكاء الاصطناعي في Telflo، الذي يُفتح بزر AI في شريط الأدوات، ببناء التكوين والتحقق من صحته واختباره نيابةً عنك. ويمكن للوكيل (agent) الخاص بك القيام بالأمر نفسه عبر واجهة سطر أوامر Telflo.
3

نشر إصدار

انقر على Publish في شريط الأدوات. الإصدارات المنشورة للقراءة فقط؛ وللمتابعة في إجراء التعديلات، انقر على Create New Version.
4

أنشئ مجموعة وابدأ النشر

  1. انتقل إلى Fleet، وانقر على New Fleet، ثم اختر المكان الذي تعمل فيه collectors، سواء على أجهزة افتراضية أو في Kubernetes. أدخل Name وانقر على Create fleet.
  2. من تبويب Deploy Groups الخاص بالـ fleet، انقر على Assign في مجموعة Default واختر الـ configuration المنشورة والإصدار.
  3. انقر على Install في المجموعة، وأدخل قيمة لكل environment variable تشير إليه الـ configuration؛ فيضيفها Telflo إلى أمر التثبيت. نفّذ هذا الأمر في المكان الذي يُفترض أن تعمل فيه collectors، متّبعًا تعليمات التثبيت الخاصة بـ Telflo. ويحمل هذا الأمر install token الخاص بالـ fleet إلى جانب القيم التي أدخلتها، لذا تعامل معه كمعلومة حسّاسة.
  4. في تبويب Collectors، تُبلّغ collectors عن الحالة Pending pickup، ثم Applying، ثم In sync.
لتنفيذ rollout لتغيير ما، انشر إصدارًا جديدًا وأسنِده إلى المجموعة؛ وللرجوع إلى الوضع السابق، أسنِد إصدارًا سبق نشره.
5

تحقّق من بيانات التتبّع

افتح HyperDX وابحث عن إحدى خدماتك في عرض Search؛ واستخدم Chart Explorer للمقاييس. أما مع Managed ClickStack، فافتح خدمتك في وحدة تحكم ClickHouse Cloud وانقر على Launch ClickStack. وفي حالة ClickHouse ذاتي الإدارة، استعلم جداول ClickStack مباشرةً، على سبيل المثال SELECT ServiceName, count() FROM otel_logs GROUP BY ServiceName.

​
التكوين المتقدم

​
التوجيه المتعدد (Fan-out routing)

يمكن إرسال بيانات القياس نفسها في الوقت ذاته إلى ClickStack للتخزين طويل الأجل، وإلى منصة أخرى أثناء عملية الترحيل، وإلى نظام SIEM لتحليل الأمان. أضِف المُصدِّرات (exporters) على لوحة العمل واربطها بالـ pipelines التي ينبغي أن تغذّيها، أو ابدأ من pipeline جاهز في مكتبة المسارات الخاصة بـ Telflo.

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

  • مُصدِّرا OTLP/HTTP وOTLP: أبقِ Compression على gzip.
  • ClickHouse exporter: أبقِ Async Insert مفعّلًا، واترك Compression على lz4، وأضِف معالج Batch قبله في السلسلة. راجع تحسين عمليات الإدراج.

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

  • إنشاء لوحات المعلومات: أنشئ تصورات في HyperDX للسجلات والمقاييس والتتبعات
  • إعداد التنبيهات: هيّئ التنبيهات في ClickStack للحالات الحرجة
  • التحسين بمساعد الذكاء الاصطناعي: اطلب منه تعديل خط معالجة بيانات أو اقتراح اختبارات
  • الانتقال من مزوّد آخر: تغطي flows عملية التحويل، إذ تحلّ محل الوكلاء الموجودين بالفعل في أسطولك وترسل البيانات بشكل مزدوج إلى كلتا الواجهتين الخلفيتين أثناء مقارنتك بينهما

​
اقرأ المزيد

آخر تعديل في ٢٦ سبتمبر ٢٠٢٦