درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
داشبورد تحقیق به شما امکان می‌دهد جدول‌های محوری سنجه‌ها و مشخصه‌ها را برای همه ترافیک API مشاهده کنید و فعالیت‌های رابطه‌ای بین سنجه‌ها را مقایسه کنید تا مشکلات را سریع‌تر بررسی و تشخیص دهید. می‌توانید در داشبورد به داده‌های ۳۰ روز گذشته دسترسی داشته باشید.
در «واسط کاربر Edge»، تجزیه‌وتحلیل > پایش API > بررسی را انتخاب کنید تا داشبورد «بررسی» باز شود. داشبورد دو ناحیه اصلی دارد:
- کد وضعیت به شما امکان می‌دهد سنجه‌های کد وضعیت را برای پراکسی‌های API و سرویس‌های هدف بررسی کنید.
- تأخیر به شما امکان می‌دهد مشکلات تأخیر را برای پراکسی‌های API و سرویس‌های هدف بررسی کنید.
همچنین می‌توانید مشکلات ناشی از یک هشدار خاص را در داشبورد «تحقیق» بررسی کنید. وقتی هشداری رخ می‌دهد، در صفحه سابقه هشدار روی نام هشدار کلیک کنید تا هشدار در داشبورد «تحقیق» باز شود.
از داشبورد «بررسی» برای تشخیص خرابی مشکل استفاده کنید
برای مثال، هشداری دریافت می‌کنید که نشان می‌دهد نرخ خطای ۵xx از آستانه مشخص‌شده فراتر رفته است. برای بررسی این مشکل، می‌توانید تکالیف زیر را در داشبورد «بررسی» انجام دهید:
- ماتریس کد خطا دربرابر زمان را برای مشاهده فعالیت کد خطا در ساعت گذشته مشاهده کنید.
- به ماتریس کد خطا دربرابر وضعیت HTTP بروید تا کدهای وضعیت HTTP خاص مرتبط با کدهای خطایی را که تعداد آن‌ها در ساعت گذشته افزایش یافته است، همان‌طور که در مرحله قبل شناسایی شد، شناسایی کنید.
- به ماتریس کد خطا دربرابر پراکسی بروید تا پراکسی‌های میانای برنامه‌سازی کاربردی را که کدهای خطای شناسایی‌شده در مرحله قبل را راه‌اندازی می‌کنند شناسایی کنید.
- روی چارگوش در ماتریسی که با پراکسی API با حجم بالای کدهای خطا مرتبط است کلیک کنید تا جزئیات بیشتر و گزارش‌های دسترسی را مشاهده کنید.
- برای کمک بیشتر به تشخیص مشکل، هشدار تنظیم کنید و گزارش سفارشی ایجاد کنید.
بااستفاده از ردیابی و ابزارهای دیگر، کارگزار نیابتی API را بیشتر عیب‌یابی کنید تا راه‌حلی برای مشکل پیدا کنید.
استفاده از داشبورد «کد وضعیت»
داشبورد «کد وضعیت» به شما امکان می‌دهد سنجه‌های کد وضعیت را برای پراکسی‌های API و سرویس‌های هدف در سازمانتان بررسی کنید. می‌توانید سنجه‌های کد وضعیت را برای بازه زمانی یک یا چهار ساعته در هر زمانی در ۳۰ روز گذشته مشاهده کنید.
کاوش داشبورد «کد وضعیت»
برای نمایش داشبورد «کد وضعیت»، در «میانای کاربری Edge»، تجزیه‌وتحلیل > پایش API > بررسی را انتخاب کنید. داشبورد «کد وضعیت» به‌طور پیش‌فرض موارد زیر را نمایش می‌دهد:
همان‌طور که در شکل نشان داده شده است، داشبورد «تحقیق» به شما امکان می‌دهد:
- با تنظیم محور x و محور y هر ماتریس، هر ماتریس را پیکربندی کنید تا فعالیت رابطه‌ای بین سنجه‌ها را مقایسه کنید و اطلاعات آماری بیشتری به‌دست آورید.
- براساس سایه‌بندی رنگ یک بلوک، به‌سرعت سنجه‌هایی را که بالاترین حجم نسبی را تجربه می‌کنند شناسایی کنید. هرچه بلوک تیره‌تر باشد، حجم نسبی بیشتر است.
- برای مشاهده جزئیات سنجه، روی یکی از بلوک‌های ماتریس کلیک کنید.
- داده‌ها را براساس موارد زیر فیلتر کنید:
- محیط زیست
- منطقه
- پراکسی
- کدهای وضعیت (شامل همه ترافیک، همه خطاها، 2xx، 4xx، یا 5xx)
- تاریخ و زمان در ۳۰ روز گذشته
- بازه ۱ ساعته یا ۴ ساعته
از داشبورد برای انجام سریع کارهای زیر استفاده کنید:
- در پانل جزئیات سنجه، به گزارش‌های دسترسی دسترسی پیدا کنید.
- با کلیک کردن روی
> مشاهده در «موارد اخیر» یا مشاهده در «خط زمان»، به‌ترتیب، بافت کنونی را در موارد اخیر یا خط زمان یا داشبورد مشاهده کنید. - گزارش سفارشی ایجاد کنید و با کلیک کردن روی
ابعاد بیشتری اضافه کنید. - ایجاد هشدار و افزودن شرایط هشدار اضافی، راه‌اندازی اعلان‌ها، و تولید گزارش سفارشی براساس هشدار.
پیکربندی ماتریس «کد وضعیت»
وقتی داشبورد کد وضعیت را انتخاب می‌کنید، ماتریس‌های زیر به‌طور پیش‌فرض ظاهر می‌شوند:
- کد خطا دربرابر زمان
- کد خطا دربرابر وضعیت HTTP
- منبع خطا دربرابر پراکسی میانای برنامه‌سازی کاربردی
هر ماتریس را پیکربندی کنید تا با انتخاب مقدار برای فهرست‌های کرکره‌ای محور x و محور y، هر دو سنجه زیر را مقایسه کنید:
- کد خطا
- خط‌مشی خطا
- منبع خطا
- وضعیت HTTP
- پراکسی
- زمان
- منطقه
- هدف (سرویس هدف یا خط‌مشی «دعوت به اقدام سرویس». اگر هدف خط‌مشی «خدمات پیامک‌دار» باشد، مقدار نمایش‌داده‌شده با
sc://پیشوندگذاری می‌شود. برای مثال،sc://my.endpoint.net.)
مشاهده جزئیات سنجه «کد وضعیت»
با کلیک کردن روی بلوک سنجه موردنظر در ماتریس، جزئیات آن سنجه را مشاهده کنید.
جزئیات مربوط به علت مشکوک در قاب سمت راست نمایش داده می‌شود، ازجمله:
- محیط زیست
- سازمان
- منطقه
- منبع خطا (کارگزار نیابتی، هدف، یا زیرساخت Apigee)
جزئیات ممکن است شامل موارد زیر نیز باشد:
- خط‌مشی خطا - اطلاعات مربوط به خط‌مشی‌ای که باعث خطای زمان اجرا شده است، ازجمله نوع خط‌مشی (نام داخلی) و نام خط‌مشی تعریف‌شده توسط کاربر. نام را هنگام پیوست کردن خط‌مشی به جریان پراکسی API تعریف می‌کنید.
- نام پراکسی
- رمز وضعیت HTTP
- کد خطا
اگر کاردینالیتی برای یک سنجه خاص بیشتر از یک باشد، پانل جزئیات ممکن است شامل جزئیات توزیع خطا، مانند توزیع براساس برنامه توسعه‌دهنده، توزیع براساس خط‌مشی خطا، توزیع براساس کد خطا، توزیع براساس وضعیت HTTP، و غیره باشد. برای مثال:
اگر منبع خطا هدف باشد، پانل جزئیات شامل «نرخ خطا براساس هدف» خواهد بود. برای مثال:
استفاده از داشبورد «تأخیر»
داشبورد «تأخیر» اطلاعات تأخیر را برای پراکسی‌های API و سرویس‌های مقصد در سازمانتان نمایش می‌دهد. می‌توانید سنجه‌های تأخیر را برای پنجره یک‌ساعته در هر زمانی در ۳۰ روز گذشته بررسی کنید.
کاوش داشبورد «تأخیر»
برای نمایش داشبورد «تأخیر»، در «واسط کاربر Edge»، تجزیه‌وتحلیل > پایش API > بررسی را انتخاب کنید. داشبورد «کد وضعیت» به‌طور پیش‌فرض نمایش داده می‌شود. تأخیر را در ناحیه فیلتر انتخاب کنید تا داشبورد «تأخیر» نمایش داده شود:
وقتی داشبورد «تأخیر» را انتخاب می‌کنید، ماتریس‌های زیر به‌طور پیش‌فرض ظاهر می‌شوند:
- کارگزاری دربرابر زمان (حداکثر تأخیر به میلی‌ثانیه)
- پراکسی دربرابر تأخیر کل (حداکثر تأخیر برحسب میلی‌ثانیه)
- تأخیر پراکسی دربرابر همه هدف‌ها (حداکثر تأخیر برحسب میلی‌ثانیه)
از چارگوش کرکره‌ای پراکسی برای انتخاب هدف استفاده کنید تا تأخیرهای هدف را مشاهده کنید.
به‌طور پیش‌فرض، داشبورد «تأخیر» اطلاعات مربوط به ۱۰ پراکسی با بالاترین تأخیر کل P99 را برای ساعت قبلی نشان می‌دهد. یا اینکه از چارگوش کرکره‌ای ۱۰ برتر برای انتخاب پراکسی یا مجموعه خاصی استفاده کنید.
داشبورد «تأخیر» همه ویژگی‌های داشبورد «کد وضعیت» را دارد، با تفاوت‌های زیر:
- فقط درصد تأخیر پاسخ کلی (p50، p90، p95، p99) را پیکربندی می‌کنید.
- فقط می‌توانید یک بازه یک‌ساعته برای سنجه‌های تأخیر انتخاب کنید.
- نمی‌توانید هر را برای منطقه در فیلترها انتخاب کنید. باید منطقه خاصی را برای مشاهده انتخاب کنید.
مشاهده جزئیات سنجه «تأخیر»
با کلیک کردن روی بلوک سنجه موردنظر در ماتریس، جزئیات آن سنجه را مشاهده کنید.
جزئیات مربوط به تأخیر برای پراکسی (خط آبی) و هدف (خط بنفش) در قاب سمت چپ نمایش داده می‌شود، ازجمله:
- کل تأخیر (تأخیر پراکسی به‌علاوه تأخیر هدف)
- تأخیر به‌ازای هر هدف (زمان پاسخ هدف)
- توزیع براساس وضعیت HTTP
برای مشاهده اطلاعات دقیق، روی نمودار نگه‌دارید:
گراف تأخیر به‌ازای هدف شانزده هدف برتر را براساس حداکثر تأخیر نشان می‌دهد و برای هر هدف یک گراف ارائه می‌دهد. برای تعیین نموداری که با هر هدف مطابقت دارد، روی نمودار نگه دارید یا فهرست کرکره‌ای را انتخاب کنید.
مشاهده گزارش‌ها از جزئیات سنجه‌ها
هنگام مشاهده جزئیات سنجه برای کدهای وضعیت یا تأخیر، روی مشاهده گزارش‌ها کلیک کنید تا همه گزارش‌های سنجه انتخاب‌شده را ببینید:
کادر گفتگوی «گزارش‌های ترافیک» باز می‌شود و حداکثر ۱۰۰۰ ورودی گزارش را نمایش می‌دهد. روی ورودی گزارش کلیک کنید تا جزئیات آن در فهرست ازهم باز شود:
می‌توانید گزارش‌های ثبت‌شده را براساس موارد زیر بیشتر فیلتر کنید:
- منبع ترافیک
- نوع خطا
- حداقل زمان پاسخ‌دهی
نمی‌توانید داده‌های گزارش‌ها را از کادر گفتگوی «گزارش‌های ترافیک» بارگیری کنید. بااین‌حال، می‌توانید گزارش سفارشی ایجاد کنید یا داده‌های Analytics را بارگیری کنید در مخزن داده خودتان، مثل Google Cloud Storage یا BigQuery، تا تجزیه‌وتحلیل داده‌های خودتان را انجام دهید.
ایجاد گزارش سفارشی از داشبورد «تحقیق»
گزارش سفارشی براساس مجموعه شرایط انتخاب‌شده ایجاد کنید. پس‌از ایجاد گزارش سفارشی، می‌توانید آن را ویرایش کنید تا سنجه‌ها و ابعاد را درصورت نیاز اضافه یا حذف کنید. برای مثال، ممکن است بخواهید تحقیقات خود را به یک کد دسترسی خاص، برنامه توسعه‌دهنده، یا پراکسی API محدود کنید. برای اطلاعات بیشتر، مرجع سنجه‌ها، ابعاد، و فیلترهای Analytics را ببینید.
برای اطلاعات بیشتر، ایجاد گزارش‌های سفارشی را ببینید.
برای ایجاد گزارش سفارشی:
برای نمایش جزئیات بیشتر، روی یک بلوک در ماتریس کلیک کنید.
در قاب سمت چپ، روی
کلیک کنید.
صفحه گزارش سفارشی در زبانه جدیدی با فیلدهای مرتبط ازپیش تکمیل‌شده نمایش داده می‌شود.
توجه: برای اطلاعات بیشتر درباره تنظیمات گزارش سفارشی پیش‌فرض، ایجاد گزارش‌های سفارشی را ببینید.
گزارش سفارشی را درصورت نیاز ویرایش کنید. مدیریت گزارش‌های سفارشی را ببینید.
برای ذخیره کردن گزارش سفارشی، روی ذخیره کلیک کنید.
گزارش به‌طور پیش‌فرض بااستفاده از داده‌های جمع‌آوری‌شده در ساعت گذشته اجرا می‌شود و داده‌ها در داشبورد گزارش سفارشی نمایش داده می‌شود. کاوش داشبورد گزارش‌های سفارشی را ببینید.
در صفحه گزارش‌ها، گزارش‌های سفارشی که بااستفاده از «پایش میانای برنامه‌سازی کاربردی» تولید می‌شوند بااستفاده از قالب زیر نام‌گذاری می‌شوند: API Monitoring Investigate Generated.
بررسی هشداری خاص
برای بررسی یک هشدار خاص، نام هشدار را در صفحه سابقه هشدار انتخاب کنید. داشبورد «تحقیق» نشان داده می‌شود. توجه داشته باشید که در بالای داشبورد نموداری وجود دارد و فقط اطلاعات مربوط به هشدار را دربرمی‌گیرد:
- جزئیات ترافیک «میانای برنامه‌سازی کاربردی» را در زمان فعال شدن هشدار مشاهده کنید.
- اطلاعات زمینه‌ای درباره هشدار، ازجمله زمان راه‌اندازی هشدار در مرکز نمودار را مشاهده کنید.
- روی جزئیات وضعیت کلیک کنید تا جزئیات وضعیت هشدار در پنجره بالاپری نمایش داده شود.
برای مشاهده دفترچه هشدار، روی دفترچه (درصورت وجود) کلیک کنید:
برای ویرایش هشدار، روی مدیریت هشدار کلیک کنید.
برای مشاهده گزارش سفارشی، روی مشاهده گزارش (درصورت دردسترس بودن) کلیک کنید.
درصورت نیاز، بازآوری خودکار صفحه را فعال یا غیرفعال کنید.