Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

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

View as MarkdownEdit this pageReport an issueSet up docs MCP

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

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

واجهة البحث الرئيسية للسجلات والتتبّعات. راجع البحث للاطلاع على تفاصيل صياغة البحث.

المعلَمة التنسيق الوصف
source سلسلة نصية المصدر المراد البحث فيه — يقبل إما معرّف المصدر أو اسم المصدر (مثل Logs). لا تدعم هذه الصفحة إلا مصادر Log وTrace.
where سلسلة نصية نص استعلام التصفية، بصياغة Lucene أو SQL (راجع whereLanguage).
whereLanguage lucene sql
select سلسلة نصية قائمة أعمدة أو تعبيرات SQL لعرضها في جدول النتائج.
filters {"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[] عوامل تصفية مهيكلة للسمات، تُطبّق بالإضافة إلى where.
orderBy سلسلة نصية تعبير فرز SQL لجدول النتائج.
mode results delta
isLive true false
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
filters {"type":"sql","condition":"<column> IN ('<value1>', '<value2>', ...)"}[] قيم عوامل تصفية لوحة المعلومات المهيكلة، لاختيار عنصرين من القائمة المنسدلة لعامل تصفية ServiceName.
granularity auto 30 second
highlightedTileId سلسلة نصية ينتقل إلى بطاقة محددة ويُبرزها — مفيد عند إنشاء رابط من تنبيه.

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

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

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

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

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

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

<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
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
source سلسلة نصية معرّف مصدر التتبّع.
service سلسلة نصية اسم الخدمة المحددة.
where سلسلة نصية نص استعلام عامل التصفية.
whereLanguage lucene 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>

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

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