> ## 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 - حزمة ClickHouse للمراقبة

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

خيارات الإعداد التالية متاحة لكل مكوّن من مكوّنات ClickStack:

<div id="modifying-settings">
  ## إعدادات التوزيعات مفتوحة المصدر
</div>

<div id="docker">
  ### Docker
</div>

إذا كنت تستخدم [الكل في واحد](/ar/clickstack/deployment/all-in-one) أو [HyperDX فقط](/ar/clickstack/deployment/hyperdx-only) أو [الوضع المحلي](/ar/clickstack/deployment/local-mode-only)، فيكفي تمرير الإعداد المطلوب عبر متغير بيئة، مثلًا.

```shell theme={null}
docker run  -e HYPERDX_LOG_LEVEL='debug' -p 8080:8080 -p 4317:4317 -p 4318:4318 clickhouse/clickstack-all-in-one:latest
```

<div id="docker-compose">
  ### Docker Compose
</div>

إذا كنت تستخدم دليل النشر الخاص بـ [Docker Compose](/ar/clickstack/deployment/docker-compose)، فيمكن استخدام ملف [`.env`](https://github.com/hyperdxio/hyperdx/blob/main/.env) لتعديل الإعدادات.

بدلًا من ذلك، يمكنك استبدال الإعدادات صراحةً في ملف [`docker-compose.yaml`](https://github.com/hyperdxio/hyperdx/blob/main/docker-compose.yml)، على سبيل المثال.

مثال:

```yaml theme={null}
services:
  app:
    environment:
      HYPERDX_API_KEY: ${HYPERDX_API_KEY}
      HYPERDX_LOG_LEVEL: ${HYPERDX_LOG_LEVEL}
      # ... other settings
```

<div id="helm">
  ### Helm
</div>

<div id="customizing-values">
  #### تخصيص القيم (اختياري)
</div>

يمكنك تخصيص الإعدادات باستخدام وسيطات `--set`، على سبيل المثال:

```shell theme={null}
helm install my-hyperdx hyperdx/hdx-oss-v2 \
  --set replicaCount=2 \
  --set resources.limits.cpu=500m \
  --set resources.limits.memory=512Mi \
  --set resources.requests.cpu=250m \
  --set resources.requests.memory=256Mi \
  --set ingress.enabled=true \
  --set ingress.annotations."kubernetes\.io/ingress\.class"=nginx \
  --set ingress.hosts[0].host=hyperdx.example.com \
  --set ingress.hosts[0].paths[0].path=/ \
  --set ingress.hosts[0].paths[0].pathType=ImplementationSpecific \
  --set env[0].name=CLICKHOUSE_USER \
  --set env[0].value=abc
```

بدلًا من ذلك، عدّل ملف `values.yaml`. لاسترجاع القيم الافتراضية:

```shell theme={null}
helm show values hyperdx/hdx-oss-v2 > values.yaml
```

مثال على التهيئة:

```yaml theme={null}
replicaCount: 2
resources:
  limits:
    cpu: 500m
    memory: 512Mi
  requests:
    cpu: 250m
    memory: 256Mi
ingress:
  enabled: true
  annotations:
    kubernetes.io/ingress.class: nginx
  hosts:
    - host: hyperdx.example.com
      paths:
        - path: /
          pathType: ImplementationSpecific
  env:
    - name: CLICKHOUSE_USER
      value: abc
```

<div id="hyperdx">
  ## تطبيق ClickStack UI (HyperDX)
</div>

<div id="datasource-settings">
  ### إعدادات مصدر البيانات
</div>

تتطلب واجهة ClickStack UI من المستخدم تحديد مصدر لكل نوع/ركيزة من أنواع بيانات Observability:

* `Logs`
* `Traces`
* `Metrics`
* `Sessions`

يمكن إجراء هذا الإعداد من داخل التطبيق عبر `Team Settings -> Sources`، كما هو موضح أدناه للسجلات:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-25.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=ffe7619e6828d84c7f1dfe6f896c17a0" alt="إعداد مصدر HyperDX" size="md" width="3600" height="1856" data-path="images/use-cases/observability/hyperdx-25.png" />

يتطلب كل مصدر من هذه المصادر تحديد جدول واحد على الأقل عند الإنشاء، بالإضافة إلى مجموعة من الأعمدة التي تتيح لـ HyperDX الاستعلام عن البيانات.

إذا كنت تستخدم [مخطط OpenTelemetry (OTel) الافتراضي](/ar/guides/use-cases/observability/build-your-own/integrating-opentelemetry#out-of-the-box-schema) المرفق مع ClickStack، فيمكن استنتاج هذه الأعمدة تلقائيًا لكل مصدر. أما عند [تعديل المخطط](#clickhouse) أو استخدام مخطط مخصص، فيجب على المستخدمين تحديد هذه التعيينات وتحديثها.

<Note>
  المخطط الافتراضي لـ ClickHouse المرفق مع ClickStack هو المخطط الذي ينشئه [ClickHouse exporter for the OTel collector](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/clickhouseexporter). وتتوافق أسماء هذه الأعمدة مع مواصفة OTel الرسمية الموثقة [هنا](https://opentelemetry.io/docs/specs/otel/logs/data-model/).
</Note>

الإعدادات التالية متاحة لكل مصدر:

<div id="logs">
  #### السجلات
</div>

| Setting                          | Description                                                                                                                                   | Required | Inferred in Default Schema | Inferred Value                                     |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | -------- | -------------------------- | -------------------------------------------------- |
| `Name`                           | اسم المصدر.                                                                                                                                   | نعم      | لا                         | –                                                  |
| `Section`                        | تسمية اختيارية لتجميع المصادر في محدد المصادر. تظهر المصادر التي تشترك في القسم نفسه معًا، كما يطابق البحث اسم القسم بالإضافة إلى اسم المصدر. | لا       | لا                         | –                                                  |
| `Server Connection`              | اسم اتصال الخادم.                                                                                                                             | نعم      | لا                         | `Default`                                          |
| `Database`                       | اسم قاعدة بيانات ClickHouse.                                                                                                                  | نعم      | نعم                        | `default`                                          |
| `Table`                          | اسم الجدول الهدف. اضبطه على `otel_logs` إذا كان المخطط الافتراضي مستخدمًا.                                                                    | نعم      | لا                         |                                                    |
| `Timestamp Column`               | عمود DateTime أو تعبير يكون جزءًا من المفتاح الأساسي لديك.                                                                                    | نعم      | نعم                        | `TimestampTime`                                    |
| `Default Select`                 | الأعمدة المعروضة في نتائج البحث الافتراضية.                                                                                                   | نعم      | نعم                        | `Timestamp`, `ServiceName`, `SeverityText`, `Body` |
| `Service Name Expression`        | تعبير أو عمود لاسم الخدمة.                                                                                                                    | نعم      | نعم                        | `ServiceName`                                      |
| `Log Level Expression`           | تعبير أو عمود لمستوى السجل.                                                                                                                   | نعم      | نعم                        | `SeverityText`                                     |
| `Body Expression`                | تعبير أو عمود لرسالة السجل.                                                                                                                   | نعم      | نعم                        | `Body`                                             |
| `Log Attributes Expression`      | تعبير أو عمود لسمات السجل المخصصة.                                                                                                            | نعم      | نعم                        | `LogAttributes`                                    |
| `Resource Attributes Expression` | تعبير أو عمود للسمات على مستوى المورد.                                                                                                        | نعم      | نعم                        | `ResourceAttributes`                               |
| `Displayed Timestamp Column`     | عمود الطابع الزمني المستخدم للعرض في UI.                                                                                                      | نعم      | نعم                        | `ResourceAttributes`                               |
| `Correlated Metric Source`       | مصدر مقاييس مرتبط (مثل مقاييس HyperDX).                                                                                                       | لا       | لا                         | –                                                  |
| `Correlated Trace Source`        | مصدر تتبّع مرتبط (مثل تتبعات HyperDX).                                                                                                        | لا       | لا                         | –                                                  |
| `Trace Id Expression`            | تعبير أو عمود يُستخدم لاستخراج trace ID.                                                                                                      | نعم      | نعم                        | `TraceId`                                          |
| `Span Id Expression`             | تعبير أو عمود يُستخدم لاستخراج span ID.                                                                                                       | نعم      | نعم                        | `SpanId`                                           |
| `Implicit Column Expression`     | العمود المستخدم في full-text search إذا لم يتم تحديد أي حقل (بنمط Lucene). ويكون عادةً log body.                                              | نعم      | نعم                        | `Body`                                             |
| `Highlighted Attributes`         | تعبيرات أو أعمدة تُعرض عند فتح تفاصيل السجل. ستُعرض التعبيرات التي تُرجع عناوين URL كروابط.                                                   | لا       | لا                         | –                                                  |
| `Highlighted Trace Attributes`   | تعبيرات أو أعمدة تُستخرج من كل سجل في trace، وتُعرض فوق trace waterfall. ستُعرض التعبيرات التي تُرجع عناوين URL كروابط.                       | لا       | لا                         | –                                                  |

<div id="traces">
  #### التتبعات
</div>

| الإعداد                          | الوصف                                                                                                                                         | مطلوب | يُستدل عليه في المخطط الافتراضي | القيمة المُستدل عليها                                                                                 |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `Name`                           | اسم المصدر.                                                                                                                                   | نعم   | لا                              | –                                                                                                     |
| `Section`                        | تسمية اختيارية لتجميع المصادر في محدد المصادر. تظهر المصادر التي تشترك في القسم نفسه معًا، كما يطابق البحث اسم القسم بالإضافة إلى اسم المصدر. | لا    | لا                              | –                                                                                                     |
| `Server Connection`              | اسم اتصال الخادم.                                                                                                                             | نعم   | لا                              | `Default`                                                                                             |
| `Database`                       | اسم قاعدة بيانات ClickHouse.                                                                                                                  | نعم   | نعم                             | `default`                                                                                             |
| `Table`                          | اسم الجدول الهدف. اضبطه على `otel_traces` إذا كنت تستخدم المخطط الافتراضي.                                                                    | نعم   | نعم                             | -                                                                                                     |
| `Timestamp Column`               | عمود DateTime أو تعبير يكون جزءًا من المفتاح الأساسي.                                                                                         | نعم   | نعم                             | `Timestamp`                                                                                           |
| `Timestamp`                      | اسم مستعار لـ `Timestamp Column`.                                                                                                             | نعم   | نعم                             | `Timestamp`                                                                                           |
| `Default Select`                 | الأعمدة التي تظهر في نتائج البحث الافتراضية.                                                                                                  | نعم   | نعم                             | `Timestamp, ServiceName as service, StatusCode as level, round(Duration / 1e6) as duration, SpanName` |
| `Duration Expression`            | تعبير لحساب مدة الـ span.                                                                                                                     | نعم   | نعم                             | `Duration`                                                                                            |
| `Duration Precision`             | دقة تعبير المدة (مثل النانوثانية أو الميكروثانية).                                                                                            | نعم   | نعم                             | ns                                                                                                    |
| `Trace Id Expression`            | تعبير أو عمود لمعرّفات التتبّع.                                                                                                               | نعم   | نعم                             | `TraceId`                                                                                             |
| `Span Id Expression`             | تعبير أو عمود لمعرّفات الـ span.                                                                                                              | نعم   | نعم                             | `SpanId`                                                                                              |
| `Parent Span Id Expression`      | تعبير أو عمود لمعرّفات الـ span الأصلية.                                                                                                      | نعم   | نعم                             | `ParentSpanId`                                                                                        |
| `Span Name Expression`           | تعبير أو عمود لأسماء الـ span.                                                                                                                | نعم   | نعم                             | `SpanName`                                                                                            |
| `Span Kind Expression`           | تعبير أو عمود لنوع الـ span (مثل client أو server).                                                                                           | نعم   | نعم                             | `SpanKind`                                                                                            |
| `Correlated Log Source`          | اختياري. مصدر سجلات مرتبط (مثل HyperDX logs).                                                                                                 | لا    | لا                              | –                                                                                                     |
| `Correlated Session Source`      | اختياري. مصدر جلسة مرتبط.                                                                                                                     | لا    | لا                              | –                                                                                                     |
| `Correlated Metric Source`       | اختياري. مصدر مقاييس مرتبط (مثل HyperDX metrics).                                                                                             | لا    | لا                              | –                                                                                                     |
| `Status Code Expression`         | تعبير لرمز حالة الـ span.                                                                                                                     | نعم   | نعم                             | `StatusCode`                                                                                          |
| `Status Message Expression`      | تعبير لرسالة حالة الـ span.                                                                                                                   | نعم   | نعم                             | `StatusMessage`                                                                                       |
| `Service Name Expression`        | تعبير أو عمود لاسم الخدمة.                                                                                                                    | نعم   | نعم                             | `ServiceName`                                                                                         |
| `Resource Attributes Expression` | تعبير أو عمود للسمات على مستوى المورد.                                                                                                        | نعم   | نعم                             | `ResourceAttributes`                                                                                  |
| `Event Attributes Expression`    | تعبير أو عمود لسمات الأحداث.                                                                                                                  | نعم   | نعم                             | `SpanAttributes`                                                                                      |
| `Span Events Expression`         | تعبير لاستخراج أحداث الـ span. ويكون عادةً عمودًا من النوع `Nested`. يتيح ذلك عرض تتبعات المكدس للاستثناءات باستخدام SDKS اللغوية المدعومة.   | نعم   | نعم                             | `Events`                                                                                              |
| `Implicit Column Expression`     | العمود المستخدم للبحث النصي الكامل إذا لم يُحدَّد حقل (بنمط Lucene). ويكون عادةً متن السجل.                                                   | نعم   | نعم                             | `SpanName`                                                                                            |
| `Highlighted Attributes`         | تعبيرات أو أعمدة تُعرض عند فتح تفاصيل الـ span. وستُعرض التعبيرات التي تُرجع عناوين URL كروابط.                                               | لا    | لا                              | –                                                                                                     |
| `Highlighted Trace Attributes`   | تعبيرات أو أعمدة تُستخرج من كل span في التتبّع، وتُعرض فوق trace waterfall. وستُعرض التعبيرات التي تُرجع عناوين URL كروابط.                   | لا    | لا                              | –                                                                                                     |

<div id="metrics">
  #### المقاييس
</div>

| الإعداد                 | الوصف                                                                                                                                         | مطلوب | يُستدل عليه في المخطط الافتراضي | القيمة المستدل عليها     |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------------------- | ------------------------ |
| `Name`                  | اسم المصدر.                                                                                                                                   | نعم   | لا                              | –                        |
| `Section`               | تسمية اختيارية لتجميع المصادر في محدد المصادر. تظهر المصادر التي تشترك في القسم نفسه معًا، كما يطابق البحث اسم القسم بالإضافة إلى اسم المصدر. | لا    | لا                              | –                        |
| `Server Connection`     | اسم اتصال الخادم.                                                                                                                             | نعم   | لا                              | `Default`                |
| `Database`              | اسم قاعدة بيانات ClickHouse.                                                                                                                  | نعم   | نعم                             | `default`                |
| `Gauge Table`           | الجدول الذي يخزّن مقاييس من نوع Gauge.                                                                                                        | نعم   | لا                              | `otel_metrics_gauge`     |
| `Histogram Table`       | الجدول الذي يخزّن مقاييس من نوع Histogram.                                                                                                    | نعم   | لا                              | `otel_metrics_histogram` |
| `Sum Table`             | الجدول الذي يخزّن مقاييس من نوع Sum (عداد).                                                                                                   | نعم   | لا                              | `otel_metrics_sum`       |
| `Correlated Log Source` | اختياري. مصدر السجلات المرتبط (مثل سجلات HyperDX).                                                                                            | لا    | لا                              | –                        |

<div id="settings">
  #### الجلسات
</div>

| الإعداد                          | الوصف                                                                                                                                    | مطلوب | مُستنتج في المخطط الافتراضي | القيمة المُستنتجة    |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ----- | --------------------------- | -------------------- |
| `Name`                           | اسم المصدر.                                                                                                                              | نعم   | لا                          | –                    |
| `Section`                        | تسمية اختيارية لتجميع المصادر في محدد المصادر. تظهر المصادر التي تشترك في قسم واحد معًا، ويطابق البحث اسم القسم بالإضافة إلى اسم المصدر. | لا    | لا                          | –                    |
| `Server Connection`              | اسم اتصال الخادم.                                                                                                                        | نعم   | لا                          | `Default`            |
| `Database`                       | اسم قاعدة بيانات ClickHouse.                                                                                                             | نعم   | نعم                         | `default`            |
| `Table`                          | الجدول الهدف لبيانات الجلسات. اسم الجدول الهدف. اضبطه على `hyperdx_sessions` إذا كنت تستخدم المخطط الافتراضي.                            | نعم   | نعم                         | -                    |
| `Timestamp Column`               | عمود `DateTime` أو تعبير يشكّل جزءًا من المفتاح الأساسي لديك.                                                                            | نعم   | نعم                         | `TimestampTime`      |
| `Log Attributes Expression`      | تعبير لاستخراج السمات على مستوى السجل من بيانات الجلسات.                                                                                 | نعم   | نعم                         | `LogAttributes`      |
| `LogAttributes`                  | اسم مستعار أو مرجع حقل يُستخدم لتخزين سمات السجل.                                                                                        | نعم   | نعم                         | `LogAttributes`      |
| `Resource Attributes Expression` | تعبير لاستخراج البيانات الوصفية على مستوى المورد.                                                                                        | نعم   | نعم                         | `ResourceAttributes` |
| `Correlated Trace Source`        | اختياري. مصدر تتبّع مرتبط لترابط الجلسات.                                                                                                | لا    | لا                          | –                    |
| `Implicit Column Expression`     | العمود المستخدم في البحث النصي الكامل عند عدم تحديد حقل (على سبيل المثال، تحليل الاستعلامات على نمط Lucene).                             | نعم   | نعم                         | `Body`               |

<div id="highlighted-attributes">
  #### السمات المميزة
</div>

يمكن تهيئة السمات المميزة وسمات التتبّع المميزة في مصادر بيانات السجلات والتتبّعات.

* السمات المميزة هي أعمدة أو تعبيرات تُعرض لكل سجل أو `span` عند عرض تفاصيل السجل أو `span`.
* سمات التتبّع المميزة هي أعمدة أو تعبيرات يتم الاستعلام عنها من كل سجل أو `span` ضمن تتبّع، وتُعرض فوق trace waterfall.

تُعرَّف هذه السمات في تهيئة المصدر، ويمكن أن تكون أي تعبيرات SQL. إذا أعاد تعبير SQL قيمة بتنسيق URL، فستُعرض السمة كرابط. ولا تُعرض القيم الفارغة.

على سبيل المثال، تم إعداد مصدر التتبّع هذا بسمة مميزة وسمة تتبّع مميزة:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-highlighted-attributes-config.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=8bdef189f4e1f6bebc5e15d11fead15e" alt="تهيئة السمات المميزة" size="md" width="939" height="494" data-path="images/use-cases/observability/hyperdx-highlighted-attributes-config.png" />

تُعرض هذه السمات في اللوحة الجانبية بعد النقر على سجل أو `span`:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-highlighted-attributes.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=4c7634c73e63dd531dd0054cc01dd37b" alt="السمات المميزة" size="md" width="1210" height="1006" data-path="images/use-cases/observability/hyperdx-highlighted-attributes.png" />

يؤدي النقر على سمة إلى إتاحة خيارات لاستخدامها كقيمة بحث. وإذا تم توفير تعبير Lucene اختياري في تهيئة السمة، فسيُستخدم تعبير Lucene للبحث بدلًا من تعبير SQL.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-highlighted-attributes-search.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=1778a0c0ec2cb68c7ce8cd5bf3be898f" alt="بحث السمات المميزة" size="md" width="225" height="137" data-path="images/use-cases/observability/hyperdx-highlighted-attributes-search.png" />

<div id="correlated-sources">
  ### المصادر المترابطة
</div>

لتمكين الترابط الكامل بين المصادر في ClickStack، يجب عليك تكوين مصادر مترابطة للسجلات والتتبعات والمقاييس والجلسات. يتيح ذلك لـ HyperDX ربط البيانات ذات الصلة وتوفير سياق غني عند عرض الأحداث.

* `Logs`: يمكن ربطها بالتتبعات والمقاييس.
* `Traces`: يمكن ربطها بالسجلات والجلسات والمقاييس.
* `Metrics`: يمكن ربطها بالسجلات.
* `Sessions`: يمكن ربطها بالتتبعات.

يؤدي إعداد هذه الارتباطات إلى تمكين العديد من الميزات. على سبيل المثال، يمكن لـ HyperDX عرض السجلات ذات الصلة إلى جانب تتبّع معيّن أو إبراز شذوذات المقاييس المرتبطة بجلسة.

على سبيل المثال، يوضّح الشكل أدناه مصدر السجلات بعد تهيئته بمصادر مترابطة:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-26.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=9aa50421636f1a12a1d2c3b5e76fd5c3" alt="مصدر HyperDX المترابط" size="md" width="1564" height="2138" data-path="images/use-cases/observability/hyperdx-26.png" />

<div id="application-configuration-settings">
  ### إعدادات تكوين التطبيق
</div>

<Info>
  **HyperDX في ClickHouse Cloud**

  لا يمكن تعديل هذه الإعدادات عند إدارة HyperDX في ClickHouse Cloud.
</Info>

* `HYPERDX_API_KEY`
  * **القيمة الافتراضية:** None (مطلوب)
  * **الوصف:** مفتاح المصادقة لواجهة برمجة تطبيقات HyperDX.
  * **إرشادات:**
  * مطلوب للقياس عن بُعد وتسجيل السجلات
  * في بيئة التطوير المحلية، يمكن أن تكون أي قيمة غير فارغة
  * في بيئة الإنتاج، استخدم مفتاحًا آمنًا وفريدًا
  * يمكن الحصول عليه من صفحة إعدادات الفريق بعد إنشاء الحساب

* `HYPERDX_LOG_LEVEL`
  * **الافتراضي:** `info`
  * **الوصف:** يحدّد مستوى تفصيل التسجيل.
  * **الخيارات:** `debug`, `info`, `warn`, `error`
  * **الإرشادات:**
  * استخدم `debug` لاستكشاف الأخطاء وإصلاحها بالتفصيل
  * استخدم `info` للتشغيل العادي
  * استخدم `warn` أو `error` في بيئة الإنتاج لتقليل حجم السجلات

* `HYPERDX_API_PORT`
  * **القيمة الافتراضية:** `8000`
  * **الوصف:** المنفذ الخاص بخادم واجهة برمجة تطبيقات HyperDX.
  * **إرشادات:**
  * تأكد من أن هذا المنفذ متاح على المضيف لديك
  * غيّره إذا كان لديك تعارض في المنافذ
  * يجب أن يتطابق مع المنفذ المحدد في إعدادات عميل واجهة برمجة التطبيقات لديك

* `HYPERDX_APP_PORT`
  * **القيمة الافتراضية:** `8000`
  * **الوصف:** المنفذ الخاص بتطبيق HyperDX للواجهة الأمامية.
  * **إرشادات:**
  * تأكد من أن هذا المنفذ متاح على جهازك المضيف
  * غيّره إذا كان هناك تضارب في المنافذ
  * يجب أن يكون متاحًا للوصول من متصفحك

* `HYPERDX_APP_URL`
  * **القيمة الافتراضية:** `http://localhost`
  * **الوصف:** عنوان URL الأساسي لتطبيق الواجهة الأمامية.
  * **الإرشادات:**
  * اضبطه على نطاقك في بيئة الإنتاج
  * ضمّن البروتوكول (http/https)
  * لا تُضمّن الشرطة المائلة اللاحقة

* `MONGO_URI`
  * **القيمة الافتراضية:** `mongodb://db:27017/hyperdx`
  * **الوصف:** سلسلة connection خاصة بـ MongoDB.
  * **الإرشادات:**
  * استخدم القيمة الافتراضية للتطوير المحلي باستخدام Docker
  * في بيئة production، استخدم سلسلة connection آمنة
  * أدرِج authentication إذا كان مطلوبًا
  * مثال: `mongodb://user:pass@host:port/db`

* `MINER_API_URL`
  * **الافتراضي:** `http://miner:5123`
  * **الوصف:** عنوان URL لخدمة استخراج أنماط السجل.
  * **إرشادات:**
  * استخدم القيمة الافتراضية للتطوير المحلي باستخدام Docker.
  * اضبطه على عنوان URL لخدمة `miner` في بيئة الإنتاج.
  * يجب أن تكون خدمة واجهة برمجة التطبيقات قادرة على الوصول إليه.

* `FRONTEND_URL`
  * **الافتراضي:** `http://localhost:3000`
  * **الوصف:** عنوان URL لتطبيق الواجهة الأمامية.
  * **الإرشادات:**
  * استخدم القيمة الافتراضية في بيئة التطوير المحلي
  * اضبطه على نطاقك في بيئة الإنتاج
  * يجب أن يكون قابلاً للوصول من خدمة واجهة برمجة التطبيقات

* `OTEL_SERVICE_NAME`
  * **الافتراضي:** `hdx-oss-api`
  * **الوصف:** اسم الخدمة المستخدم لأغراض الرصد في OpenTelemetry.
  * **إرشادات:**
  * استخدم اسمًا وصفيًا لخدمة HyperDX الخاصة بك. ينطبق ذلك إذا كانت HyperDX تُجري الرصد الذاتي.
  * يساعد في تمييز خدمة HyperDX ضمن بيانات الرصد

* `NEXT_PUBLIC_OTEL_EXPORTER_OTLP_ENDPOINT`
  * **الافتراضي:** `http://localhost:4318`
  * **الوصف:** نقطة نهاية جامع OpenTelemetry.
  * **الإرشادات:**
  * ذو صلة بالإعداد الذاتي لـ HyperDX.
  * استخدم القيمة الافتراضية للتطوير المحلي
  * اضبطه على عنوان URL الخاص بجامعك في بيئة production
  * يجب أن يكون قابلاً للوصول من خدمة HyperDX الخاصة بك

* `USAGE_STATS_ENABLED`
  * **الافتراضي:** `true`
  * **الوصف:** يفعّل أو يعطّل جمع إحصاءات الاستخدام.
  * **إرشادات:**
  * اضبطه على `false` لتعطيل تتبّع الاستخدام
  * مفيد لعمليات النشر التي تتطلّب مراعاة الخصوصية
  * القيمة الافتراضية هي `true` للمساعدة في تحسين المنتج

* `IS_OSS`
  * **الافتراضي:** `true`
  * **الوصف:** يحدد ما إذا كان التشغيل في وضع OSS.
  * **إرشادات:**
  * اتركه على `true` لعمليات النشر مفتوحة المصدر
  * اضبطه على `false` لعمليات النشر المؤسسية
  * يؤثر في توفر الميزات

* `IS_LOCAL_MODE`
  * **الافتراضي:** `false`
  * **الوصف:** يحدد ما إذا كان التشغيل في الوضع المحلي.
  * **الإرشادات:**
  * اضبطه على `true` للتطوير المحلي
  * يعطّل بعض ميزات بيئة الإنتاج
  * مفيد للاختبار والتطوير

* `EXPRESS_SESSION_SECRET`
  * **الافتراضي:** `hyperdx is cool 👋`
  * **الوصف:** سرّ لإدارة جلسات Express.
  * **إرشادات:**
  * غيّره في بيئة production
  * استخدم سلسلة قوية وعشوائية
  * حافظ على سريته وأمانه

* `ENABLE_SWAGGER`
  * **القيمة الافتراضية:** `false`
  * **الوصف:** يفعّل أو يعطّل وثائق Swagger لواجهة برمجة التطبيقات.
  * **الإرشادات:**
  * اضبطه على `true` لتمكين وثائق واجهة برمجة التطبيقات
  * مفيد للتطوير والاختبار
  * عطّله في بيئة الإنتاج

* `BETA_CH_OTEL_JSON_SCHEMA_ENABLED`
  * **الافتراضي:** `false`
  * **الوصف:** يفعّل الدعم التجريبي لنوع JSON في HyperDX. راجع أيضًا [`OTEL_AGENT_FEATURE_GATE_ARG`](#otel-collector) لتمكين دعم JSON في OTel collector.
  * **إرشادات:**
    * يفعّل **ميزة تجريبية**. لا يُنصح بمخططات JSON-typed schemas لأعباء عمل observability المعتادة. راجع [Map vs JSON type](/ar/clickstack/ingesting-data/schema/map-vs-json) للاطّلاع على المقارنة ومعرفة الحالات المناسبة لكلٍّ منهما.
    * اضبط القيمة على `true` لتمكين دعم JSON في ClickStack UI.

<div id="otel-collector">
  ## مجمّع OpenTelemetry
</div>

راجع ["ClickStack OpenTelemetry Collector"](/ar/clickstack/ingesting-data/collector) لمزيد من التفاصيل.

* `CLICKHOUSE_ENDPOINT`
  * **الافتراضي:** *None (مطلوب)* إذا كانت الصورة مستقلة. أما إذا كانت التوزيعة All-in-one أو Docker Compose، فستُضبط هذه القيمة على ClickHouse instance المدمجة.
  * **الوصف:** عنوان URL عبر HTTPS لـ ClickHouse instance التي ستُصدَّر إليها بيانات telemetry.
  * **إرشادات:**
    * يجب أن يكون endpoint كاملاً عبر HTTPS ويتضمن المنفذ (على سبيل المثال: `https://clickhouse.example.com:8443`)
    * هذا الإعداد مطلوب لكي يتمكن المجمّع من إرسال البيانات إلى ClickHouse

* `CLICKHOUSE_USER`
  * **الافتراضي:** `default`
  * **الوصف:** اسم المستخدم المستخدم للمصادقة مع ClickHouse instance.
  * **إرشادات:**
    * تأكد من أن المستخدم لديه أذونات `INSERT` و`CREATE TABLE`
    * يُنصح بإنشاء مستخدم مخصص لعملية الاستيعاب

* `CLICKHOUSE_PASSWORD`
  * **الافتراضي:** *None (مطلوب إذا كانت authentication مفعّلة)*
  * **الوصف:** كلمة المرور لمستخدم ClickHouse المحدد.
  * **إرشادات:**
    * تكون مطلوبة إذا كانت user account تحتوي على كلمة مرور معيّنة
    * خزّنها بأمان باستخدام secrets في بيئات production

* `HYPERDX_LOG_LEVEL`
  * **الافتراضي:** `info`
  * **الوصف:** مستوى تفصيل السجل للمجمّع.
  * **إرشادات:**
    * يقبل قيماً مثل `debug` و`info` و`warn` و`error`
    * استخدم `debug` أثناء استكشاف الأخطاء وإصلاحها

* `OPAMP_SERVER_URL`
  * **الافتراضي:** *None (مطلوب)* إذا كانت الصورة مستقلة. أما إذا كانت التوزيعة All-in-one أو Docker Compose، فتشير هذه القيمة إلى HyperDX instance المنشورة.
  * **الوصف:** عنوان URL لخادم OpAMP المستخدم لإدارة المجمّع (مثل HyperDX instance). يكون هذا على المنفذ `4320` افتراضياً.
  * **إرشادات:**
    * يجب أن يشير إلى HyperDX instance الخاصة بك
    * يفعّل configuration ديناميكية واستيعاباً آمناً
    * إذا لم يتم تحديده، فسيُعطَّل الاستيعاب الآمن ما لم تُحدَّد قيمة `OTLP_AUTH_TOKEN`.

* `OTLP_AUTH_TOKEN`
  * **الافتراضي:** *None*. يُستخدم فقط مع الصورة المستقلة.
  * **الوصف:** يتيح تحديد token للمصادقة الخاصة بـ OTLP. إذا تم ضبطه، فستتطلب جميع الاتصالات Bearer token هذا.
  * **إرشادات:**
    * يُنصح به عند استخدام صورة المجمّع المستقلة في بيئات production.

* `HYPERDX_OTEL_EXPORTER_CLICKHOUSE_DATABASE`
  * **الافتراضي:** `default`
  * **الوصف:** قاعدة بيانات ClickHouse التي يكتب فيها المجمّع بيانات telemetry.
  * **إرشادات:**
    * اضبطه إذا كنت تستخدم اسم database مخصصاً
    * تأكد من أن المستخدم المحدد لديه صلاحية الوصول إلى هذه database

* `OTEL_AGENT_FEATURE_GATE_ARG`
  * **الافتراضي:** `<empty string>`
  * **الوصف:** يفعّل feature flags في المجمّع. إذا ضُبط على `--feature-gates=clickhouse.json`، فسيتم تفعيل beta support لنوع JSON type في المجمّع، مما يضمن إنشاء schemas بهذا النوع. راجع أيضاً [`BETA_CH_OTEL_JSON_SCHEMA_ENABLED`](#hyperdx) لتمكين دعم JSON في HyperDX.
  * **إرشادات:**
    * يفعّل **ميزة تجريبية**. إن JSON-typed schemas **غير موصى بها** لأعباء observability المعتادة. راجع [Map vs JSON type](/ar/clickstack/ingesting-data/schema/map-vs-json) للمقارنة ومتى يكون كل منهما مناسباً.
    * اضبطه على `--feature-gates=clickhouse.json` لإنشاء جداول جديدة باستخدام JSON type.

<div id="clickhouse">
  ## ClickHouse
</div>

يأتي ClickStack Open Source بإعداد ClickHouse افتراضي مصمم للعمل على نطاق متعدد التيرابايت، لكن يمكن للمستخدمين تعديله وتحسينه بما يناسب عبء العمل لديهم.

لضبط ClickHouse بفعالية، ينبغي فهم مفاهيم التخزين الأساسية مثل [الأجزاء](/ar/concepts/core-concepts/parts)، و[الأقسام](/ar/concepts/core-concepts/partitions)، و[الشظايا والنسخ المتماثلة](/ar/guides/oss/deployment-and-scaling/shards)، وكيف تحدث [عمليات الدمج](/ar/concepts/core-concepts/merges) أثناء الإدراج. ونوصي بمراجعة أساسيات [الفهارس الأولية](/ar/concepts/core-concepts/primary-indexes)، و[الفهارس الثانوية المتناثرة](/ar/concepts/features/performance/skip-indexes/skipping-indexes)، وفهارس تخطي البيانات، إلى جانب تقنيات [إدارة دورة حياة البيانات](/ar/guides/use-cases/observability/build-your-own/managing-data)، مثل استخدام دورة حياة TTL.

يدعم ClickStack [تخصيص المخطط](/ar/guides/use-cases/observability/build-your-own/schema-design) — إذ يمكنك تعديل أنواع الأعمدة، واستخراج حقول جديدة (مثلًا من السجلات)، وتطبيق codecs والقواميس، وتسريع الاستعلامات باستخدام الإسقاطات.

بالإضافة إلى ذلك، يمكن استخدام العروض المادية [لتحويل البيانات أو تصفيتها أثناء الإدخال](/ar/guides/use-cases/observability/build-your-own/schema-design#materialized-columns)، بشرط أن تُكتب البيانات إلى الجدول المصدر للعرض وأن يقرأ التطبيق من الجدول الهدف. ويمكن أيضًا استخدام العروض المادية [لتسريع الاستعلامات مباشرةً](/ar/clickstack/managing/materialized-views) في ClickStack.

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