# ردیابی‌ها

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

ردیابی یعنی یک درخواست که در هر سرویسی که از آن عبور می‌کند دنبال می‌شود. هر گام یک اسپن است: یک فراخوانی HTTP، یک پرس‌وجوی پایگاه داده، یک فراخوانی به سرویسی دیگر. ردیابی‌ها نشان می‌دهند درخواست کند وقتش را کجا صرف کرده و درخواست ناموفق کجا خراب شده.

در صفحهٔ وضعیت خود **Observability** ← **ردیابی‌ها** را باز کنید. هر ردیف یک درخواست است.

![کاوشگر ردیابی با مدت درخواست‌ها در طول زمان و یک ردیف برای هر درخواست](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [یافتن](https://instatus.com/help/fa/observability/traces#یافتن-درخواستهای-کند-و-ناموفق) | status:error, duration:>1s, service: |
| [باز کردن](https://instatus.com/help/fa/observability/traces#باز-کردن-یک-ردیابی) | روی یک ردیف کلیک کنید تا آبشارش را ببینید |
| [رفع](https://instatus.com/help/fa/observability/traces#رفع-یک-درخواست-ناموفق) | پرامپت رفع مشکل را برای عامل برنامه‌نویسی کپی کنید |
| [لاگ‌ها](https://instatus.com/help/fa/observability/traces#باز-کردن-یک-ردیابی) | رفتن به لاگ‌های یک درخواست |

ردیابی‌ها وقتی می‌رسند که اپلیکیشن ارسالشان را شروع کند: هنگام [کپی پرامپت راه‌اندازی](https://instatus.com/help/fa/observability/send-logs#روش-۱-یک-پرامپت-کپی-کنید)، **ردیابی‌ها** را علامت بزنید یا از ابزارگذاری خودکار استفاده کنید.

## خواندن نمودار

هر نقطه یک درخواست است که بر اساس زمان وقوع و مدتش قرار گرفته. نقطه‌های قرمز ناموفق بوده‌اند. بالای نمودار:

- **ردیابی‌ها**: تعداد درخواست‌هایی که جست‌وجو پیدا کرده.
- **خطاها**: تعداد درخواست‌های ناموفق و سهمشان.
- **p50**،‏ **p95**،‏ **p99**: نیمی، ۹۵٪ و ۹۹٪ درخواست‌ها از این مقدار سریع‌تر بوده‌اند.

روی نمودار بکشید تا روی یک بازهٔ زمانی بزرگ‌نمایی کنید.

## یافتن درخواست‌های کند و ناموفق

از کادر جست‌وجو مثل صفحهٔ [لاگ‌ها](https://instatus.com/help/fa/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)

در این مثال بارگذاری یک صفحه ۸۴۲ میلی‌ثانیه طول می‌کشد. آبشار دلیلش را نشان می‌دهد: `web`،‏ `api` را فرامی‌خواند، `api`،‏ `sso` را فرامی‌خواند و `sso` ۴۶۸ میلی‌ثانیه منتظر Okta می‌ماند.

- روی یک اسپن کلیک کنید تا ویژگی‌هایش را ببینید، مثل مسیر، کد وضعیت یا پرس‌وجوی پایگاه داده.
- **N لاگ از این اسپن ←** لاگ‌هایی را که در طول آن اسپن نوشته شده‌اند باز می‌کند.
- **N لاگ** در بالا همهٔ لاگ‌های درخواست را در همهٔ سرویس‌ها باز می‌کند.
- **کپی شناسه ردیابی** شناسه را کپی می‌کند تا آن را به اشتراک بگذارید یا با `trace_id:` جست‌وجو کنید.
- با **↑** **↓** یا **J** **K** به ردیابی قبلی یا بعدی بروید و با **Esc** ببندید.

## رفع یک درخواست ناموفق

اسپن‌های ناموفق قرمز هستند. **فقط خطاها** اسپن‌های موفق را پنهان می‌کند تا خطا در یک ردیابی طولانی به چشم بیاید.

![درخواستی ناموفق با اسپن‌های خطادار به رنگ قرمز و دکمه‌ای برای کپی پرامپت رفع مشکل](https://instatus.com/help/observability/trace-error.png)

**کپی پرامپت برای رفع** توضیحی از درخواست ناموفق کپی می‌کند: اسپن‌ها، خطاها و ویژگی‌هایشان. آن را در عامل برنامه‌نویسی داخل پروژهٔ اپلیکیشن بچسبانید تا هر چه برای یافتن علت لازم دارد در اختیارش باشد.

- [متریک‌ها](https://instatus.com/help/fa/observability/metrics): تغییرات را ببینید، بزرگ‌ترین تغییر اول
- [لاگ‌ها](https://instatus.com/help/fa/observability/logs): لاگ‌ها را جست‌وجو، فیلتر و زنده دنبال کنید
