التتبعات

التتبع هو طلب واحد يُتابَع عبر كل خدمة يمر بها. كل خطوة هي امتداد: استدعاء HTTP، أو استعلام قاعدة بيانات، أو استدعاء لخدمة أخرى. تُظهر التتبعات أين قضى الطلب البطيء وقته وأين تعطّل الطلب الفاشل.

افتح Observability ← التتبعات في صفحة الحالة. كل صف يمثل طلبًا واحدًا.

مستكشف التتبعات مع مدد الطلبات عبر الزمن وصف لكل طلب

تصل التتبعات حين يبدأ تطبيقك بإرسالها: حدّد التتبعات عند نسخ موجّه الإعداد، أو استخدم القياس التلقائي.

قراءة الرسم البياني

كل نقطة طلب، موضوعة حسب وقت حدوثه ومدته. النقاط الحمراء طلبات فشلت. فوق الرسم البياني:

  • عمليات التتبع: عدد الطلبات التي وجدها البحث.
  • الأخطاء: عدد الطلبات الفاشلة ونسبتها.
  • p50 وp95 وp99: نصف الطلبات و95% و99% منها كانت أسرع من هذه القيمة.

اسحب على الرسم البياني لتكبير نافذة زمنية.

اعثر على الطلبات البطيئة والفاشلة

استخدم مربع البحث كما في صفحة السجلات. عوامل التصفية هذه مخصّصة للتتبعات:

عامل التصفيةيجد
status:errorالطلبات التي فشلت
duration:>1sالطلبات الأبطأ من ثانية. وكذلك >500ms و<100ms
service:apiالطلبات التي عالجتها خدمة واحدة
span.name:امتدادات باسم معيّن، مثل GET /v1/users
أي سمةمثل http.route: أو http.response.status_code:

يبحث النص الحر في أسماء الامتدادات. خيار الامتدادات الجذرية مفعّل افتراضيًا، فيظهر كل طلب مرة واحدة. عطّله لعرض كل امتداد على حدة.

يصدّر زر التنزيل القائمة بصيغة CSV.

فتح تتبع

انقر على صف. يُفتح التتبع وكل امتداد على خط زمني، متداخلًا تحت الامتداد الذي استدعاه. الأشرطة الطويلة هي حيث ذهب الوقت.

تتبع يعبر ثلاث خدمات مع استدعاء بطيء إلى Okta أسفل الشلال

في هذا المثال يستغرق تحميل صفحة 842 مللي ثانية. يوضح الشلال السبب: web يستدعي api، وapi يستدعي sso، وsso ينتظر Okta مدة 468 مللي ثانية.

  • انقر على امتداد لرؤية سماته، مثل المسار أو رمز الحالة أو استعلام قاعدة البيانات.
  • يفتح N سجل من هذا الامتداد ← السجلات المكتوبة خلال ذلك الامتداد.
  • يفتح N سجل في الأعلى كل سجلات الطلب عبر الخدمات.
  • ينسخ نسخ معرّف التتبع المعرّف لمشاركته أو للبحث به عبر trace_id:.
  • استخدم ↑ ↓ أو J K للانتقال إلى التتبع السابق أو التالي، وEsc للإغلاق.

إصلاح طلب فاشل

الامتدادات الفاشلة باللون الأحمر. يُخفي الأخطاء فقط الامتدادات الناجحة، فيبرز الفشل في التتبع الطويل.

طلب فاشل تظهر امتداداته الخاطئة باللون الأحمر مع زر لنسخ موجّه إصلاح

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