پرش به مطلب اصلی

مشاهده لاگ‌های پردازش‌ها

دستور log برای نمایش خروجی تمام پردازش‌های داخل یک کانتینر استفاده می‌شود. این دستور مشابه دستور tail -f در لینوکس عمل می‌کند و می‌تواند به‌صورت زنده لاگ‌ها را دنبال کند. همچنین امکان فیلتر کردن لاگ‌ها با کلمات کلیدی یا عبارت‌های منظم (Regex) را دارد.


🧩 دستور کلی

k3 container log [options] <containerId>
  • containerId: شناسه کانتینری که می‌خواهید لاگ‌های آن را مشاهده کنید.

⚙️ گزینه‌ها (Options)

گزینه کوتاهگزینه بلندتوضیح
-f--followمشاهده زنده‌ی لاگ‌ها (مانند دستور tail -f)
--filter <keyword>فیلتر کردن لاگ‌ها بر اساس کلمه یا Regex (درحال توسعه)
-h--helpنمایش راهنمای کامل دستور

📥 مثال‌های کاربردی

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

k3 container log cont1

✅ مشاهده زنده‌ی لاگ‌ها:

k3 container log -f cont1

✅ فیلتر کردن لاگ‌ها با یک کلمه کلیدی:(درحال توسعه)

k3 container log --filter error cont1

✅ فیلتر کردن لاگ‌ها با یک عبارت Regex:(درحال توسعه)

k3 container log --filter "^WARN.*timeout$" cont1

نکات مهم

با استفاده از گزینه --follow لاگ‌ها به‌صورت زنده (Real-Time) نمایش داده می‌شوند. با گزینه --filter می‌توانید لاگ‌ها را بر اساس کلمات کلیدی یا الگوهای خاص محدود کنید تا راحت‌تر به اطلاعات مهم دسترسی داشته باشید. این دستور تمام خروجی‌های پردازش‌های فعال در کانتینر را نمایش می‌دهد و برای دیباگ بسیار مفید است.


تست جامع

#!/bin/bash

echo "Starting k3 container log tests..."

echo "[1] Show logs of container cont1"
k3 container log cont1
echo

echo "[2] Show live logs of container cont1"
k3 container log -f cont1
echo

echo "[3] Filter logs with keyword 'error' (under development)"
k3 container log --filter error cont1
echo

echo "[4] Filter logs with regex '^WARN.*timeout$' (under development)"
k3 container log --filter "^WARN.*timeout$" cont1
echo

echo "All log tests completed."


🆘 دریافت راهنما

برای مشاهده‌ی راهنمای کامل این دستور در خط فرمان:

k3 container log -h