چرا ابزار ایجنت اجرا نمی‌شود؟ پاسخ را از آخرین مرحله‌ای پیدا کنید که شاهد دارد. اگر اتصال اصلاً تنظیم نشده، ممکن است درخواست از مرحلهٔ آماده‌سازی عبور نکند. اگر ورودی نامعتبر است، ممکن است ابزار انتخاب شود ولی داده رد شود. اگر زمان انتظار تمام شود، ممکن است درخواست ارسال شده باشد ولی پاسخ به موقع نرسیده باشد.
سه شاهد برای سه مرحله
در آماده‌سازی، وجود ارجاع اتصال در محیط درست را بررسی کنید. در اعتبارسنجی، نام فیلد ضروری و نتیجهٔ بررسی داده را بنویسید. در ارسال، زمان شروع و پایان انتظار و شناسهٔ غیرحساس اجرای آزمایشی را ثبت کنید. یک پیام عمومی مثل «ابزار اجرا نشد» برای تمایز کافی نیست. اگر فقط همین پیام را دارید، منشأ خطا نامعلوم است.
استاندارد Trace Context روشی برای انتقال شناسهٔ ردگیری میان اجزای توزیع‌شده را توضیح می‌دهد. در تمرین محلی لازم نیست همین استاندارد را پیاده کنید. داشتن یک شناسهٔ آزمایشی مشترک در خروجی هر مرحله کمک می‌کند لاگ‌های یک تلاش را از تلاش دیگر جدا کنید. برای گزارش قابل اشتراک فقط همان شناسهٔ غیرحساس و وضعیت مرحله را نگه دارید.
سه سناریو با دادهٔ ساختگی
در آزمون اول ارجاع اتصال را در نمونهٔ آزمایشی خالی بگذارید و مطمئن شوید هیچ ارسال بیرونی رخ نمی‌دهد. در آزمون دوم اتصال ساختگی حاضر باشد ولی ورودی فیلد ضروری نداشته باشد. انتظار این است که خطای ورودی ثبت شود. در آزمون سوم یک ابزار ساختگی پاسخ را دیر بدهد. در این حالت باید آغاز ارسال و پایان مهلت از هم قابل تشخیص باشند.
پیش از اجرای هر سناریو، نتیجهٔ مورد انتظار و شمار فراخوانی را در برگه بنویسید. برای خطای ورودی بررسی کنید که پیام ایجنت از کاربر فقط اطلاعات لازم را بخواهد. برای پایان مهلت، پیام نباید ادعا کند هیچ اقدامی انجام نشده، مگر اینکه سامانه شاهد قطعی برای آن داشته باشد.
وقتی نتیجه به رفع مشکل تبدیل می‌شود
برای نبود اتصال، تنظیم محیط و مالک اتصال را بررسی کنید. برای ورودی نامعتبر، مسیر تولید داده یا اعتبارسنجی را اصلاح کنید. برای پایان مهلت، وضعیت عملیات اول و رفتار تلاش دوباره را بررسی کنید. هیچ‌کدام از این سه مرحله را صرفاً با زیادکردن زمان انتظار یکسان درمان نکنید.
بعد از رفع ایراد، یک مسیر موفق و همان مسیر ناموفق را دوباره اجرا کنید تا تغییر فقط یک پیام نمایشی نباشد. در برگه، شاهد اصلاح و نتیجهٔ هر دو مسیر را کنار هم بگذارید. این تمرین روی اتصال ساختگی است و درستی رفتار ابزار واقعی را باید در محیط مجاز جدا سنجید.
برگهٔ همراه
راهنمای مرتبط اپرا · آشنایی با راهکار مرتبط اپرا