آموزش راه اندازی و آنالیز لاگ ووکامرس

گزارش‌های خطا (error logs) ابزاری ضروری برای عیب یابی خطاهای ووکامرس هستند که اطلاعات ارزشمندی در مورد هر گونه خطای PHP ارائه می‌دهند و به شما امکان می‌دهد آنها را به سرعت حل کنید.
این مطلب نشان می‌دهد که چگونه لاگ‌های خطای ووکامرس را تنظیم و تجزیه و تحلیل کنید. ما همچنین نحوه تکمیل ووکامرس لاگ را با یک افزونه بررسی خواهیم کرد تا با این دانش، بتوانید هر مشکلی را در فروشگاه آنلاین به سرعت شناسایی و برطرف کنید.

لاگ ووکامرس

ووکامرس، لاگ‌های خود را ندارد. همانطور که در PHP نوشته شده است، هر خطای ووکامرس در گزارش خطای PHP نشان داده می شود. ووکامرس مجموعه و مدیریت ثبت خطاهای PHP خود را ارائه می دهد که باعث دسترسی بیشتر به گزارش‌ها می شود. همچنین کنترل بیشتری بر نحوه مدیریت لاگ‌ها فراهم می‌کند.

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

فعال کردن گزارش‌های ووکامرس

برای فعال کردن لاگ ووکامرس، ابتدا به WooCommerce > Status بروید و روی زبانه Logs کلیک کنید. در مرحله بعد روی گزینه Settings کلیک کنید که درست در زیر گزینه‌های تب شده پیدا می کنید.

تیک گزینه Enable logging را بزنید و سپس انتخاب کنید که آیا می خواهید فایل های گزارش را به عنوان یک فایل یا در دیتابیس ذخیره کنید.

نکته: ووکامرس برای هر گزینه ذخیره سازی یک log handler متفاوت دارد. گزارش‌ها توسط کنترل‌کننده AutomatticWooCommerceInternalAdminLoggingLogHandlerFileV2 در فایل‌ها ثبت می‌شوند در حالی که هنگام انتخاب گزینه دیتابیس از کنترل‌کننده گزارش WC_Log_Handler_DB استفاده می‌شود.

در نهایت، Retention period را انتخاب کنید، که تعداد روزهایی که لاگ‌ها حفظ می‌شوند و Level threshold را مشخص می‌کند. هنگام تنظیم آستانه سطح، به خاطر داشته باشید که هر چیزی با شدت کمتر از گزینه ای که انتخاب می کنید ثبت نمی‌شود. اگر می خواهید همه چیز را ثبت کنید، None را انتخاب کنید.

در قسمت تنظیمات فایل سیستم، موارد زیر را نیز خواهید دید:

• وضعیت (Status): به ما می‌گوید که آیا گزارش در حال اجرا است یا مشکلی دارد
• مکان(Location): مسیر فایل مطلق جایی که فایل‌های لاگ ذخیره می شوند

دسترسی به ووکامرس لاگ‌های خطای PHP

همانطور که قبلا ذکر کردیم، دسترسی به لاگ های خطای ووکامرس آسان است. می‌توانید همه گزارش‌ها را مستقیم از پیشخوان وردپرس مشاهده و در صورت تمایل آنها را دانلود کنید.
برای دسترسی به گزارش‌ها، به WooCommerce > Status بروید و روی زبانه Logs کلیک کنید. به طور پیش‌فرض، این پنجره Browse را باز می‌کند، جایی که می‌توانید تمام فایل‌های لاگ موجود را مشاهده کنید. اگر اینطور نیست، روی Browse درست در زیر گزینه‌های تب شده کلیک کنید.

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

درک لاگ‌های ووکامرس

ووکامرس، لاگ را بر اساس منبع و تاریخ سازماندهی می‌کند. به جای یک فایل لاگ بزرگ، چندین فایل لاگ را برای هر روز پیدا خواهید کرد. هر یک از فای‌های لاگ شامل پیام‌های گزارش مربوط به منبعی است که آنها را ایجاد کرده است. بنابراین، برای مثال، fatal errors در فایل log fatal-errors ثبت می شوند، در حالی که debug logs در فایل log debug-log-generator ثبت می‌شوند.

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

هر ورودی لاگ شامل اطلاعات زیر خواهد بود:

• Timestamp: به شما امکان می‌دهد تاریخ و زمان وقوع خطا را بدانید
• Level: نشان می‌دهد که این رویداد چقدر شدید است (در بخش بعدی به این موضوع خواهیم پرداخت)
• Message: بدنه ورودی گزارش که اطلاعاتی در مورد آنچه اتفاق افتاده را ارائه می‌دهد
• Source: بخشی از کد که خطا را ایجاد کرده است
• Context: مانند متادیتا، اطلاعات اضافی مربوط به رویداد را ارائه می‌دهد

علاوه بر این، اگر backtrace فعال باشد، ورودی شامل یک error stack trace می‌شود. این ممکن است شامل موارد زیر باشد:

• لینکی به فایل PHP که خطا را ایجاد کرده و از پوشه root سرور شروع می شود
• خط کدی که در آن با خطا مواجه شد
• نام تابع و کلاسی که خطا را ایجاد کرده است

سطوح لاگ

سطوح (Levels) به ما می‌گویند که یک موضوع مشخص چقدر شدید است که به دو دلیل مهم است. اول به ما امکان می‌دهد اولویت بندی کنیم (fatal errors در php معمولا موارد مهم‌تر هستند) و گزارش را فیلتر کنیم تا بتوانیم مواردی را که بیشتر مورد علاقه ما هستند را ببینیم.

1. Emergency: بالاترین سطح شدت، نشان می دهد که ووکامرس غیر قابل استفاده شده است.
2. Alert: سطح شدت بالاتر از حد بحرانی است و باید فورا مورد بررسی قرار گیرد
3. Critical: شرایط بحرانی پیش آمده که باید در اسرع وقت بررسی شود
4. Error: شرایط خطا مواجه شده است
5. Warning: شرایط استثنایی پیش آمده که خطا نیست
6. Notice: شرایط عادی اما قابل توجه را نشان می‌دهد
7. Info: پیام‌های اطلاعاتی
8. Debug: پیام‌های سطح دیباگ

تنظیم فایل‌های لاگ سفارشی

اگر کد سفارشی مانند افزونه ووکامرس را اضافه کنید، ممکن است بخواهید قابلیت‌های logging را اضافه کنید. این تضمین می کند که وقتی رویدادهایی مانند fatal errors رخ می دهند، به درستی در فایل‌های لاگ ووکامرس گزارش می‌شوند.

شما می‌توانید با استفاده از تابع ()wc_get_logger در PHP برای دسترسی به کلاس WC_Logger با استفاده از روش زیر به این هدف برسید:

WC_Logger::log( $level, $message, $context )

گسترش error log با activity log ووکامرس

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

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

با خرید هاست وردپرس کانفیگ حرفه‌ای و نظارت بر سرور به صورت پیوسته توسط تیم فنی پارسدِو انجام خواهد شد.

گزارش فعالیت WooCommerce چیست؟

درست مانند لاگ خطای ووکامرس، گزارش فعالیت ووکامرس نیز فعالیت های کاربر و سیستم را ثبت می کند. ووکامرس مستقیم از این عملکرد پشتیبانی نمی‌کند، بنابراین شما به یک افزونه مانند WP Activity Log خود نیاز دارید.

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

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

گزارش فعالیت WooCommerce با جزئیات

WP Activity Log سازگاری خارج از جعبه را با ووکامرس ارائه می‌دهد که می تواند رویدادهای بومی ووکامرس را ردیابی کرده و به شما امکان می دهد:

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

فرآیندهای عیب یابی را آسان کنید

WP Activity Log می‌تواند به شما کمک کند با ارائه زمینه‌های مربوط به خطا، بیشترین استفاده را از گزارش‌های خطای ووکامرس ببرید. فرض کنید یک fatal error دریافت کرده‌اید، اما کاملا مطمئن نیستید که چه چیزی باعث آن شده است. با مراجعه به گزارش فعالیت، می توانید مشاهده کنید که چه فعالیت های کاربر همزمان با وقوع خطا انجام می شود.
بنابراین، اگر یک به‌روزرسانی افزونه همزمان با Fatal Error PHP توسط ووکامرس انجام شود، می‌توانیم به سرعت آن افزونه را غیرفعال کنیم یا آن را به نسخه قبلی برگردانیم. در چنین مواردی ما مجبور نیستیم لاگ‌های بی شماری از خطاهای php را بررسی نموده یا همه پلاگین‌ها را برای این موضوع غیرفعال کنیم

تلاش برای شناسایی کلاهبرداری

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

دستیابی به انطباق

استانداردهایی مانند GDPR شرکت‌ها را ملزم می‌کنند که یک گزارش دسترسی داشته باشند که در آن جزئیات چه کسی به منابع دسترسی داشته باشد. از آنجایی که WP Activity Log ، ووکامرس، وردپرس و چندین افزونه شخص ثالث دیگر را پوشش می دهد، گزارش دسترسی کل وب شما را پوشش می‌دهد.
WP Activity Log تاریخ و زمان و همچنین آدرس IP، کاربر و تغییرات ایجاد شده را ثبت می کند.

بهبود پاسخگویی کاربر

پاسخگو بودن کاربران کمک زیادی به جلوگیری از حوادث فنی و عملیاتی می‌کند که به راحتی قابل اجتناب است. این تضمین می‌کند که همه با دقت لازم کار می کنند و به رویه ها پایبند هستند.
با استفاده از مثال قبلی از اشتباه به‌روزرسانی، گزارش WP Activity Log به ما می‌گوید کدام کاربر به‌روزرسانی را آغاز کرده است. اگر این با استراتژی به‌روزرسانی وردپرس مطابقت نداشته باشد، فرصتی عالی برای اشتراک‌گذاری مجدد استراتژی فراهم می‌کند و اطمینان حاصل می‌کند که همه آگاه و در جریان هستند، بنابراین از حوادث مشابه در آینده جلوگیری می‌شود.

جمع‌بندی

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