> ## 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.

# HyperDX فقط

> نشر HyperDX فقط

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

صُمِّم هذا الخيار للحالات التي يكون لديك فيها بالفعل مثيل ClickHouse قيد التشغيل ومملوء ببيانات observability أو بيانات الأحداث.

يمكن استخدام HyperDX بشكل مستقل عن بقية المكدس، وهو متوافق مع أي مخطط بيانات، وليس OpenTelemetry (OTel) فقط. وهذا يجعله مناسبًا لخطوط أنابيب observability المخصّصة المبنية مسبقًا على ClickHouse.

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

في هذا الوضع، تُترك عملية إدخال البيانات بالكامل للمستخدم. يمكنك إدخال البيانات إلى ClickHouse باستخدام OpenTelemetry Collector المستضاف لديك، أو عبر الإدخال المباشر من مكتبات العميل، أو محركات الجداول الأصلية في ClickHouse (مثل Kafka أو S3)، أو خطوط أنابيب ETL، أو خدمات الإدخال المُدارة مثل ClickPipes. يوفّر هذا النهج أقصى قدر من المرونة، وهو مناسب للفرق التي تُشغّل ClickHouse بالفعل وتريد إضافة HyperDX فوقه لأغراض التصور والبحث والتنبيه.

<div id="suitable-for">
  ### مناسب لـ
</div>

* مستخدمو ClickHouse الحاليون
* مسارات معالجة الأحداث المخصّصة

<div id="deployment-steps">
  ## خطوات النشر
</div>

<br />

<Steps>
  <Step>
    ### النشر باستخدام Docker

    شغّل الأمر التالي مع تعديل `YOUR_MONGODB_URI` حسب الحاجة.

    ```shell theme={null}
    docker run -e MONGO_URI=mongodb://YOUR_MONGODB_URI -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx
    ```
  </Step>

  <Step>
    ### الانتقال إلى HyperDX UI

    انتقل إلى [http://localhost:8080](http://localhost:8080) للوصول إلى HyperDX UI.

    أنشئ مستخدمًا وأدخل اسم مستخدم وكلمة مرور يستوفيان المتطلبات.

    عند النقر على `Create`، سيُطلب منك إدخال تفاصيل الاتصال.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-login.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=eec6e42744553cd8881cf9c9ada74166" alt="واجهة HyperDX" size="lg" width="3600" height="1900" data-path="images/use-cases/observability/hyperdx-login.png" />
  </Step>

  <Step>
    ### إكمال تفاصيل الاتصال

    اتصل بـ ClickHouse cluster خارجي خاص بك، مثل ClickHouse Cloud.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-2.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=90882c718a44526d13c819ab7218a9d0" alt="تسجيل الدخول إلى HyperDX" size="md" width="1966" height="1392" data-path="images/use-cases/observability/hyperdx-2.png" />

    إذا طُلب منك إنشاء source، فاحتفظ بجميع القيم الافتراضية وأكمل الحقل `Table` بالقيمة `otel_logs`. ينبغي اكتشاف جميع الإعدادات الأخرى تلقائيًا، ما يتيح لك النقر على `Save New Source`.

    <Info>
      **إنشاء source**

      يتطلب إنشاء source وجود جداول في ClickHouse. إذا لم تكن لديك بيانات، فنوصي بنشر ClickStack OpenTelemetry collector لإنشاء الجداول.
    </Info>
  </Step>
</Steps>

<div id="using-docker-compose">
  ## استخدام Docker Compose
</div>

يمكنك تعديل [إعداد Docker Compose](/ar/clickstack/deployment/docker-compose) لتحقيق النتيجة نفسها الواردة في هذا الدليل، مع إزالة OTel collector ومثيل ClickHouse من ملف الـmanifest.

<div id="otel-collector">
  ## ClickStack OpenTelemetry collector
</div>

حتى إذا كنت تدير OpenTelemetry Collector الخاص بك بصورة مستقلة عن بقية المكونات في المكدس، فإننا نوصي مع ذلك باستخدام توزيعة ClickStack من OpenTelemetry Collector. فهذا يضمن استخدام المخطط الافتراضي واتباع أفضل الممارسات لعملية إدخال البيانات.

للاطلاع على تفاصيل نشر OpenTelemetry Collector مستقل وتهيئته، راجع ["استيعاب البيانات باستخدام OpenTelemetry"](/ar/clickstack/ingesting-data/collector#modifying-otel-collector-configuration).

<div id="schema-choice-map-vs-json">
  ## اختيار المخطط: Map مقابل JSON
</div>

يخزّن ClickStack السمات في أعمدة `Map(LowCardinality(String), String)` افتراضيًا. هذا هو المخطط الموصى به لأعباء عمل Observability. وعند دمجه مع [تسلسل map المقسّم إلى buckets](/ar/reference/data-types/map#bucketed-map-serialization) وفهارس النص على مفاتيح map وقيمه، فإنه يوفّر عمليات بحث انتقائية من دون الكلفة الإضافية لإدخال كل مفتاح على حدة كما في JSON subcolumns الديناميكية.

يتوفر مخطط من النوع `JSON` في مرحلة بيتا للتقييم على أعباء العمل التي تتضمن مجموعة صغيرة ومستقرة من مفاتيح السمات. وهو **غير موصى به** كخيار افتراضي. راجع [Map مقابل نوع JSON](/ar/clickstack/ingesting-data/schema/map-vs-json) للاطلاع على المقارنة الكاملة ومتغيرات البيئة المطلوبة لتمكين دعم JSON.