> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# الروابط العميقة

> اربط مباشرةً بصفحات ClickStack باستخدام معاملات استعلام URL

يمكن فتح صفحات ClickStack عبر روابط عميقة باستخدام معاملات استعلام URL، ما يتيح لك الانتقال مباشرةً إلى بحث أو لوحة معلومات أو لوحة معيّنة من نظام خارجي، مثل إشعار تنبيه أو دليل إجراءات أو job في CI أو رسالة دردشة.

تستخدم الأمثلة في هذه الصفحة `<YOUR_CLICKSTACK_URL>`. استبدلها بعنوان URL الخاص بـ ClickStack — على سبيل المثال، `http://localhost:8080` لنشر محلي مفتوح المصدر، أو `https://hyperdx.clickhouse.cloud` لـ Managed ClickStack في ClickHouse Cloud.

<Note>
  تعرض الأمثلة معاملات الاستعلام دون ترميز URL لتسهيل قراءتها. عند إنشاء الروابط برمجيًا، شفّر كل قيمة من قيم معاملات الاستعلام بترميز URL.
</Note>

<Info>
  **معامل معرّف خدمة Managed ClickStack**

  عند استخدام Managed ClickStack في ClickHouse Cloud، ينبغي أن تتضمن الروابط معامل `?chcServiceId=` لتحديد خدمة ClickHouse Cloud المطلوب تحميلها، إذا كان المستخدم authenticated الذي يتبع الرابط مخوّلًا باستخدام أكثر من خدمة ClickHouse Cloud واحدة.

  مثال: افتح Search لخدمة Cloud محددة

  ```text theme={null}
  https://hyperdx.clickhouse.cloud/search?chcServiceId=abc123
  ```
</Info>

<div id="search">
  ## البحث — `/search`
</div>

واجهة البحث الرئيسية للسجلات والتتبّعات. راجع [البحث](/docs/ar/clickstack/features/search) للاطلاع على تفاصيل صياغة البحث.

| المعلَمة        | التنسيق                                                                    | الوصف                                                                                                                    |                                                                 |                                                         |
| --------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- | ------------------------------------------------------- |
| `source`        | سلسلة نصية                                                                 | المصدر المراد البحث فيه — يقبل إما معرّف المصدر أو **اسم** المصدر (مثل `Logs`). لا تدعم هذه الصفحة إلا مصادر Log وTrace. |                                                                 |                                                         |
| `where`         | سلسلة نصية                                                                 | نص استعلام التصفية، بصياغة Lucene أو SQL (راجع `whereLanguage`).                                                         |                                                                 |                                                         |
| `whereLanguage` | `lucene`                                                                   | `sql`                                                                                                                    | لغة الاستعلام المكتوب بها `where`.                              |                                                         |
| `select`        | سلسلة نصية                                                                 | قائمة أعمدة أو تعبيرات SQL لعرضها في جدول النتائج.                                                                       |                                                                 |                                                         |
| `filters`       | `{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]` | عوامل تصفية مهيكلة للسمات، تُطبّق بالإضافة إلى `where`.                                                                  |                                                                 |                                                         |
| `orderBy`       | سلسلة نصية                                                                 | تعبير فرز SQL لجدول النتائج.                                                                                             |                                                                 |                                                         |
| `mode`          | `results`                                                                  | `delta`                                                                                                                  | `pattern`                                                       | وضع التحليل النشط. لا يتوفر `delta` إلا لمصادر التتبّع. |
| `isLive`        | `true`                                                                     | `false`                                                                                                                  | ما إذا كان العرض المباشر مفعّلاً (القيمة الافتراضية هي `true`). |                                                         |
| `traceId`       | سلسلة نصية                                                                 | ينتقل مباشرةً إلى عرض الشلال للتتبّع ذي معرّف التتبّع المحدد.                                                            |                                                                 |                                                         |
| `from`, `to`    | مللي ثانية منذ حقبة Unix                                                   | النطاق الزمني المطلق. إذا لم يُحدَّد، تكون القيمة الافتراضية آخر 15 دقيقة.                                               |                                                                 |                                                         |

يمكن أيضاً فتح بحث محفوظ مباشرةً عبر `/search/<savedSearchId>`.

<div id="example-search-errors">
  ### مثال: ابحث في المصدر `Logs` عن الأخطاء في خدمة `checkout` ضمن نطاق زمني
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/search?source=Logs&from=1735689600000&to=1735693200000&where=level:error&filters=[{"type":"sql","condition":"ServiceName IN ('checkout')"}]
```

<div id="example-search-trace">
  ### مثال: الانتقال مباشرةً إلى عرض الشلال للتتبّع
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/search?source=Traces&traceId=ba7217967eb90d040b7eb39f97ecc5c4
```

<div id="saved-searches">
  ## عمليات البحث المحفوظة — `/search/list`
</div>

قائمة بعمليات البحث المحفوظة.

| المعلَمة | التنسيق | الوصف                                                           |
| -------- | ------- | --------------------------------------------------------------- |
| `tag`    | string  | تصفية القائمة لإظهار عمليات البحث المحفوظة التي تحمل هذا الوسم. |

<div id="example-saved-searches-tag">
  ### مثال: عرض عمليات البحث المحفوظة ذات الوسم `production`
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/search/list?tag=production
```

<div id="dashboards">
  ## لوحات المعلومات — `/dashboards/<dashboardId>`
</div>

لوحة معلومات محفوظة. احذف `<dashboardId>` (`/dashboards`) لفتح لوحة معلومات مؤقتة غير محفوظة. راجع [لوحات المعلومات](/docs/ar/clickstack/features/dashboards/overview) للاطلاع على تفاصيل إنشاء لوحات المعلومات.

| المَعلمة            | التنسيق                                                                    | الوصف                                                                                                  |                                    |            |             |             |             |          |           |         |         |                                                                                               |
| ------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ---------------------------------- | ---------- | ----------- | ----------- | ----------- | -------- | --------- | ------- | ------- | --------------------------------------------------------------------------------------------- |
| `from`, `to`        | مللي ثانية منذ حقبة Unix                                                   | النطاق الزمني المُطبّق على جميع البطاقات. إذا لم يُحدَّد، يكون افتراضيًا آخر 15 دقيقة.                 |                                    |            |             |             |             |          |           |         |         |                                                                                               |
| `where`             | سلسلة نصية                                                                 | نص استعلام عامل التصفية على مستوى لوحة المعلومات، ويُطبّق على جميع البطاقات.                           |                                    |            |             |             |             |          |           |         |         |                                                                                               |
| `whereLanguage`     | `lucene`                                                                   | `sql`                                                                                                  | لغة الاستعلام المكتوب بها `where`. |            |             |             |             |          |           |         |         |                                                                                               |
| `filters`           | `{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]` | قيم عوامل تصفية لوحة المعلومات المهيكلة، لاختيار عنصرين من القائمة المنسدلة لعامل تصفية `ServiceName`. |                                    |            |             |             |             |          |           |         |         |                                                                                               |
| `granularity`       | `auto`                                                                     | `30 second`                                                                                            | `1 minute`                         | `5 minute` | `10 minute` | `15 minute` | `30 minute` | `1 hour` | `12 hour` | `1 day` | `7 day` | حجم الحاوية لبطاقات السلاسل الزمنية. يختار `auto` حجم الحاوية بناءً على النطاق الزمني المحدد. |
| `highlightedTileId` | سلسلة نصية                                                                 | ينتقل إلى بطاقة محددة ويُبرزها — مفيد عند إنشاء رابط من تنبيه.                                         |                                    |            |             |             |             |          |           |         |         |                                                                                               |

<div id="example-dashboard-highlight">
  ### مثال: افتح لوحة معلومات ضمن نطاق زمني مع تمييز بطاقة واحدة
</div>

يُفيد ذلك عند الربط من إشعار تنبيه مباشرةً بالبطاقة التي أطلقت التنبيه.

```text theme={null}
<YOUR_CLICKSTACK_URL>/dashboards/64f1c2a1e8b9f3a1b0d2e5c7?from=1735689600000&to=1735693200000&highlightedTileId=chart-1
```

<div id="dashboards-list">
  ## قائمة لوحات المعلومات — `/dashboards/list`
</div>

| المَعلمة | التنسيق | الوصف                                  |
| -------- | ------- | -------------------------------------- |
| `tag`    | string  | تصفية قائمة لوحات المعلومات حسب الوسم. |

<div id="example-dashboards-list-tag">
  ### مثال: سرد لوحات المعلومات الموسومة بـ `infra`
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/dashboards/list?tag=infra
```

<div id="chart-explorer">
  ## مستكشف المخططات — `/chart`
</div>

أداة لإنشاء مخططات مخصصة قابلة للمشاركة.

| المعلَمة     | التنسيق                  | الوصف                                                                                                                                    |
| ------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `config`     | JSON                     | إعدادات المخطط الكاملة (المصدر، select، where، نوع المخطط، إلخ). تُنشأ عادةً عبر روابط "مشاركة" من داخل التطبيق بدلًا من كتابتها يدويًا. |
| `from`, `to` | مللي ثانية منذ حقبة Unix | النطاق الزمني. إذا لم يُحدَّد، تكون القيمة الافتراضية آخر 15 دقيقة.                                                                      |

<div id="example-chart-config">
  ### مثال: فتح إعداد مخطط زمن الاستجابة p99 لنطاق زمني
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/chart?granularity=auto&from=1785759381784&to=1785762981785&config={"name":"","select":[{"aggFn":"quantile","aggCondition":"","aggConditionLanguage":"lucene","valueExpression":"Duration","level":0.99,"alias":"p99"}],"where":"","whereLanguage":"lucene","displayType":"line","alignDateRangeToGranularity":true,"source":"68814eb5d40a9d0449afc1f2","connection":"68814b6fd40a9d0449afbe78","groupBy":"ServiceName"}
```

<div id="alerts">
  ## التنبيهات — `/alerts`
</div>

راجع [التنبيهات](/docs/ar/clickstack/features/alerts) للاطلاع على تفاصيل إنشاء التنبيهات وإدارتها.

| المَعلمة  | التنسيق | الوصف                                  |
| --------- | ------- | -------------------------------------- |
| `search`  | string  | تصفية نصية حرة في اسم التنبيه أو وصفه. |
| `tag`     | string  | تصفية حسب الوسم.                       |
| `creator` | string  | تصفية حسب اسم منشئ التنبيه.            |

<div id="example-alerts-filter">
  ### مثال: عرض التنبيهات الموسومة بـ `on-call`
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/alerts?tag=on-call
```

<div id="session-replay">
  ## إعادة عرض الجلسات — `/sessions`
</div>

تصفّح تسجيلات الجلسات وأعِد تشغيلها. راجع [إعادة عرض الجلسات](/docs/ar/clickstack/features/session-replay) للاطلاع على تفاصيل الميزة.

| المعلَمة        | التنسيق                  | الوصف                                                                     |                                      |
| --------------- | ------------------------ | ------------------------------------------------------------------------- | ------------------------------------ |
| `sessionSource` | سلسلة نصية               | معرّف مصدر الجلسات أو اسمه.                                               |                                      |
| `where`         | سلسلة نصية               | نص استعلام التصفية لقائمة الجلسات.                                        |                                      |
| `whereLanguage` | `lucene`                 | `sql`                                                                     | لغة الاستعلام التي كُتب بها `where`. |
| `from`, `to`    | مللي ثانية منذ حقبة Unix | النطاق الزمني لقائمة الجلسات. إذا تم إغفاله، يكون آخر 15 دقيقة افتراضيًا. |                                      |
| `sid`           | سلسلة نصية               | يفتح جلسة محددة باستخدام معرّفها.                                         |                                      |
| `sfrom`, `sto`  | مللي ثانية منذ حقبة Unix | النافذة الزمنية للجلسة المفتوحة (تُستخدم مع `sid`).                       |                                      |

<div id="example-sessions-time-range">
  ### مثال: استعرض إعادات عرض الجلسات ضمن نطاق زمني
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/sessions?from=1735689600000&to=1735693200000
```

<div id="example-sessions-open">
  ### مثال: فتح إعادة تشغيل جلسة محددة ضمن الإطار الزمني المسجّل
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/sessions?sid=6712abf0e4b0f2a1c3d4e5f6&sfrom=1735689600000&sto=1735690200000
```

<div id="service-map">
  ## خريطة الخدمات — `/service-map`
</div>

راجع [خريطة الخدمات](/docs/ar/clickstack/service-maps) للاطّلاع على تفاصيل الميزة.

| المَعلمة         | التنسيق                  | الوصف                                                                        |
| ---------------- | ------------------------ | ---------------------------------------------------------------------------- |
| `source`         | سلسلة نصية               | معرّف مصدر التتبعات أو اسمه.                                                 |
| `samplingFactor` | عدد صحيح                 | قاسم أخذ عينات التتبعات (`1` = 100% من التتبعات، `2` = 50%، `4` = 25%، إلخ). |
| `from`، `to`     | مللي ثانية منذ حقبة Unix | النطاق الزمني. إذا لم يُحدَّد، يكون الإعداد الافتراضي آخر 15 دقيقة.          |

<div id="example-service-map">
  ### مثال: عرض خريطة الخدمات خلال نطاق زمني
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/service-map?from=1735689600000&to=1735693200000
```

<div id="services">
  ## الخدمات — `/services`
</div>

لوحات معلومات HTTP وقواعد البيانات والأخطاء الخاصة بكل خدمة.

| المَعلمة        | التنسيق                                                                    | الوصف                                                               |                                                                               |                                                                          |
| --------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| `tab`           | `http`                                                                     | `database`                                                          | `errors`                                                                      | علامة التبويب الفرعية المعروضة في لوحة معلومات الخدمة. الافتراضي: `http` |
| `source`        | سلسلة نصية                                                                 | معرّف مصدر التتبّع.                                                 |                                                                               |                                                                          |
| `service`       | سلسلة نصية                                                                 | اسم الخدمة المحددة.                                                 |                                                                               |                                                                          |
| `where`         | سلسلة نصية                                                                 | نص استعلام عامل التصفية.                                            |                                                                               |                                                                          |
| `whereLanguage` | `lucene`                                                                   | `sql`                                                               | لغة الاستعلام المكتوب بها `where` (القيمة الافتراضية في هذه الصفحة هي `sql`). |                                                                          |
| `filters`       | `{"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[]` | قيم شريط عوامل التصفية في لوحة المعلومات.                           |                                                                               |                                                                          |
| `from`, `to`    | مللي ثانية منذ حقبة Unix                                                   | النطاق الزمني. إذا لم يُحدَّد، تكون القيمة الافتراضية آخر 15 دقيقة. |                                                                               |                                                                          |

<div id="example-services-database">
  ### مثال: عرض لوحة معلومات قاعدة البيانات لخدمة خلال نطاق زمني
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/services?tab=database&service=checkout&from=1735689600000&to=1735693200000
```

<div id="example-services-errors">
  ### مثال: عرض لوحة معلومات الأخطاء لإحدى الخدمات
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/services?tab=errors&service=payments
```

<div id="kubernetes">
  ## Kubernetes — `/kubernetes`
</div>

| المعلمة                                | التنسيق                           | الوصف                                                                                       |
| -------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------- |
| `logSource`, `metricSource`            | سلسلة نصية                        | معرّفات مصدر السجلات والمقاييس. عند توفير أحدهما فقط، يُضبط الآخر تلقائيًا على مصدر مترابط. |
| `tab`                                  | مثل `pods`، `nodes`، `namespaces` | العرض الفرعي النشط.                                                                         |
| `q`                                    | سلسلة نصية                        | استعلام Lucene لقائمة الموارد.                                                              |
| `podName`, `nodeName`, `namespaceName` | سلسلة نصية                        | يفتح لوحة التفاصيل لكبسولة محددة أو عقدة أو مساحة أسماء.                                    |
| `from`, `to`                           | مللي ثانية منذ حقبة Unix          | النطاق الزمني. إذا لم يُحدَّد، تكون القيمة الافتراضية آخر 15 دقيقة.                         |

<div id="example-kubernetes-pod">
  ### مثال: افتح لوحة التفاصيل لكبسولة محددة
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/kubernetes?tab=pods&podName=checkout-7d9f8b5c-2xk9p
```

<div id="notebooks">
  ## Notebooks — `/notebook/<notebookId>`
</div>

<Info>
  **متاح في Managed ClickStack فقط**

  لا تتوفر Notebooks إلا في عمليات نشر Managed ClickStack. راجع [AI Notebooks](/docs/ar/clickstack/notebooks) للاطلاع على تفاصيل الميزة.
</Info>

<div id="example-notebook-open">
  ### مثال: افتح دفتر ملاحظات محددًا ضمن خدمة Cloud معيّنة
</div>

```text theme={null}
<YOUR_CLICKSTACK_URL>/notebook/64f1c2a1e8b9f3a1b0d2e5c7?chcServiceId=abc123
```