پرش به محتوای اصلی

راهنمای نمایشگر لاگ

زمان مطالعه: ۲ دقیقه

این ابزار چیست؟

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

لاگ‌های JSON مثل pino و bunyan، لاگ دسترسی nginx و Apache، متن با زمان ISO و متن ساده پشتیبانی می‌شوند. فایل تا ۵۰ مگابایت در Web Worker و فقط در مرورگر شما خوانده می‌شود و چون لاگ ممکن است اطلاعات حساس داشته باشد، در تاریخچه ذخیره نمی‌شود.

گام‌به‌گام

  1. لاگ را بدهید

    فایل لاگ را رها کنید یا انتخاب کنید، یا متن را بچسبانید و «نمایش لاگ» را بزنید. متن چسبانده‌شده تا ۲ مگابایت و فایل تا ۵۰ مگابایت پذیرفته می‌شود.

  2. قالب را بررسی کنید

    «تشخیص خودکار» معمولاً درست کار می‌کند؛ اگر نه، از «قالب لاگ» قالب درست را انتخاب کنید.

  3. فیلتر کنید

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

  4. به حالت اول برگردید

    «بازنشانی فیلترها» همه‌ی فیلترها را برمی‌دارد تا دوباره کل لاگ را ببینید.

نمونه‌های کاربردی

  • لاگ JSON از pino

    سطح‌های عددی pino به نام سطح تبدیل می‌شوند؛ با فیلتر error فقط سطر دوم می‌ماند.

    {"level":30,"time":1735689600000,"msg":"server started"}
    {"level":50,"time":1735689601000,"msg":"db connection failed"}
    {"level":40,"time":1735689602000,"msg":"slow query"}

    نتیجه: قالب JSON؛ ۳ ورودی با سطح‌های info، error و warn

اشتباه‌های رایج

  • چسباندن فایل خیلی بزرگ در کادر متن: برای بیش از ۲ مگابایت از بارگذاری فایل استفاده کنید که در Web Worker و بدون قفل شدن صفحه خوانده می‌شود.
  • جست‌وجوی زمان به وقت سرور: بازه‌ی زمانی به وقت تهران است. اگر سرور روی UTC لاگ می‌نویسد، اختلاف سه ساعت و نیم را در نظر بگیرید.
  • فرستادن لاگ کامل برای دیگران: لاگ‌ها اغلب نشانی IP، ایمیل یا توکن دارند. پیش از اشتراک، فقط سطرهای لازم را بردارید و اطلاعات حساس را بپوشانید.
  • نادیده گرفتن سطرهای بدون سطح: در لاگ متن ساده برخی سطرها سطح ندارند؛ در فیلتر سطح، «بدون سطح» را هم در نظر داشته باشید.

لاگ ساختاریافته

لاگ JSON که هر سطرش یک شیء با فیلدهای ثابت مثل time، level و msg است، برای ماشین خواناتر از متن آزاد است: می‌شود آن را فیلتر کرد، شمرد و به سامانه‌های جمع‌آوری لاگ فرستاد. کتابخانه‌هایی مثل pino سطح را با عدد می‌نویسند؛ ۳۰ یعنی info، ۴۰ یعنی warn و ۵۰ یعنی error.

اگر برنامه‌ی خودتان هنوز متن آزاد لاگ می‌کند، دست‌کم زمان را با قالب ISO و سطح را در ابتدای سطر بنویسید تا ابزارهایی مثل همین بتوانند آن را بخوانند.

پرسش‌های متداول

فایل لاگ ارسال می‌شود؟
خیر. فایل فقط در مرورگر شما و در یک وب‌ورکر خوانده می‌شود و هیچ‌جا بارگذاری نمی‌شود.
چه قالب‌هایی پشتیبانی می‌شود؟
هر خط JSON با فیلدهای level، time و msg (pino و bunyan)، لاگ دسترسی nginx یا Apache (قالب combined) و متن با زمان ISO در ابتدای خط. قالب خودکار تشخیص داده می‌شود و می‌توانید دستی عوض کنید.
زمان‌های بدون منطقه‌ی زمانی چه می‌شوند؟
اگر لاگ منطقه‌ی زمانی نداشته باشد، زمان آن UTC فرض می‌شود و سپس به وقت تهران (تقویم شمسی) نمایش داده می‌شود.

ابزارهای مرتبط