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

يمكن فتح صفحات ClickStack عبر روابط عميقة باستخدام معاملات استعلام URL، ما يتيح لك الانتقال مباشرةً إلى بحث أو لوحة معلومات أو لوحة معيّنة من نظام خارجي، مثل إشعار تنبيه أو دليل إجراءات أو job في CI أو رسالة دردشة. تستخدم الأمثلة في هذه الصفحة <YOUR_CLICKSTACK_URL>. استبدلها بعنوان URL الخاص بـ ClickStack — على سبيل المثال، http://localhost:8080 لنشر محلي مفتوح المصدر، أو https://hyperdx.clickhouse.cloud لـ Managed ClickStack في ClickHouse Cloud.

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

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

https://hyperdx.clickhouse.cloud/search?chcServiceId=abc123

البحث — `/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>.

مثال: ابحث في المصدر `Logs` عن الأخطاء في خدمة `checkout` ضمن نطاق زمني

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

مثال: الانتقال مباشرةً إلى عرض الشلال للتتبّع

<YOUR_CLICKSTACK_URL>/search?source=Traces&traceId=ba7217967eb90d040b7eb39f97ecc5c4

عمليات البحث المحفوظة — `/search/list`

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

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

مثال: عرض عمليات البحث المحفوظة ذات الوسم `production`

<YOUR_CLICKSTACK_URL>/search/list?tag=production

لوحات المعلومات — `/dashboards/<dashboardId>`

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

المَعلمة	التنسيق	الوصف
`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`	سلسلة نصية	ينتقل إلى بطاقة محددة ويُبرزها — مفيد عند إنشاء رابط من تنبيه.

مثال: افتح لوحة معلومات ضمن نطاق زمني مع تمييز بطاقة واحدة

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

<YOUR_CLICKSTACK_URL>/dashboards/64f1c2a1e8b9f3a1b0d2e5c7?from=1735689600000&to=1735693200000&highlightedTileId=chart-1

قائمة لوحات المعلومات — `/dashboards/list`

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

<YOUR_CLICKSTACK_URL>/dashboards/list?tag=infra

مستكشف المخططات — `/chart`

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

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

مثال: فتح إعداد مخطط زمن الاستجابة p99 لنطاق زمني

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

التنبيهات — `/alerts`

راجع التنبيهات للاطلاع على تفاصيل إنشاء التنبيهات وإدارتها.

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

مثال: عرض التنبيهات الموسومة بـ `on-call`

<YOUR_CLICKSTACK_URL>/alerts?tag=on-call

إعادة عرض الجلسات — `/sessions`

تصفّح تسجيلات الجلسات وأعِد تشغيلها. راجع إعادة عرض الجلسات للاطلاع على تفاصيل الميزة.

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

مثال: استعرض إعادات عرض الجلسات ضمن نطاق زمني

<YOUR_CLICKSTACK_URL>/sessions?from=1735689600000&to=1735693200000

مثال: فتح إعادة تشغيل جلسة محددة ضمن الإطار الزمني المسجّل

<YOUR_CLICKSTACK_URL>/sessions?sid=6712abf0e4b0f2a1c3d4e5f6&sfrom=1735689600000&sto=1735690200000

خريطة الخدمات — `/service-map`

راجع خريطة الخدمات للاطّلاع على تفاصيل الميزة.

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

مثال: عرض خريطة الخدمات خلال نطاق زمني

<YOUR_CLICKSTACK_URL>/service-map?from=1735689600000&to=1735693200000

الخدمات — `/services`

لوحات معلومات 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 دقيقة.

مثال: عرض لوحة معلومات قاعدة البيانات لخدمة خلال نطاق زمني

<YOUR_CLICKSTACK_URL>/services?tab=database&service=checkout&from=1735689600000&to=1735693200000

مثال: عرض لوحة معلومات الأخطاء لإحدى الخدمات

<YOUR_CLICKSTACK_URL>/services?tab=errors&service=payments

Kubernetes — `/kubernetes`

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

مثال: افتح لوحة التفاصيل لكبسولة محددة

<YOUR_CLICKSTACK_URL>/kubernetes?tab=pods&podName=checkout-7d9f8b5c-2xk9p

Notebooks — `/notebook/<notebookId>`

متاح في Managed ClickStack فقطلا تتوفر Notebooks إلا في عمليات نشر Managed ClickStack. راجع AI Notebooks للاطلاع على تفاصيل الميزة.

مثال: افتح دفتر ملاحظات محددًا ضمن خدمة Cloud معيّنة

<YOUR_CLICKSTACK_URL>/notebook/64f1c2a1e8b9f3a1b0d2e5c7?chcServiceId=abc123

آخر تعديل في ١٤ أغسطس ٢٠٢٦

Get started

Features

Managing ClickStack

Guides

Integration partners

البحث — `/search`

مثال: ابحث في المصدر `Logs` عن الأخطاء في خدمة `checkout` ضمن نطاق زمني

مثال: الانتقال مباشرةً إلى عرض الشلال للتتبّع

عمليات البحث المحفوظة — `/search/list`

مثال: عرض عمليات البحث المحفوظة ذات الوسم `production`

لوحات المعلومات — `/dashboards/<dashboardId>`

مثال: افتح لوحة معلومات ضمن نطاق زمني مع تمييز بطاقة واحدة

قائمة لوحات المعلومات — `/dashboards/list`

مستكشف المخططات — `/chart`

مثال: فتح إعداد مخطط زمن الاستجابة p99 لنطاق زمني

التنبيهات — `/alerts`

مثال: عرض التنبيهات الموسومة بـ `on-call`

إعادة عرض الجلسات — `/sessions`

مثال: استعرض إعادات عرض الجلسات ضمن نطاق زمني

مثال: فتح إعادة تشغيل جلسة محددة ضمن الإطار الزمني المسجّل

خريطة الخدمات — `/service-map`

مثال: عرض خريطة الخدمات خلال نطاق زمني

الخدمات — `/services`

مثال: عرض لوحة معلومات قاعدة البيانات لخدمة خلال نطاق زمني

مثال: عرض لوحة معلومات الأخطاء لإحدى الخدمات

Kubernetes — `/kubernetes`

مثال: افتح لوحة التفاصيل لكبسولة محددة

Notebooks — `/notebook/<notebookId>`

مثال: افتح دفتر ملاحظات محددًا ضمن خدمة Cloud معيّنة

​البحث — /search

​مثال: ابحث في المصدر Logs عن الأخطاء في خدمة checkout ضمن نطاق زمني

​مثال: الانتقال مباشرةً إلى عرض الشلال للتتبّع

​عمليات البحث المحفوظة — /search/list

​مثال: عرض عمليات البحث المحفوظة ذات الوسم production

​لوحات المعلومات — /dashboards/<dashboardId>

​مثال: افتح لوحة معلومات ضمن نطاق زمني مع تمييز بطاقة واحدة

​قائمة لوحات المعلومات — /dashboards/list

​مثال: سرد لوحات المعلومات الموسومة بـ infra

​مستكشف المخططات — /chart

​مثال: فتح إعداد مخطط زمن الاستجابة p99 لنطاق زمني

​التنبيهات — /alerts

​مثال: عرض التنبيهات الموسومة بـ on-call

​إعادة عرض الجلسات — /sessions

​مثال: استعرض إعادات عرض الجلسات ضمن نطاق زمني

​مثال: فتح إعادة تشغيل جلسة محددة ضمن الإطار الزمني المسجّل

​خريطة الخدمات — /service-map

​مثال: عرض خريطة الخدمات خلال نطاق زمني

​الخدمات — /services

​مثال: عرض لوحة معلومات قاعدة البيانات لخدمة خلال نطاق زمني

​مثال: عرض لوحة معلومات الأخطاء لإحدى الخدمات

​Kubernetes — /kubernetes

​مثال: افتح لوحة التفاصيل لكبسولة محددة

​Notebooks — /notebook/<notebookId>

​مثال: افتح دفتر ملاحظات محددًا ضمن خدمة Cloud معيّنة

البحث — `/search`

مثال: ابحث في المصدر `Logs` عن الأخطاء في خدمة `checkout` ضمن نطاق زمني

مثال: الانتقال مباشرةً إلى عرض الشلال للتتبّع

عمليات البحث المحفوظة — `/search/list`

مثال: عرض عمليات البحث المحفوظة ذات الوسم `production`

لوحات المعلومات — `/dashboards/<dashboardId>`

مثال: افتح لوحة معلومات ضمن نطاق زمني مع تمييز بطاقة واحدة

قائمة لوحات المعلومات — `/dashboards/list`

مثال: سرد لوحات المعلومات الموسومة بـ `infra`

مستكشف المخططات — `/chart`

مثال: فتح إعداد مخطط زمن الاستجابة p99 لنطاق زمني

التنبيهات — `/alerts`

مثال: عرض التنبيهات الموسومة بـ `on-call`

إعادة عرض الجلسات — `/sessions`

مثال: استعرض إعادات عرض الجلسات ضمن نطاق زمني

مثال: فتح إعادة تشغيل جلسة محددة ضمن الإطار الزمني المسجّل

خريطة الخدمات — `/service-map`

مثال: عرض خريطة الخدمات خلال نطاق زمني

الخدمات — `/services`

مثال: عرض لوحة معلومات قاعدة البيانات لخدمة خلال نطاق زمني

مثال: عرض لوحة معلومات الأخطاء لإحدى الخدمات

Kubernetes — `/kubernetes`

مثال: افتح لوحة التفاصيل لكبسولة محددة

Notebooks — `/notebook/<notebookId>`

مثال: افتح دفتر ملاحظات محددًا ضمن خدمة Cloud معيّنة