# التتبعات

Source: https://instatus.com/help/ar/observability/traces

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

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

![مستكشف التتبعات مع مدد الطلبات عبر الزمن وصف لكل طلب](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [البحث](https://instatus.com/help/ar/observability/traces#اعثر-على-الطلبات-البطيئة-والفاشلة) | status:error, duration:>1s, service: |
| [الفتح](https://instatus.com/help/ar/observability/traces#فتح-تتبع) | انقر على صف لرؤية الشلال |
| [الإصلاح](https://instatus.com/help/ar/observability/traces#إصلاح-طلب-فاشل) | انسخ موجّه إصلاح لوكيل البرمجة |
| [السجلات](https://instatus.com/help/ar/observability/traces#فتح-تتبع) | انتقل إلى سجلات الطلب |

تصل التتبعات حين يبدأ تطبيقك بإرسالها: حدّد **التتبعات** عند [نسخ موجّه الإعداد](https://instatus.com/help/ar/observability/send-logs#الطريقة-1-انسخ-موجّهًا)، أو استخدم القياس التلقائي.

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

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

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

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

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

استخدم مربع البحث كما في صفحة [السجلات](https://instatus.com/help/ar/observability/logs#التصفية). عوامل التصفية هذه مخصّصة للتتبعات:

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

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

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

## فتح تتبع

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

![تتبع يعبر ثلاث خدمات مع استدعاء بطيء إلى Okta أسفل الشلال](https://instatus.com/help/observability/trace-waterfall.png)

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

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

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

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

![طلب فاشل تظهر امتداداته الخاطئة باللون الأحمر مع زر لنسخ موجّه إصلاح](https://instatus.com/help/observability/trace-error.png)

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

- [المقاييس](https://instatus.com/help/ar/observability/metrics): اكتشف ما تغيّر، الأكبر تغيّرًا أولًا
- [السجلات](https://instatus.com/help/ar/observability/logs): ابحث في سجلاتك وصفِّها وتابعها مباشرةً
