> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.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>;
};

أسهل طريقة للبدء هي نشر **Managed ClickStack** على **ClickHouse Cloud**، الذي يوفّر واجهة خلفية آمنة ومُدارة بالكامل مع الاحتفاظ بتحكّم كامل في الاستيعاب، والمخطط، ومسارات عمل observability. وهذا يلغي الحاجة إلى تشغيل ClickHouse بنفسك ويقدّم مجموعة من المزايا:

* التوسّع التلقائي لقدرات المعالجة بشكل مستقل عن التخزين
* احتفاظ منخفض التكلفة وغير محدود عمليًا استنادًا إلى تخزين الكائنات
* إمكانية عزل أعباء عمل القراءة والكتابة بشكل مستقل باستخدام warehouses.
* مصادقة متكاملة
* نسخ احتياطية مؤتمتة
* ميزات الأمان والامتثال
* ترقيات سلسة

<Steps>
  <Step>
    ## التسجيل في ClickHouse Cloud

    لإنشاء خدمة Managed ClickStack في [ClickHouse Cloud](https://console.clickhouse.cloud)، أكمل أولًا **الخطوة الأولى** من [دليل البدء السريع لـ ClickHouse Cloud](/ar/get-started/setup/cloud).

    <Info>
      **Scale مقابل Enterprise**

      نوصي باستخدام [فئة Scale](/ar/products/cloud/features/cloud-tiers) لمعظم أعباء عمل ClickStack. اختر فئة Enterprise إذا كنت بحاجة إلى ميزات أمان متقدمة مثل SAML أو CMEK أو التوافق مع HIPAA. كما توفّر ملفات تعريف عتادية مخصّصة لعمليات نشر ClickStack الكبيرة جدًا. في هذه الحالات، نوصي بالتواصل مع الدعم.
    </Info>

    حدّد موفّر Cloud والمنطقة.

    <img src="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/7bmhpXp9q5MTUEeP/images/clickstack/getting-started/region_resources.png?fit=max&auto=format&n=7bmhpXp9q5MTUEeP&q=85&s=512efa6f59ca581495e86aa37d96e510" alt="" width="1544" height="1322" data-path="images/clickstack/getting-started/region_resources.png" />

    عند تحديد CPU والذاكرة، قدِّر ذلك بناءً على معدل نقل إدخال البيانات المتوقع في ClickStack. يوفّر الجدول أدناه إرشادات لتحديد حجم هذه الموارد.

    | حجم إدخال البيانات الشهري | موارد الحوسبة الموصى بها |
    | ------------------------- | ------------------------ |
    | \< 10 TB / شهر            | 2 vCPU × 3 نسخ متماثلة   |
    | 10–50 TB / شهر            | 4 vCPU × 3 نسخ متماثلة   |
    | 50–100 TB / شهر           | 8 vCPU × 3 نسخ متماثلة   |
    | 100–500 TB / شهر          | 30 vCPU × 3 نسخ متماثلة  |
    | 1 PB+ / شهر               | 59 vCPU × 3 نسخ متماثلة  |

    تستند هذه التوصيات إلى الافتراضات التالية:

    * يشير حجم البيانات إلى **حجم إدخال البيانات غير المضغوط** شهريًا، وينطبق على كلٍّ من السجلات وآثار التتبع.
    * تُعد أنماط الاستعلام نموذجية لحالات استخدام المراقبة، إذ تستهدف معظم الاستعلامات **البيانات الحديثة**، وعادةً آخر 24 ساعة.
    * يكون إدخال البيانات **منتظمًا نسبيًا على مدار الشهر**. إذا كنت تتوقع حركة مرور متقطعة أو ارتفاعات مفاجئة، فينبغي توفير هامش سعة إضافي.
    * تُدار السعة التخزينية بشكل منفصل عبر تخزين الكائنات في ClickHouse Cloud، وليست عاملًا مقيِّدًا لفترة الاحتفاظ بالبيانات. ونفترض أن البيانات المحتفَظ بها لفترات أطول يُجرى الوصول إليها على نحو غير متكرر.

    قد تكون هناك حاجة إلى موارد حوسبة أكبر لأنماط الوصول التي تستعلم بانتظام عن نطاقات زمنية أطول، أو تُجري عمليات تجميع كثيفة، أو تدعم عددًا كبيرًا من المستخدمين المتزامنين.

    على الرغم من أن نسختين متماثلتين يمكن أن تلبّيا متطلبات CPU والذاكرة لمعدل إدخال بيانات معيّن، فإننا نوصي باستخدام ثلاث نسخ متماثلة حيثما أمكن لتحقيق السعة الإجمالية نفسها وتحسين التكرار في الخدمة.

    <Note>
      هذه القيم **تقديرية فقط** ويجب استخدامها كخط أساس أولي. تعتمد المتطلبات الفعلية على تعقيد الاستعلامات، والتزامن، وسياسات الاحتفاظ، والتباين في معدل نقل إدخال البيانات. راقب دائمًا استخدام الموارد وقم بالتوسعة حسب الحاجة.
    </Note>

    بمجرد تحديد المتطلبات، ستستغرق خدمة Managed ClickStack الخاصة بك عدة دقائق لإتمام التجهيز. لا تتردد في استكشاف بقية [ClickHouse Cloud console](/ar/products/cloud/getting-started/intro) أثناء انتظار اكتمال التجهيز.

    بمجرد **اكتمال التجهيز، سيتم تفعيل خيار 'ClickStack' في القائمة اليسرى**.
  </Step>

  <Step>
    ## إعداد الاستيعاب

    بعد توفير خدمتك، تأكد من تحديد الخدمة ثم انقر على "ClickStack" من القائمة اليمنى.

    <img src="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/7bmhpXp9q5MTUEeP/images/clickstack/getting-started/start_ingestion.png?fit=max&auto=format&n=7bmhpXp9q5MTUEeP&q=85&s=cc23a9b61a4bbe1c88b34f73c47c71c6" alt="" width="3600" height="1890" data-path="images/clickstack/getting-started/start_ingestion.png" />

    اختر "Start Ingestion"، وسيُطلب منك تحديد مصدر للاستيعاب. يدعم Managed ClickStack كلاً من OpenTelemetry و[Vector](https://vector.dev/) باعتبارهما المصدرين الرئيسيين للاستيعاب. ومع ذلك، يمكن للمستخدمين أيضًا إرسال البيانات مباشرةً إلى ClickHouse ضمن المخطط الخاص بهم باستخدام أي من [التكاملات التي يدعمها ClickHouse Cloud](/ar/integrations/home).

    <img src="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/7bmhpXp9q5MTUEeP/images/clickstack/getting-started/select_source.png?fit=max&auto=format&n=7bmhpXp9q5MTUEeP&q=85&s=05b18ab2ac51833cd2b7da7e1852c96e" alt="" width="3600" height="1890" data-path="images/clickstack/getting-started/select_source.png" />

    <Info>
      **يُنصح باستخدام OpenTelemetry**

      يُنصح بشدة باستخدام OpenTelemetry كتنسيق للاستيعاب.
      فهو يوفّر أبسط تجربة وأكثرها كفاءة، مع مخططات جاهزة صُممت خصيصًا للعمل بكفاءة مع ClickStack.
    </Info>

    <Tabs>
      <Tab title="OpenTelemetry">
        لإرسال بيانات OpenTelemetry إلى Managed ClickStack، يُنصح باستخدام OpenTelemetry Collector. يعمل الـ collector كبوابة تستقبل بيانات OpenTelemetry من تطبيقاتك (ومن collectors أخرى) وتُمرّرها إلى ClickHouse Cloud.

        إذا لم يكن لديك collector قيد التشغيل بالفعل، فابدأ تشغيله باتباع الخطوات أدناه. وإذا كانت لديك collectors موجودة، فستجد أيضًا مثالًا على التهيئة.

        ### ابدأ collector

        يفترض ما يلي المسار الموصى به، وهو استخدام **توزيعة ClickStack من OpenTelemetry Collector**، التي تتضمن معالجة إضافية ومُحسّنة خصيصًا لـ ClickHouse Cloud. إذا كنت تريد استخدام OpenTelemetry Collector الخاص بك، فراجع ["تهيئة collectors الموجودة."](#configure-existing-collectors)

        للبدء بسرعة، انسخ أمر Docker الموضّح وشغّله.

        <img src="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/7bmhpXp9q5MTUEeP/images/clickstack/getting-started/otel_collector_start.png?fit=max&auto=format&n=7bmhpXp9q5MTUEeP&q=85&s=4825bc0c196bffea16c9f1d0145317ec" alt="" width="1452" height="408" data-path="images/clickstack/getting-started/otel_collector_start.png" />

        يجب أن يتضمن هذا الأمر بيانات اعتماد الاتصال الخاصة بك مُعبأة مسبقًا.

        <Info>
          **النشر إلى بيئة production**

          رغم أن هذا الأمر يستخدم المستخدم `default` للاتصال بـ Managed ClickStack، ينبغي لك إنشاء مستخدم مخصص عند [الانتقال إلى بيئة production](/ar/clickstack/managing/production#create-a-database-ingestion-user-managed) وتعديل التهيئة الخاصة بك.
        </Info>

        يؤدي تشغيل هذا الأمر الواحد إلى بدء ClickStack collector مع إتاحة OTLP endpoints على المنفذين 4317 ‏(gRPC) و4318 ‏(HTTP). إذا كان لديك بالفعل instrumentation وagents لـ OpenTelemetry، فيمكنك البدء فورًا في إرسال بيانات telemetry إلى هذه endpoints.

        ### تهيئة collectors الموجودة

        يمكنك أيضًا تهيئة OpenTelemetry Collectors الموجودة لديك أو استخدام التوزيعة الخاصة بك من collector.

        <Info>
          **يتطلب ClickHouse exporter**

          إذا كنت تستخدم التوزيعة الخاصة بك، مثل [contrib image](https://github.com/open-telemetry/opentelemetry-collector-contrib)، فتأكد من أنها تتضمن [ClickHouse exporter](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/clickhouseexporter).
        </Info>

        ولهذا الغرض، نوفّر مثالًا على تهيئة OpenTelemetry Collector يستخدم ClickHouse exporter مع الإعدادات المناسبة ويُفعّل OTLP receivers. تتوافق هذه التهيئة مع الواجهات والسلوك المتوقعين من توزيعة ClickStack.

        <ExampleOTelConfig />

        <img src="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/7bmhpXp9q5MTUEeP/images/clickstack/getting-started/otel_collector_start.png?fit=max&auto=format&n=7bmhpXp9q5MTUEeP&q=85&s=4825bc0c196bffea16c9f1d0145317ec" alt="" width="1452" height="408" data-path="images/clickstack/getting-started/otel_collector_start.png" />

        لمزيد من التفاصيل حول تهيئة OpenTelemetry collectors، راجع ["إدخال البيانات باستخدام OpenTelemetry."](/ar/clickstack/ingesting-data/opentelemetry)

        ### ابدأ إدخال البيانات (اختياري)

        إذا كانت لديك تطبيقات أو بنية تحتية قائمة تريد تزويدها بأدوات OpenTelemetry، فانتقل إلى الأدلة ذات الصلة المرتبطة من خلال UI.

        لتزويد تطبيقاتك بالأدوات لجمع traces وlogs، استخدم [language SDKs المدعومة](/ar/clickstack/ingesting-data/sdks/index) التي ترسل البيانات إلى OpenTelemetry Collector الخاص بك، والذي يعمل كبوابة لإدخالها إلى Managed ClickStack.

        يمكن [جمع السجلات باستخدام OpenTelemetry Collectors](/ar/clickstack/integration-examples/host-logs) التي تعمل في وضع agent، مع إعادة توجيه البيانات إلى collector نفسها. ولمراقبة Kubernetes، اتبع [الدليل المخصص](/ar/clickstack/integration-examples/kubernetes). وللتكاملات الأخرى، راجع [أدلة البدء السريع](/ar/clickstack/integration-examples/index) الخاصة بنا.

        ### بيانات تجريبية

        بدلًا من ذلك، إذا لم تكن لديك بيانات موجودة، فجرّب إحدى مجموعات البيانات النموذجية لدينا.

        * [مجموعة بيانات نموذجية](/ar/clickstack/example-datasets/sample-data) - حمّل مجموعة بيانات نموذجية من العرض التجريبي العام الخاص بنا. شخّص مشكلة بسيطة.
        * [الملفات المحلية وmetrics](/ar/clickstack/example-datasets/local-data) - حمّل ملفات محلية وراقب النظام على OSX أو Linux باستخدام OTel collector محلي.

        <br />
      </Tab>

      <Tab title="متجه">
        [Vector](https://vector.dev) هو مسار بيانات observability عالي الأداء ومحايد للمورّدين، ويشتهر بشكل خاص باستيعاب السجلات بفضل مرونته وانخفاض استهلاكه للموارد.

        عند استخدام Vector مع ClickStack، يكون المستخدمون مسؤولين عن تحديد المخططات الخاصة بهم. وقد تتبع هذه المخططات اصطلاحات OpenTelemetry، لكنها قد تكون أيضًا مخصّصة بالكامل لتمثيل بنى أحداث يحدّدها المستخدم.

        <Info>
          **الطابع الزمني مطلوب**

          الشرط الصارم الوحيد في Managed ClickStack هو أن تتضمن البيانات **عمود timestamp** (أو حقلًا زمنيًا مكافئًا)، ويمكن تعريفه عند تهيئة data source في ClickStack UI.
        </Info>

        يفترض ما يلي أن لديك مثيلًا من Vector قيد التشغيل ومهيّأ مسبقًا باستخدام ingest pipelines لتسليم البيانات.

        ### أنشئ قاعدة بيانات وجدولًا

        يتطلب Vector تعريف جدول ومخطط قبل استيعاب البيانات.

        أنشئ أولًا قاعدة بيانات. ويمكن تنفيذ ذلك عبر [ClickHouse Cloud console](/ar/products/cloud/features/sql-console-features/sql-console).

        على سبيل المثال، أنشئ قاعدة بيانات للسجلات:

        ```sql theme={null}
        CREATE DATABASE IF NOT EXISTS logs
        ```

        ثم أنشئ جدولًا يتطابق مخططه مع بنية بيانات السجل لديك. يفترض المثال أدناه تنسيقًا تقليديًا لسجل الوصول في Nginx:

        ```sql theme={null}
        CREATE TABLE logs.nginx_logs
        (
            `time_local` DateTime,
            `remote_addr` IPv4,
            `remote_user` LowCardinality(String),
            `request` String,
            `status` UInt16,
            `body_bytes_sent` UInt64,
            `http_referer` String,
            `http_user_agent` String,
            `http_x_forwarded_for` LowCardinality(String),
            `request_time` Float32,
            `upstream_response_time` Float32,
            `http_host` String
        )
        ENGINE = MergeTree
        ORDER BY (toStartOfMinute(time_local), status, remote_addr);
        ```

        يجب أن يتوافق جدولك مع مخطط الإخراج الذي يُنتجه Vector. عدّل المخطط حسب الحاجة لبياناتك، مع اتباع [أفضل ممارسات المخطط الموصى بها](/ar/concepts/best-practices/select-data-type).

        نوصي بشدة بفهم كيفية عمل [المفاتيح الأساسية](/ar/concepts/core-concepts/primary-indexes) في ClickHouse واختيار مفتاح ترتيب بناءً على أنماط الوصول لديك. راجع الإرشادات [الخاصة بـ ClickStack](/ar/clickstack/managing/performance-tuning#choosing-a-primary-key) بشأن اختيار مفتاح أساسي.

        بمجرد إنشاء الجدول، انسخ مقتطف الإعدادات المعروض. عدّل المُدخل لاستهلاك مسارات المعالجة الحالية لديك، وكذلك الجدول الهدف وقاعدة البيانات إذا لزم الأمر. يُفترض أن تكون بيانات الاعتماد مُعبأة مسبقًا.

        <img src="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/7bmhpXp9q5MTUEeP/images/clickstack/getting-started/vector_config.png?fit=max&auto=format&n=7bmhpXp9q5MTUEeP&q=85&s=a8a09700f0f0296f26f5c94968560576" alt="" width="3600" height="1890" data-path="images/clickstack/getting-started/vector_config.png" />

        للمزيد من أمثلة إدخال البيانات باستخدام Vector، راجع ["الإدخال باستخدام Vector"](/ar/clickstack/ingesting-data/vector) أو [توثيق ClickHouse sink في Vector](https://vector.dev/docs/reference/configuration/sinks/clickhouse/) للاطلاع على الخيارات المتقدمة.

        <br />
      </Tab>
    </Tabs>
  </Step>

  <Step>
    ## الانتقال إلى واجهة ClickStack

    اختر 'Launch ClickStack' للوصول إلى واجهة ClickStack ‏(HyperDX). ستتم مصادقتك تلقائيًا وسيُعاد توجيهك.

    <Tabs>
      <Tab title="OpenTelemetry">
        سيتم إنشاء مصادر البيانات مسبقًا لأي بيانات OpenTelemetry.

        <img src="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/7bmhpXp9q5MTUEeP/images/clickstack/getting-started/clickstack_managed_ui.png?fit=max&auto=format&n=7bmhpXp9q5MTUEeP&q=85&s=ed5267f122a35d3393c4a275cf5888d5" alt="" width="3600" height="1870" data-path="images/clickstack/getting-started/clickstack_managed_ui.png" />
      </Tab>

      <Tab title="Vector">
        إذا كنت تستخدم Vector، فستحتاج إلى إنشاء مصادر البيانات الخاصة بك. سيُطلب منك إنشاء مصدر بيانات عند أول تسجيل دخول. نعرض أدناه مثالًا على إعداد مصدر بيانات للسجلات.

        <img src="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Sr_JUhB6DLeeNQJ0/images/clickstack/create-vector-datasource.png?fit=max&auto=format&n=Sr_JUhB6DLeeNQJ0&q=85&s=445ed0d2e6b2c660054ab6080c2bda65" alt="" width="3600" height="1938" data-path="images/clickstack/create-vector-datasource.png" />

        يفترض هذا الإعداد مخططًا بأسلوب Nginx مع عمود `time_local` مستخدمًا كطابع زمني. ويُفترض أن يكون هذا، حيثما أمكن، عمود الطابع الزمني المعرَّف في المفتاح الأساسي. **هذا العمود إلزامي**.

        نوصي أيضًا بتحديث `Default SELECT` لتحديد الأعمدة التي ستُعرض في عرض السجلات بشكل صريح. وإذا كانت هناك حقول إضافية متاحة، مثل اسم الخدمة أو مستوى السجل أو عمود body، فيمكن إعدادها أيضًا. كما يمكن تجاوز عمود عرض الطابع الزمني إذا كان مختلفًا عن العمود المستخدم في المفتاح الأساسي للجدول والمُعد أعلاه.

        في المثال أعلاه، لا يوجد عمود `Body` في البيانات. وبدلًا من ذلك، يُعرَّف باستخدام تعبير SQL يعيد تكوين سطر سجل Nginx من الحقول المتاحة.

        للاطلاع على خيارات أخرى ممكنة، راجع [مرجع الإعدادات](/ar/clickstack/managing/config).

        بمجرد إنشائه، ينبغي أن يتم توجيهك إلى عرض البحث حيث يمكنك البدء فورًا في استكشاف بياناتك.

        <img src="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/7bmhpXp9q5MTUEeP/images/clickstack/getting-started/clickstack_managed_ui.png?fit=max&auto=format&n=7bmhpXp9q5MTUEeP&q=85&s=ed5267f122a35d3393c4a275cf5888d5" alt="" width="3600" height="1870" data-path="images/clickstack/getting-started/clickstack_managed_ui.png" />
      </Tab>
    </Tabs>

    <br />

    وهذا كل شيء — لقد أصبحت جاهزًا تمامًا. 🎉

    انطلق واستكشف ClickStack: ابدأ بالبحث في السجلات والتتبعات، واطّلع على كيفية ترابط السجلات والتتبعات والمقاييس في الوقت الفعلي، وأنشئ لوحات المعلومات، واستكشف خرائط الخدمات، واكتشف Event deltas وPatterns، وأعدّ التنبيهات لتبقى سبّاقًا في معالجة المشكلات.
  </Step>

  <Step>
    ## الخطوات التالية

    <Warning>
      **سجّل بيانات الاعتماد الافتراضية**

      إذا لم تكن قد سجّلت بيانات الاعتماد الافتراضية أثناء الخطوات أعلاه، فانتقل إلى الخدمة واختر `Connect`، مع تسجيل كلمة المرور ونقاط نهاية HTTP وnative. خزّن بيانات اعتماد المسؤول هذه بأمان، إذ يمكن إعادة استخدامها في الأدلة اللاحقة.
    </Warning>

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Sr_JUhB6DLeeNQJ0/images/_snippets/service_connect.png?fit=max&auto=format&n=Sr_JUhB6DLeeNQJ0&q=85&s=6c4f9dce776c5af991dfa0e109cba1c2" size="lg" alt="الاتصال بالخدمة" border width="3200" height="2125" data-path="images/_snippets/service_connect.png" />

    لتنفيذ مهام مثل توفير مستخدمين جدد أو إضافة المزيد من مصادر البيانات، راجع [دليل النشر لـ Managed ClickStack](/ar/clickstack/deployment/managed#additional-tasks).
  </Step>
</Steps>