ردیابی‌ها

ردیابی یعنی یک درخواست که در هر سرویسی که از آن عبور می‌کند دنبال می‌شود. هر گام یک اسپن است: یک فراخوانی 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 خروجی می‌گیرد.

باز کردن یک ردیابی

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

ردیابی‌ای که از سه سرویس عبور می‌کند، با یک فراخوانی کند به Okta در پایین آبشار

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

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

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

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

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

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