لاگ‌ها

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

کاوشگر لاگ با شمار هر سطح، نمودار حجم و تازه‌ترین لاگ‌ها

جست‌وجو

کلمه‌ها را در کادر جست‌وجو بنویسید و Enter بزنید. کلمه‌ها در هر جای پیام و با هر ترتیبی پیدا می‌شوند. برای یافتن دقیق یک عبارت، آن را در گیومه بگذارید، مثل "rate limited".

نمودار، شمارش‌ها و فهرست همراه با جست‌وجوی شما به‌روز می‌شوند.

جست‌وجوی یک عبارت در گیومه همراه با فیلتر سرویس

فیلتر

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

فهرست فیلدهای قابل فیلتر، زیر کادر جست‌وجو
فیلترپیدا می‌کند
level:یک سطح: fatal،‏ error،‏ warn،‏ info،‏ debug یا trace
service:لاگ‌های یک سرویس
trace_id:همهٔ لاگ‌های یک درخواست در همهٔ سرویس‌ها
هر ویژگینامش را بنویسید، مثل http.route: یا customer.id:

هر فیلتر به یک برچسب در کادر جست‌وجو تبدیل می‌شود. برای حذف، روی × آن کلیک کنید. برای مستثنا کردن، پیش از فیلتر - بگذارید، مثل -level:debug.

فیلتر بر اساس سطح

برای باز کردن انتخابگر سطح، level: را بنویسید. نشان می‌دهد هر سطح چند لاگ دارد. برای انتخاب چند سطح فاصله و سپس Enter را بزنید. دو میان‌بر حالت‌های رایج را پوشش می‌دهند: level:>=warn هشدارها و موارد جدی‌تر را نگه می‌دارد و -level:debug لاگ‌های اشکال‌زدایی را پنهان می‌کند.

انتخابگر سطح با شمار هر سطح و دو میان‌بر

دکمهٔ سرویس کنار کادر جست‌وجو میان‌بری برای service: است. کلیک روی یک سطح بالای نمودار آن را روشن یا خاموش می‌کند.

نحو جست‌وجو

بنویسیدپیدا می‌کند
timeoutلاگ‌هایی که کلمه را دارند
"connection pool"دقیقاً همین عبارت
timeout retryهر دو کلمه، با هر ترتیبی
timeout OR refusedیکی از دو کلمه
-timeout یا NOT timeoutلاگ‌هایی که کلمه را ندارند
level:error service:apiهر دو فیلتر
(timeout OR refused) AND service:apiگروه‌بندی با پرانتز
service:"billing worker"مقداری با فاصله، در گیومه

AND،‏ OR و NOT با حروف بزرگ نوشته می‌شوند. اگر جست‌وجو قابل خواندن نباشد، مثلاً چون گیومه بسته نشده، کاوشگر این را اعلام می‌کند و نتایج قبلی را نگه می‌دارد.

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

تغییر بازهٔ زمانی

روی دکمهٔ بازهٔ زمانی کلیک کنید تا از ۱۵ دقیقهٔ اخیر تا ۷ روز اخیر را انتخاب کنید، یا با از و تا یک بازهٔ سفارشی تعیین کنید.

منوی بازهٔ زمانی با بازه‌های آماده و بازهٔ سفارشی

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

خواندن لاگ

روی یک ردیف کلیک کنید، یا با ↑ ↓ به آن بروید و Enter بزنید. پنل جزئیات باز می‌شود و این‌ها را دارد:

  • متن کامل پیام، همراه با کپی پیام.
  • لاگ‌های مشابه، برای جست‌وجوی پیام‌های مشابه.
  • N لاگ در این ردیابی ←، وقتی لاگ متعلق به یک درخواست باشد. همهٔ لاگ‌های آن درخواست را در همهٔ سرویس‌ها نشان می‌دهد.
  • ویژگی‌های لاگ و منبع آن (سرویس، میزبان و نسخه‌ای که از آن آمده). روی یک مقدار کلیک کنید تا بر اساسش فیلتر کنید، مستثنایش کنید یا کپی‌اش کنید.
لاگ خطایی که در پنل جزئیات باز شده، با پیام، پیوند ردیابی و ویژگی‌هایش

پیکان‌های بالای پنل به لاگ قبلی و بعدی می‌روند.

زنده

L را بزنید یا روی زنده کلیک کنید تا لاگ‌ها را همان لحظهٔ رسیدن ببینید. لاگ‌های جدید بالا می‌آیند و سرصفحه نشان می‌دهد در هر ثانیه چند لاگ می‌رسد. جست‌وجو و فیلترها همچنان اعمال می‌شوند، پس level:error در حالت زنده یک جریان زندهٔ خطاهاست.

نمایش زنده با لاگ‌های تازه‌ای که می‌رسند و نرخ در هر ثانیه

برای توقف، روی دکمهٔ مکث کلیک کنید یا دوباره L را بزنید. نمودار بازهٔ زمانی پیش از حالت زنده را حفظ می‌کند. اگر لاگ‌ها سریع‌تر از توان نمایش برسند، پیامی اطلاع می‌دهد: مکث کنید و جست‌وجو کنید تا همه را ببینید.

خروجی

لاگ‌های موردنظر را با کادرهای انتخاب علامت بزنید. بالای فهرست نواری با خروجی CSV،‏ خروجی JSON و کپی ظاهر می‌شود.

سه لاگ انتخاب‌شده با دکمه‌های خروجی CSV و JSON و کپی بالای فهرست

دکمهٔ دانلود در انتهای نوار جست‌وجو همهٔ لاگ‌های بارگذاری‌شده در فهرست را با فرمت CSV خروجی می‌گیرد. خروجی‌ها زمان، سرویس، سطح و پیام هر لاگ را دارند. برای گرفتن ویژگی‌های یک لاگ، آن را باز کنید و در پنل جزئیات از کپی به‌صورت JSON استفاده کنید.

میان‌برهای صفحه‌کلید

کلیدکاربرد
↓ ↑ یا J Kجابه‌جایی بین لاگ‌ها
Enterباز کردن لاگ انتخاب‌شده
Escبستن پنل جزئیات یا منو
Lشروع یا توقف نمایش زنده
Spaceانتخاب چند مقدار در انتخابگر