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

ردیابیها وقتی میرسند که اپلیکیشن ارسالشان را شروع کند: هنگام کپی پرامپت راهاندازی، ردیابیها را علامت بزنید یا از ابزارگذاری خودکار استفاده کنید.
خواندن نمودار
هر نقطه یک درخواست است که بر اساس زمان وقوع و مدتش قرار گرفته. نقطههای قرمز ناموفق بودهاند. بالای نمودار:
- ردیابیها: تعداد درخواستهایی که جستوجو پیدا کرده.
- خطاها: تعداد درخواستهای ناموفق و سهمشان.
- p50، p95، p99: نیمی، ۹۵٪ و ۹۹٪ درخواستها از این مقدار سریعتر بودهاند.
روی نمودار بکشید تا روی یک بازهٔ زمانی بزرگنمایی کنید.
یافتن درخواستهای کند و ناموفق
از کادر جستوجو مثل صفحهٔ لاگها استفاده کنید. این فیلترها مخصوص ردیابیها هستند:
| فیلتر | پیدا میکند |
|---|---|
status:error | درخواستهایی که ناموفق بودند |
duration:>1s | درخواستهای کندتر از یک ثانیه. همچنین >500ms و <100ms |
service:api | درخواستهایی که یک سرویس پردازش کرده |
span.name: | اسپنهایی با نام مشخص، مثل GET /v1/users |
| هر ویژگی | مثل http.route: یا http.response.status_code: |
متن آزاد در نام اسپنها جستوجو میکند. اسپنهای ریشه بهطور پیشفرض روشن است، پس هر درخواست یک بار نمایش داده میشود. خاموشش کنید تا هر اسپن جداگانه فهرست شود.
دکمهٔ دانلود، فهرست را با فرمت CSV خروجی میگیرد.
باز کردن یک ردیابی
روی یک ردیف کلیک کنید. ردیابی باز میشود و هر اسپن روی یک خط زمانی، زیر اسپنی که آن را فراخوانده، قرار میگیرد. نوارهای بلند نشان میدهند وقت کجا رفته.

در این مثال بارگذاری یک صفحه ۸۴۲ میلیثانیه طول میکشد. آبشار دلیلش را نشان میدهد: web، api را فرامیخواند، api، sso را فرامیخواند و sso ۴۶۸ میلیثانیه منتظر Okta میماند.
- روی یک اسپن کلیک کنید تا ویژگیهایش را ببینید، مثل مسیر، کد وضعیت یا پرسوجوی پایگاه داده.
- N لاگ از این اسپن ← لاگهایی را که در طول آن اسپن نوشته شدهاند باز میکند.
- N لاگ در بالا همهٔ لاگهای درخواست را در همهٔ سرویسها باز میکند.
- کپی شناسه ردیابی شناسه را کپی میکند تا آن را به اشتراک بگذارید یا با
trace_id:جستوجو کنید. - با ↑ ↓ یا J K به ردیابی قبلی یا بعدی بروید و با Esc ببندید.
رفع یک درخواست ناموفق
اسپنهای ناموفق قرمز هستند. فقط خطاها اسپنهای موفق را پنهان میکند تا خطا در یک ردیابی طولانی به چشم بیاید.

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