Kubit logoکوبیت

مشاهده لاگ کانتینرهای پک

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

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

پیش‌نیازها و محرمانگی

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

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

بازکردن صفحه لاگ

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

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

انتخاب منبع لاگ

برای تغییر منبع، ابتدا قطع اتصال را بزنید. فیلترهای صفحه هنگام اتصال غیرفعال‌اند. سپس این موارد را به‌ترتیب انتخاب کنید:

  1. از فهرست ورک‌لود یک یا چند ورک‌لود را انتخاب کنید.
  2. از فهرست پاد پادهای همان ورک‌لودها را مشخص کنید.
  3. از فهرست کانتینر کانتینرهای مورد نظر را انتخاب کنید.

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

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

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

انتخاب نقطه شروع لاگ

از فهرست نمایش آخرین مشخص کنید چه مقدار از لاگ موجود در شروع اتصال دریافت شود. گزینه‌های فعلی پنل عبارت‌اند از ۱۰ خط، ۱۰۰ خط، ۱۰۰۰ خط، ۱ دقیقه، ۳۰ دقیقه، ۱ ساعت و ۱۲ ساعت. مقدار پیش‌فرض ۱۰۰ خط است.

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

کنترل‌های نمایش لاگ

نوار پایین نمایشگر وضعیت اتصال و این کنترل‌ها را دارد:

  • شکستن خطوط: خط‌های بلند را در عرض نمایشگر ادامه می‌دهد؛ در حالت خام برای دیدن ادامه خط باید افقی پیمایش کنید.
  • نمایش زمان: زمان همراه خط را کنار پیام نشان می‌دهد. اگر خط زمان قابل تشخیصی نداشته باشد، زمان دریافت آن نمایش داده می‌شود؛ برای تحلیل دقیق زمانی، خود اپلیکیشن باید زمان را در خروجی ثبت کند.
  • نمایش نام پادها و نمایش نام کانتینرها: منبع هر خط را مشخص می‌کنند و برای اتصال چندمنبعی مفیدند.
  • اسکرول خودکار: با رسیدن خط تازه، نمایش را به انتهای خروجی می‌برد. این گزینه هنگام بازشدن صفحه فعال است.
  • پاک کردن صفحه: فقط خطوط موجود در نمایشگر مرورگر را پاک می‌کند؛ لاگ کانتینر یا داده‌ای در کلاستر حذف نمی‌شود.

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

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

استفاده از فرمان kubectl

وقتی فقط یک پاد انتخاب شده باشد، پایین صفحه فرمان kubectl logs متناسب با فضای نام، پاد و کانتینرهای انتخاب‌شده نمایش داده می‌شود. فرمان را در محیطی اجرا کنید که kubectl برای همان کلاستر پیکربندی شده باشد.

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

اگر چند پاد انتخاب شده باشند، این کادر غیرفعال است. در انتخاب چند کانتینر نیز فرمان می‌تواند از --all-containers استفاده کند یا جای‌نگهدار کانتینر نشان دهد؛ پیش از اجرا نام پاد و کانتینر را در فرمان بررسی کنید. این فرمان فقط انتخاب منبع را بازتاب می‌دهد و کنترل‌های نمایشی پنل را به خط فرمان منتقل نمی‌کند.

مشکلات رایج

فیلترها قابل تغییر نیستند

تا زمانی که اتصال برقرار یا در حال برقراری است، فیلترهای ورک‌لود، پاد، کانتینر و نقطه شروع غیرفعال می‌مانند. قطع اتصال را بزنید و پس از تغییر انتخاب‌ها دوباره متصل شوید.

هیچ خطی نمایش داده نمی‌شود

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

اتصال از سمت سرور متوقف می‌شود

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

تشخیص منبع خط‌ها دشوار است

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

لاگ | مستندات | کوبیت