> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ربط جلسات bitdrift على الأجهزة المحمولة بتتبعات ClickStack

> اربط جلسات bitdrift على الأجهزة المحمولة بتتبعات الواجهة الخلفية في ClickStack باستخدام سياق التتبع في OpenTelemetry، دون تصدير بيانات الأجهزة المحمولة

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            تكامل شريك
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<PartnerBadge />

<Info>
  **الخلاصة**

  يوضّح هذا الدليل كيفية ربط جلسات bitdrift على الأجهزة المحمولة بآثار التتبع الخلفية المخزّنة مسبقًا في ClickStack، باستخدام سياق تتبع OpenTelemetry. تبقى بيانات القياس عن بُعد للأجهزة المحمولة في bitdrift — ولا يُصدَّر أي شيء إلى ClickStack. ستتعلّم كيفية:

  * تمكين تكاملي الشبكة والتتبع في bitdrift ضمن تطبيقات الأجهزة المحمولة
  * تمكين التتبع لمستأجر bitdrift وتوجيه روابطه العميقة إلى مثيل ClickStack لديك
  * تتبّع معرّف التتبّع من جلسة على جهاز محمول في bitdrift إلى واجهة مستخدم ClickStack ‏(HyperDX)

  يلتقط bitdrift بيانات قياس عن بُعد غنية وغير مأخوذة بعينات على الجهاز المحمول؛ بينما يخزّن ClickStack أثر التتبع الخلفي ويستعلم عنه بمجرد وصول الطلب إلى خدماتك المزوّدة بأدوات OpenTelemetry.

  الوقت المطلوب: 10-15 دقيقة
</Info>

<div id="what-is-bitdrift">
  ## ما هي bitdrift؟
</div>

[bitdrift](https://bitdrift.io/) منصة ديناميكية للرصد، صُممت خصيصًا لتطبيقات الأجهزة المحمولة. وتتألف من ثلاثة مكونات أساسية:

* **[Capture SDK](https://bitdrift.io/feature/performance-centric)**، وهي مكتبة خفيفة ومتعددة المنصات مبنية بلغة Rust، مع أغلفة بسيطة خاصة بكل منصة، تكتب بيانات القياس عن بُعد في مخزن مؤقت حلقي ذي حجم ثابت على الجهاز بدلًا من بثها فورًا.
* **مستوى التحكم**، الذي يحافظ على اتصال دائم ثنائي الاتجاه بكل عميل ويدفع الإعدادات الجديدة في الوقت الفعلي، محددًا ما يُجمع وما يُحمّل.
* **منصة bitdrift**، حيث تحوّل مهام سير العمل والمخططات الزمنية للجلسات والمخططات والمشكلات والتنبيهات بيانات القياس عن بُعد للأجهزة المحمولة إلى إجابات، ويمكن الوصول إليها عبر واجهة الويب وCLI ووكلاء الذكاء الاصطناعي وواجهة برمجة تطبيقات عامة.

تُبقي bitdrift بيانات القياس عن بُعد للأجهزة المحمولة عند الحافة إلى أن تُطلب، ما يتيح للفرق سحب الجلسة الكاملة غير المأخوذ منها عينة التي أدت إلى تعطل أو مشكلة في الأداء، بدلًا من الاعتماد على مجموعة ثابتة من الإشارات المأخوذ منها عينات مسبقًا. تتوفر منصة bitdrift Capture كخدمة SaaS مستضافة من bitdrift، أو كتوزيع «أحضر سحابتك الخاصة» (أو bucket الخاص بك) ضمن حساب AWS الخاص بك.

<Image img="https://mintcdn.com/private-7c7dfe99/3mS6b88R0boYl1UC/images/clickstack/bitdrift/bitdrift-user-journey-dashboard.png?fit=max&auto=format&n=3mS6b88R0boYl1UC&q=85&s=def374455b33795e2574aa193e30ed41" alt="لوحة معلومات User Journey من bitdrift تعرض المسارات المؤدية إلى ANR" size="lg" width="2440" height="1160" data-path="images/clickstack/bitdrift/bitdrift-user-journey-dashboard.png" />

*لوحة معلومات User Journey من bitdrift تعرض المسارات التي يسلكها المستخدمون وصولًا إلى ANR.*

<div id="why-bitdrift-clickstack">
  ## لماذا bitdrift + ClickStack؟
</div>

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

* **يوضح bitdrift ما حدث على الجهاز**: إجراءات المستخدم وحالة التطبيق وطلبات الشبكة والسجلات والأخطاء والأعطال ومؤشرات الأداء وسياق الجلسة المحيط.
* **يوضح ClickStack ما حدث بعد وصول الطلب إلى الواجهة الخلفية**: التتبعات الموزعة وتبعيات الخدمات والسجلات والمقاييس وعمليات قاعدة البيانات وسلوك البنية التحتية.
* **يربط سياق التتبّع في OpenTelemetry بينهما.**

قد يبدأ التحقيق بعملية إتمام شراء فاشلة، أو بطء تحميل شاشة، أو خطأ في المصادقة، أو عطل في bitdrift. ومن طلب الشبكة، يتتبع المهندس معرّف التتبّع إلى ClickStack UI، المدعومة من HyperDX، ويراقب انتقال الطلب عبر الخدمات الخلفية، دون الحاجة إلى إعادة بنائه يدويًا من timestamps متفرقة.

<Tip>
  **النقاط الرئيسية**

  * **يلتقط bitdrift** بيانات القياس عن بُعد غير المأخوذة بالعينات والخاصة بالأجهزة المحمولة عبر تطبيقات الجوال، ويربط معرّفات التتبّع الملتقطة بتتبعاتها الخلفية.
  * **يخزن ClickStack** التتبع الموزع الناتج ويستعلم عنه في ClickHouse ويعرضه في HyperDX.
</Tip>

<div id="prerequisites">
  ## المتطلبات الأساسية
</div>

* تثبيت **ClickStack** وإمكانية الوصول إليه من الخدمات الخلفية لديك، سواء كان مُدارًا ذاتيًا أو على ClickHouse Cloud. راجع [بدء استخدام ClickStack مفتوح المصدر](/docs/ar/clickstack/getting-started/oss) أو [بدء استخدام ClickStack المُدار](/docs/ar/clickstack/getting-started/managed).
* إعداد الخدمات الخلفية لديك باستخدام **OpenTelemetry** لإرسال التتبعات إلى ClickStack. راجع [استيعاب البيانات باستخدام OpenTelemetry](/docs/ar/clickstack/ingesting-data/opentelemetry).
* دمج **bitdrift Capture SDK** في تطبيقك للأجهزة المحمولة. راجع [وثائق bitdrift SDK](https://docs.bitdrift.io/) للحصول على إرشادات التثبيت.
* امتلاك **حساب bitdrift**، مع توفر [الدعم](https://bitdrift.io/contact-us) لتفعيل التتبع لمستأجرك (التتبع ميزة تجريبية تفعّلها bitdrift لكل مستأجر).

<div id="configure-tracing">
  ## تهيئة التتبّع
</div>

تتم التهيئة بالكامل من جانب bitdrift عبر ثلاث خطوات:

1. اطلب من [دعم bitdrift](https://bitdrift.io/contact-us) **تمكين التتبّع للمستأجر لديك وتهيئة الروابط العميقة للتتبّعات إلى مثيل ClickStack ‏(HyperDX) لديك**. إذ توجّه تهيئة الروابط العميقة روابط **View Trace** إلى واجهة ClickStack UI لديك؛ ومن دونها، يُلتقط التتبّع، لكن لا يظهر رابط **View Trace**.
2. **فعّل تكامل الشبكة في bitdrift** لمنصتك، لكي تُمرَّر رؤوس التتبّع مع الطلبات الصادرة.
3. **أضف إجراء سير عمل Start Tracing** لتفعيل التتبّع للجلسات التي تهمك.

للاطلاع على التفاصيل الخاصة بكل منصة لكل خطوة، راجع [كيفية عمل bitdrift وClickStack معًا](https://docs.bitdrift.io/product/integration-partners/clickhouse#how-bitdrift-and-clickstack-work-together) في وثائق bitdrift.

بعد التهيئة، تعرض صفوف سجل المخطط الزمني في bitdrift وعروض النطاقات رابط **View Trace** ينقل معرّف التتبّع الملتقط إلى واجهة ClickStack UI ‏(HyperDX).

<Image img="https://mintcdn.com/private-7c7dfe99/3mS6b88R0boYl1UC/images/clickstack/bitdrift/bitdrift-view-trace.jpg?fit=max&auto=format&n=3mS6b88R0boYl1UC&q=85&s=1fc46073d05ada0d673c6c7e62033576" alt="تتبّع bitdrift مرتبط بتتبّع موزّع في واجهة ClickStack UI" size="lg" width="3977" height="1292" data-path="images/clickstack/bitdrift/bitdrift-view-trace.jpg" />

*اتّباع رابط View Trace من جلسة bitdrift إلى تتبّع موزّع في واجهة ClickStack UI ‏(HyperDX).*

<div id="deployment-flexibility">
  ## مرونة النشر
</div>

يعمل التكامل سواء أكان ClickStack مُدارًا ذاتيًا أم يُشغَّل كخدمة مُدارة على ClickHouse Cloud، لأنه لا يغيّر طريقة وصول البيانات إلى ClickStack. لا يرسل bitdrift بيانات القياس عن بُعد من الأجهزة المحمولة إلى ClickStack، بل يلتقط سياق التتبّع في OpenTelemetry لطلبٍ على الجهاز ويربطه بتتبّع الواجهة الخلفية الذي ترسله بالفعل خدماتك المُزوَّدة بأدوات OpenTelemetry إلى ClickStack. لا يحتاج bitdrift سوى إلى عنوان ClickStack UI ‏(HyperDX) لإنشاء رابط **View Trace**، لذا لا يلزم إجراء أي تغييرات على نشر ClickStack أو مسار استيعاب البيانات فيه.

<div id="next-steps">
  ## الخطوات التالية
</div>

* **تابع تحقيقًا فعليًا** يبدأ من تعطل تطبيق جوّال أو طلب بطيء في bitdrift وينتهي عند تتبّع الواجهة الخلفية في ClickStack
* **أنشئ لوحات معلومات** في ClickStack ‏(HyperDX) للخدمات الخلفية التي يعتمد عليها تطبيقك الجوّال
* **اطّلع على [بيئة sandbox الخاصة بـ bitdrift](https://bitdrift.io/sandbox)** لتتعرّف على تجربة العمل مع Capture
* **ابدأ [تجربة مجانية](https://bitdrift.io/signup)** لإضافة bitdrift إلى تطبيقك الجوّال

<div id="read-more">
  ## اقرأ المزيد
</div>

* [وثائق bitdrift: تكامل ClickHouse](https://docs.bitdrift.io/product/integration-partners/clickhouse)
* [بدء استخدام ClickStack مفتوح المصدر](/docs/ar/clickstack/getting-started/oss)
* [استيعاب البيانات باستخدام OpenTelemetry](/docs/ar/clickstack/ingesting-data/opentelemetry)