> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# إدخال البيانات إلى ClickStack

> نظرة عامة على إدخال البيانات إلى ClickStack

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

تُدخَل جميع البيانات إلى ClickStack Open Source أو Managed ClickStack عبر **OpenTelemetry (OTel) collector**. ويُعدّ هذا المكوّن نقطة الإدخال الأساسية للسجلات والمقاييس والتتبعات وبيانات الجلسات.

يكمن الفرق الرئيسي بين المعماريتين في موضع استضافة المكوّنات. ففي كلتا الحالتين، تشغّل OpenTelemetry Collector لتلقّي بيانات telemetry من تطبيقاتك. ومع ClickStack Open Source، تتولى أيضًا بنفسك إدارة واستضافة كلٍّ من ClickHouse وواجهة ClickStack (HyperDX). أما مع Managed ClickStack، فتُستضاف ClickHouse وواجهة HyperDX وتُداران داخل ClickHouse Cloud، مع توفير المصادقة المتكاملة والإدارة التشغيلية نيابةً عنك.

<Tabs>
  <Tab title="Managed ClickStack">
    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-managed-architecture-with-flow.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=a488ce11bc7a96a8f5386943a4e24d71" alt="معمارية مُدارة مع التدفق" size="md" width="1024" height="730" data-path="images/use-cases/observability/clickstack-managed-architecture-with-flow.png" />
  </Tab>

  <Tab title="Open Source ClickStack">
    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-oss-architecture-with-flow.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=7b8b8dac930d6d179a46730899797a16" alt="معمارية بسيطة مع التدفق" size="md" width="1024" height="730" data-path="images/use-cases/observability/clickstack-oss-architecture-with-flow.png" />
  </Tab>
</Tabs>

في كلا نموذجي النشر، يوفّر الـ collector نقطتي نهاية OTLP:

* **HTTP** - المنفذ `4318`
* **gRPC** - المنفذ `4317`

يمكنك إرسال البيانات إلى نقطتي النهاية هاتين إما مباشرةً من [language SDKs](/ar/clickstack/ingesting-data/sdks/index) أو من وكلاء جمع بيانات متوافقين مع OTel، مثل OTel collectors أخرى تجمع مقاييس البنية التحتية والسجلات.

وبشكل أكثر تحديدًا:

* [**Language SDKs**](/ar/clickstack/ingesting-data/sdks/index) مسؤولة عن جمع بيانات telemetry من داخل تطبيقك — وبالأخص **التتبعات** و**السجلات** — وتصدير هذه البيانات إلى OpenTelemetry collector عبر نقطة نهاية OTLP، التي تتولى إدخالها إلى ClickHouse. ولمزيد من التفاصيل حول language SDKs المتاحة مع ClickStack، راجع [SDKs](/ar/clickstack/ingesting-data/sdks/index).

* **وكلاء جمع البيانات** هم وكلاء يُنشرون عند الحافة — على الخوادم أو عُقد Kubernetes أو إلى جانب التطبيقات. ويجمعون بيانات telemetry الخاصة بالبنية التحتية (مثل السجلات والمقاييس)، أو يستقبلون الأحداث مباشرةً من التطبيقات المزوّدة بـ SDKs. وفي هذه الحالة، يعمل الوكيل على المضيف نفسه الذي يعمل عليه التطبيق، وغالبًا ما يكون على هيئة sidecar أو مجموعة شياطين. ويعيد هؤلاء الوكلاء توجيه البيانات إلى ClickStack OTel collector المركزي، الذي يعمل كبوابة [gateway](/ar/clickstack/ingesting-data/collector#collector-roles)، ويُنشر عادةً مرة واحدة لكل cluster أو مركز بيانات أو Region. وتتلقى [gateway](/ar/clickstack/ingesting-data/collector#collector-roles) أحداث OTLP من الوكلاء أو التطبيقات، وتتولى إدخالها إلى ClickHouse. راجع [OTel collector](/ar/clickstack/ingesting-data/collector) لمزيد من التفاصيل. ويمكن أن تكون هذه الوكلاء نُسخًا أخرى من OTel collector أو تقنيات بديلة مثل [Fluentd](https://www.fluentd.org/) أو [Vector](https://vector.dev/).

<Info>
  **التوافق مع OpenTelemetry**

  رغم أن ClickStack يوفّر language SDKs خاصة به وOpenTelemetry مخصّصًا مع بيانات telemetry وميزات محسّنة، يمكنك أيضًا استخدام OpenTelemetry SDKs والوكلاء الحاليين لديك بسلاسة.
</Info>