شماره راهنما33گزارش خطا و عیب‌یابی رخدادها
فیلتر و خواندن رخدادها، انتخاب چند مورد، شناسه پیگیری و گزارش امن به پشتیبانی.
صفحه گزارش خطا برای عیب‌یابی عملیاتی و فنی است. هر رخداد ممکن است زمان، شدت، کد، مسیر و شناسه پیگیری داشته باشد. این اطلاعات را از داده حساس جدا کنید و به جای حدس، زنجیره رخداد را با زمان و مسیر بازسازی کنید.
سطح و کد رخداد
شدت‌هایی مانند خطا و هشدار میزان اهمیت را نشان می‌دهند؛ کد رخداد نوع دسته‌بندی است. یک رخداد عمومی API ممکن است پیام یک استثنای داخلی را پوشش دهد. برای علت ریشه‌ای، رخداد مرتبط با همان شناسه را نیز بررسی کنید.
فیلتر و محدوده نمایش
بازه زمانی، شدت یا عبارت جست‌وجو را مشخص کنید و تعداد نتایج نمایش‌داده‌شده را کنترل کنید. فیلتر فعال ممکن است برخی رخدادها را پنهان کند. پیش از انتخاب گروهی مطمئن شوید تمام رکوردهای موردنظر در محدوده فعلی هستند.
انتخاب و پاک‌سازی گروهی
عبارت انتخاب همه به رخدادهای نمایش‌داده‌شده در همان فهرست مربوط است، نه لزوماً تمام رخدادهای ذخیره‌شده. پیش از حذف یا پاک‌سازی، تعداد و محدوده را بازبینی و در صورت نیاز خروجی مجاز را برای بررسی نگه دارید.
شناسه پیگیری و گزارش
شناسه درخواست یا رخداد، زمان دقیق، مسیر و چند گام بازتولید را ثبت کنید. پیام خطا را بدون رمز، توکن، کد OTP، داده شخصی یا اطلاعات پرداخت ارسال کنید. یک گزارش خوب شامل انتظار، نتیجه واقعی و شرایط وقوع است.
تشخیص علت از نشانه
خطای رابط ممکن است از API، سرویس خارجی، دیتابیس، سطح دسترسی یا صف ناشی شده باشد. پیام عمومی را علت قطعی فرض نکنید؛ رخدادهای هم‌زمان، کد پاسخ و لاگ سرویس مرتبط را کنار هم بررسی کنید.
نقشه اجرایی: گزارش خطا و عیب‌یابی رخدادها
نمای مفهومی از موضوعات این راهنما؛ عنوان‌ها و داده‌ها صرفاً آموزشی‌اند.
پس از مطالعه این راهنما چه مواردی را بررسی کنم؟
- پیش‌نیازها و محدوده دسترسی مرتبط با این بخش را پیش از شروع بررسی کنید.
- هر مرحله را با داده واقعی و در دامنه مجاز فضای کاری انجام دهید.
- پس از اجرا، وضعیت و نتیجه را در همان ماژول بازبینی کنید.
نکته مهم: این شبیه‌سازی داده واقعی را تغییر نمی‌دهد. نتیجه نهایی به مجوز کاربر، پلن، تنظیمات اتصال و سرویس‌های بیرونی وابسته است.