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

# بدء استخدام ClickStack Open Source

> شغّل ClickStack Open Source محليًا، وأرسل بيانات اختبار، وتأكد من نجاح الاستيعاب

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>;
};

شغّل ClickStack Open Source محليًا، وأرسل حدثًا اختباريًا عبر OpenTelemetry Collector الخاص به، ثم تأكد من ظهور الحدث في ClickStack UI.

باستخدام ClickStack Open Source، تتولى تشغيل وإدارة الواجهة الخلفية لـ ClickHouse وClickStack UI وخط أنابيب الاستيعاب. تجمع صورة الكل في واحد هذه المكونات مع MongoDB في حاوية Docker واحدة للتقييم والاختبار محليًا.

<Tip>
  تتوفر أيضًا نسخة مُدارة من ClickStack — راجع [Managed ClickStack](/ar/clickstack/getting-started/managed).
</Tip>

تستخدم الخطوات أدناه صورة الكل في واحد التي تتطلب مصادقة. إذا أردت واجهة مستخدم محلية دون إنشاء حساب، فاتبع [دليل الوضع المحلي باستخدام Docker](/ar/clickstack/deployment/local-mode-only) بدلًا من ذلك.

<div id="before-you-begin">
  ## قبل البدء
</div>

ثبّت [Docker](https://docs.docker.com/get-docker/) وتأكد من إتاحة المنافذ التالية:

* `8080` لـ ClickStack UI
* `4317` لبروتوكول OTLP عبر gRPC
* `4318` لبروتوكول OTLP عبر HTTP
* `8123` لواجهة ClickHouse HTTP

لأحمال العمل المستمرة أو أحمال عمل الإنتاج، راجع [خيارات النشر مفتوحة المصدر](/ar/clickstack/deployment/oss) و[الانتقال إلى بيئة الإنتاج](/ar/clickstack/managing/production).

<div id="set-up-clickstack-open-source">
  ## إعداد ClickStack Open Source باستخدام صورة الكل في واحد
</div>

<Steps titleSize="h3">
  <Step title="بدء ClickStack" id="deploy-stack-with-docker">
    شغّل صورة الكل في واحد:

    ```shell theme={null}
    docker run \
      --name clickstack \
      -p 8123:8123 \
      -p 8080:8080 \
      -p 4317:4317 \
      -p 4318:4318 \
      clickhouse/clickstack-all-in-one:latest
    ```

    تعمل الحاوية في الواجهة الأمامية. اترك هذه الواجهة الطرفية مفتوحة واستخدم واجهة طرفية ثانية لتنفيذ الأوامر المتبقية في هذا الدليل.

    <Accordion title="الاحتفاظ بالبيانات والإعدادات">
      للاحتفاظ بإعدادات ClickStack وبيانات ClickHouse وسجلات ClickHouse بعد إزالة الحاوية، شغّل الأمر التالي بدلًا من ذلك:

      ```shell theme={null}
      docker run \
        --name clickstack \
        -p 8123:8123 \
        -p 8080:8080 \
        -p 4317:4317 \
        -p 4318:4318 \
        -v "$(pwd)/.volumes/db:/data/db" \
        -v "$(pwd)/.volumes/ch_data:/var/lib/clickhouse" \
        -v "$(pwd)/.volumes/ch_logs:/var/log/clickhouse-server" \
        clickhouse/clickstack-all-in-one:latest
      ```

      يشير `$(pwd)` إلى دليلك الحالي. يخزّن هذا الأمر الملفات الدائمة في دليل `.volumes` ضمن ذلك الموقع.
    </Accordion>
  </Step>

  <Step title="فتح ClickStack" id="navigate-to-hyperdx-ui">
    بعد بدء ClickStack، افتح [http://localhost:8080](http://localhost:8080) وأنشئ حسابًا.

    يتصل ClickStack تلقائيًا بمثيل ClickHouse المضمّن وينشئ مصادر بيانات للسجلات والتتبعات والمقاييس والجلسات.

    #### نسخ مفتاح API للاستيعاب

    في قسم **بدء الاستخدام** ضمن القائمة اليسرى، اختر **إضافة بيانات**، ثم انسخ **مفتاح API للاستيعاب**. يجب أن تتضمن بيانات القياس عن بُعد المُرسلة إلى OpenTelemetry Collector المضمّن هذا المفتاح في ترويسة `authorization`.
  </Step>

  <Step title="إرسال بيانات اختبار" id="send-test-data">
    في الواجهة الطرفية الثانية، صدّر مفتاح API للاستيعاب:

    ```shell theme={null}
    export CLICKSTACK_API_KEY=<your_ingestion_api_key>
    ```

    أرسل سجل OTLP بالطابع الزمني الحالي:

    ```shell theme={null}
    NOW_NANO="$(date +%s)000000000"

    curl -i "http://localhost:4318/v1/logs" \
      -H "Content-Type: application/json" \
      -H "authorization: ${CLICKSTACK_API_KEY}" \
      --data-binary @- <<EOF
    {
      "resourceLogs": [{
        "resource": {
          "attributes": [{
            "key": "service.name",
            "value": {"stringValue": "clickstack-docs-test"}
          }]
        },
        "scopeLogs": [{
          "scope": {"name": "clickstack-docs-test"},
          "logRecords": [{
            "timeUnixNano": "${NOW_NANO}",
            "severityText": "INFO",
            "body": {"stringValue": "ClickStack ingestion test"}
          }]
        }]
      }]
    }
    EOF
    ```

    يعيد الطلب الناجح `HTTP/1.1 200 OK`.
  </Step>

  <Step title="تأكيد الاستيعاب" id="confirm-ingestion">
    افتح عرض **Search** في ClickStack وابحث عن `ClickStack ingestion test`.

    يجب أن تتضمن النتيجة حدث الاختبار باسم الخدمة `clickstack-docs-test`.

    <Image img="https://mintcdn.com/private-7c7dfe99-trino-dialect/yEEl6qs9WF6UaX4A/images/clickstack/getting-started/clickstack_ingestion_test_oss.webp?fit=max&auto=format&n=yEEl6qs9WF6UaX4A&q=85&s=daa25e27c8b338c09905261a30c78b4a" size="lg" alt="عرض سجلات ClickStack Open Source يُظهر حدث اختبار استيعاب ClickStack" border width="3838" height="1984" data-path="images/clickstack/getting-started/clickstack_ingestion_test_oss.webp" />
  </Step>
</Steps>

لديك الآن مثيل ClickStack محلي ونقطة نهاية استيعاب عاملة وحدث اختبار يمكنك فحصه في ClickStack.

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

<div id="send-application-and-infrastructure-data">
  ### إرسال بيانات التطبيق والبنية التحتية
</div>

اختر الدليل المناسب للبيانات التي تريد إرسالها إلى ClickStack:

<CardGroup cols={2}>
  <Card title="إضافة القياس عن بُعد إلى تطبيق" icon="code" href="/ar/clickstack/ingesting-data/sdks/index">
    أرسل تتبعات التطبيق وسجلاته باستخدام SDK متوافق مع OpenTelemetry.
  </Card>

  <Card title="جمع سجلات المضيف" icon="server" href="/ar/clickstack/integration-examples/host-logs">
    أعد توجيه سجلات المضيف من OpenTelemetry Collector يعمل بدور الوكيل.
  </Card>

  <Card title="مراقبة Kubernetes" icon="cubes" href="/ar/clickstack/integration-examples/kubernetes">
    اجمع السجلات والمقاييس والتتبعات من عنقود Kubernetes.
  </Card>

  <Card title="استكشاف عمليات التكامل الأخرى" icon="plug" href="/ar/clickstack/integration-examples/index">
    اعثر على أدلة لتطبيقات ومصادر بيانات قياس عن بُعد إضافية.
  </Card>
</CardGroup>

<div id="explore-sample-data">
  ### استكشاف بيانات نموذجية
</div>

استخدم مجموعة بيانات نموذجية لاستكشاف ClickStack ببيانات قياس عن بُعد أغنى:

<CardGroup cols={2}>
  <Card title="سجلات وتتبّع ومقاييس نموذجية" href="/ar/clickstack/example-datasets/sample-data">
    <img src="https://mintcdn.com/private-7c7dfe99-trino-dialect/yEEl6qs9WF6UaX4A/images/clickstack/example-trace-dashboard.webp?fit=max&auto=format&n=yEEl6qs9WF6UaX4A&q=85&s=36ac72137ebd6b3678c20d365fb2f6d6" alt="" width="1919" height="969" data-path="images/clickstack/example-trace-dashboard.webp" />

    حمّل البيانات من العرض التوضيحي العام وشخّص مشكلة.
  </Card>

  <Card title="السجلات والمقاييس المحلية" href="/ar/clickstack/example-datasets/local-data">
    <img src="https://mintcdn.com/private-7c7dfe99-trino-dialect/V_i7rF59rG-XogPH/images/clickstack/host-logs/host-logs-dashboard.webp?fit=max&auto=format&n=V_i7rF59rG-XogPH&q=85&s=afeba8a19ad65ebb99f39c7308b2ac04" alt="" width="3808" height="1908" data-path="images/clickstack/host-logs/host-logs-dashboard.webp" />

    اجمع الملفات المحلية ومقاييس النظام على macOS أو Linux.
  </Card>
</CardGroup>

لاستكشاف البيانات المحمّلة مسبقًا دون تثبيت Docker، استخدم [العرض التوضيحي المستضاف لـ ClickStack](/ar/clickstack/example-datasets/remote-demo-data).

<div id="generate-synthetic-data">
  ### إنشاء بيانات اصطناعية
</div>

استخدم مولِّدًا لاختبار استيعاب البيانات دون الحاجة إلى تطبيق أو مجموعة بيانات موجودة:

<CardGroup cols={2}>
  <Card title="إنشاء بيانات باستخدام otelgen" icon="terminal" href="/ar/clickstack/example-datasets/otelgen">
    أرسل دفعة قصيرة من سجلات OTLP وتتبّع والمقاييس الاصطناعية.
  </Card>

  <Card title="إنشاء بيانات باستخدام telemetrygen" icon="terminal" href="/ar/clickstack/example-datasets/telemetrygen">
    أنشئ إشارات OpenTelemetry قابلة للتهيئة عبر عدة خدمات.
  </Card>
</CardGroup>

اطّلع على [جميع البيانات النموذجية والعروض التوضيحية لـ ClickStack](/ar/clickstack/example-datasets/index).

<div id="prepare-for-production">
  ### الاستعداد للإنتاج
</div>

راجع إرشادات النشر والإنتاج قبل استخدام ClickStack لأحمال عمل مستمرة:

<CardGroup cols={2}>
  <Card title="الانتقال إلى بيئة الإنتاج" icon="shield" href="/ar/clickstack/managing/production">
    راجع بيانات اعتماد الاستيعاب والأمان والاستبقاء والإرشادات التشغيلية.
  </Card>

  <Card title="اختر نموذج النشر" icon="server" href="/ar/clickstack/deployment/oss">
    قارن خيارات النشر مفتوحة المصدر المناسبة لبيئتك.
  </Card>
</CardGroup>