شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات
این بخش مانیتورینگ API را با Edge Analytics مقایسه میکند. در حالی که هر دو API Monitoring و Edge Analytics به شما امکان می دهند داده های API را جمع آوری و مشاهده کنید، اهداف متفاوتی دارند:
- هدف API Monitoring این است که اطمینان حاصل شود که API های شما همانطور که در نظر گرفته شده آماده و اجرا می شوند. برای این منظور، می خواهید آخرین داده های موجود را مشاهده کنید. API Monitoring داده هایی را ارائه می دهد که بسیار نزدیک به زمان واقعی هستند و به شما امکان می دهد هشدارهایی ایجاد کنید که در صورت بروز مشکل به شما اطلاع می دهند.
- هدف Edge Analytics درک رفتار بلندمدت API های شما است، به طوری که می توانید اطمینان حاصل کنید که آنها نیازهای کسب و کار شما را پشتیبانی می کنند یا در صورت لزوم تغییراتی ایجاد کنید. برای این اهداف، دیدن داده های بلادرنگ اهمیت کمتری دارد. در نتیجه، دادههای Analytics کمی تأخیر میافتد، البته معمولاً حداکثر 10 دقیقه.
توجه داشته باشید که داده های API Monitoring که بیشتر مربوط به کدهای خطا و تأخیر است، زیرمجموعه کوچکی از داده های Analytics است.
تفاوت بین داده های API Monitoring و داده های Analytics
این بخش برخی تفاوتهای جزئی را بین دادههای جمعآوریشده توسط Edge Analytics در مقابل نظارت API توضیح میدهد. از آنجایی که API Monitoring و Analytics از خطوط لوله داده متفاوتی استفاده می کنند، ممکن است تفاوت های جزئی بین گزارش های سفارشی تولید شده توسط Monitoring و گزارش های تولید شده توسط Analytics مشاهده کنید. به عنوان مثال، ممکن است در نتایج گزارششده برای خطاهای مهلت زمانی مغایرتهایی مشاهده کنید - هر دو مهلت زمانی پشتیبان (کد وضعیت HTTP 504 در درخواست) و مهلت زمانی سرویس گیرنده (کد وضعیت HTTP 499). اینها ممکن است با کد وضعیت 200 در گزارشهای سفارشی Analytics ظاهر شوند، اما با کد وضعیت 504 یا 499 در نظارت بر گزارشهای سفارشی نشان داده میشوند.مانیتورینگ API
API Monitoring بینشهای بیدرنگ درباره عملکرد API ارائه میکند و به شما کمک میکند تا به سرعت مشکلات را تشخیص داده و برطرف کنید تا APIهای خود را همانطور که در نظر دارید کار کنید.
مانیتورینگ API شما را قادر می سازد:
- افزایش در دسترس بودن API و کاهش میانگین زمان تشخیص (MTTD).
- قبل از اینکه مصرف کنندگان تحت تأثیر قرار گیرند، اقدامات مناسب را بر اساس هشدارهای متنی انجام دهید.
- از کدهای خطای Apigee برای سرعت بخشیدن به تشخیص استفاده کنید.
- مناطق مشکل را به سرعت جدا کنید تا مشکلات خطا، عملکرد و تأخیر و منبع آنها را تشخیص دهید.
Edge API Analytics
Edge API Analytics اطلاعاتی را که از طریق API ها جریان می یابد جمع آوری و تجزیه و تحلیل می کند. API Analytics اطلاعاتی مانند:
- روند تردد ترافیک API شما در طول زمان
- کدام برنامه های برتر شما هستند
- برترین توسعه دهندگان شما چه کسانی هستند
- کدام روش های API محبوب ترین هستند
- چه زمانی زمان پاسخ API سریعترین/کمترین زمان است
- از نظر جغرافیایی بیشترین ترافیک API را در کجا می بینید
داده های جمع آوری شده توسط API Analytics
API Analytics طیف گسترده ای از داده ها را جمع آوری و تجزیه و تحلیل می کند که در بین API ها جریان دارد. به عنوان مثال، در حالی که API شما مستقر است، Analytics به طور مداوم تعداد پیام های دریافتی، تعداد توسعه دهندگان، زمان پاسخگویی، خطاها، تعداد برنامه های در حال استفاده، اندازه درخواست و بسیاری از داده های دیگر را ثبت می کند.
برای آشنایی خوب با معیارها و نحوه استفاده از آنها، به استفاده از APIs معیارها برای اندازه گیری عملکرد برنامه API مراجعه کنید. برای فهرست کامل معیارها، به مرجع معیارها، ابعاد و فیلترها Analytics مراجعه کنید.
معیارهای سفارشی را جمع آوری کنید
همچنین می توانید با استفاده از خط مشی StatisticsCollector معیارهای سفارشی را جمع آوری کنید. خطمشی StatisticsCollector میتواند اطلاعاتی را از سرصفحههای درخواست، بارهای XML/JSON، پارامترهای جستجو، URI و سایر مکانها برای تجزیه و تحلیل و تولید گزارش در سرور Analytics بنویسد.
دسترسی به داده های Analytics
پس از تولید، میتوانید با استفاده از ابزارهای تجسم API Analytics، از جمله داشبورد، گزارشهای سفارشی و نقشه جغرافیایی، به معیارهای از پیش تعریفشده و معیارهای سفارشی دسترسی داشته باشید. برای اطلاعات بیشتر در مورد ابزارهای تجسم ارائه شده توسط API Analytics، به داشبورد Analytics مراجعه کنید. برای اطلاعات بیشتر در مورد گزارش های سفارشی، به ایجاد گزارش های سفارشی مراجعه کنید.
مقایسه API Monitoring و API Analytics
توسعه دهندگان API از API Monitoring و API Analytics استفاده می کنند. یکی از تفاوت های اصلی بین این دو مکانیسم هشدار تعبیه شده در API Monitoring است. هشدارها به تیم عملیاتی شما اجازه میدهد به مشکلات مربوط به APIهای شما در زمان واقعی پاسخ دهد تا اطمینان حاصل شود که APIهای شما در دسترس هستند و مطابق انتظار عمل میکنند.
شرایط هشدار، کد وضعیت خاص (2xx/4xx/5xx)، تاخیر و آستانه کد خطا را مشخص میکند که وقتی از آن فراتر رفت، هشدارهای بصری را در رابط کاربری ایجاد میکند و اعلانها را از طریق کانالهای مختلف، مانند ایمیل، شلی، پیجردوتی یا وبکهوک ارسال میکند. میتوانید هشدارها را در محیط، پروکسی API یا سرویس هدف یا سطح منطقه تنظیم کنید.
پس از فعال شدن یک هشدار، تیم عملیات شما میتواند از رابط کاربری API Monitoring برای بررسی مشکل و بررسی علت اصلی آن استفاده کند. سپس می توانید یک گزارش سفارشی ایجاد کنید که شامل اطلاعات از پیش تعریف شده درباره هشدار است، مانند:
- کل زمان پاسخگویی
- زمان پاسخگویی هدف
- خطاهای پروکسی
- خطاهای هدف
- UUID را درخواست کنید
- بسیاری دیگر
API Analytics به گونه ای طراحی شده است که طیف وسیعی از داده ها را برای استفاده توسط چندین تیم جمع آوری کند. به عنوان مثال:
- تیم عملیات میتواند از دادههای Analytics برای شناسایی دورههای ترافیک بالا یا کم استفاده کند تا بتوانند خدمات شما را برای برآورده کردن تقاضاهای در حال تغییر مقیاس یا کاهش دهند.
- تیم بازاریابی میتواند از دادههای Analytics برای تعیین الگوهای استفاده مشتری که توسط APIها، برنامهها، مشتریان یا دادههای دیگر شناسایی شدهاند، استفاده کند.
- همه تیمها میتوانند به دادههای سفارشی جمعآوریشده از یک درخواست برای ردیابی اطلاعات خاص مانند مقادیر سرصفحه، پارامترهای پرس و جو یا بار درخواست دسترسی داشته باشند.
شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات
این بخش مانیتورینگ API را با Edge Analytics مقایسه میکند. در حالی که هر دو API Monitoring و Edge Analytics به شما امکان می دهند داده های API را جمع آوری و مشاهده کنید، اهداف متفاوتی دارند:
- هدف API Monitoring این است که اطمینان حاصل شود که API های شما همانطور که در نظر گرفته شده آماده و اجرا می شوند. برای این منظور، می خواهید آخرین داده های موجود را مشاهده کنید. API Monitoring داده هایی را ارائه می دهد که بسیار نزدیک به زمان واقعی هستند و به شما امکان می دهد هشدارهایی ایجاد کنید که در صورت بروز مشکل به شما اطلاع می دهند.
- هدف Edge Analytics درک رفتار بلندمدت API های شما است، به طوری که می توانید اطمینان حاصل کنید که آنها نیازهای کسب و کار شما را پشتیبانی می کنند یا در صورت لزوم تغییراتی ایجاد کنید. برای این اهداف، دیدن داده های بلادرنگ اهمیت کمتری دارد. در نتیجه، دادههای Analytics کمی تأخیر میافتد، البته معمولاً حداکثر 10 دقیقه.
توجه داشته باشید که داده های API Monitoring که بیشتر مربوط به کدهای خطا و تأخیر است، زیرمجموعه کوچکی از داده های Analytics است.
تفاوت بین داده های API Monitoring و داده های Analytics
این بخش برخی تفاوتهای جزئی را بین دادههای جمعآوریشده توسط Edge Analytics در مقابل نظارت API توضیح میدهد. از آنجایی که API Monitoring و Analytics از خطوط لوله داده متفاوتی استفاده می کنند، ممکن است تفاوت های جزئی بین گزارش های سفارشی تولید شده توسط Monitoring و گزارش های تولید شده توسط Analytics مشاهده کنید. به عنوان مثال، ممکن است در نتایج گزارششده برای خطاهای مهلت زمانی مغایرتهایی مشاهده کنید - هر دو مهلت زمانی پشتیبان (کد وضعیت HTTP 504 در درخواست) و مهلت زمانی سرویس گیرنده (کد وضعیت HTTP 499). اینها ممکن است با کد وضعیت 200 در گزارشهای سفارشی Analytics ظاهر شوند، اما با کد وضعیت 504 یا 499 در نظارت بر گزارشهای سفارشی نشان داده میشوند.مانیتورینگ API
API Monitoring بینشهای بیدرنگ درباره عملکرد API ارائه میکند و به شما کمک میکند تا به سرعت مشکلات را تشخیص داده و برطرف کنید تا APIهای خود را همانطور که در نظر دارید کار کنید.
مانیتورینگ API شما را قادر می سازد:
- افزایش در دسترس بودن API و کاهش میانگین زمان تشخیص (MTTD).
- قبل از اینکه مصرف کنندگان تحت تأثیر قرار گیرند، اقدامات مناسب را بر اساس هشدارهای متنی انجام دهید.
- از کدهای خطای Apigee برای سرعت بخشیدن به تشخیص استفاده کنید.
- مناطق مشکل را به سرعت جدا کنید تا مشکلات خطا، عملکرد و تأخیر و منبع آنها را تشخیص دهید.
Edge API Analytics
Edge API Analytics اطلاعاتی را که از طریق API ها جریان می یابد جمع آوری و تجزیه و تحلیل می کند. API Analytics اطلاعاتی مانند:
- روند ترند ترافیک API شما در طول زمان
- کدام برنامه های برتر شما هستند
- برترین توسعه دهندگان شما چه کسانی هستند
- کدام روش های API محبوب ترین هستند
- چه زمانی زمان پاسخ API سریعترین/کمترین زمان است
- از نظر جغرافیایی بیشترین ترافیک API را در کجا می بینید
داده های جمع آوری شده توسط API Analytics
API Analytics طیف گسترده ای از داده ها را جمع آوری و تجزیه و تحلیل می کند که در بین API ها جریان دارد. به عنوان مثال، در حالی که API شما مستقر است، Analytics به طور مداوم تعداد پیام های دریافتی، تعداد توسعه دهندگان، زمان پاسخگویی، خطاها، تعداد برنامه های در حال استفاده، اندازه درخواست و بسیاری از داده های دیگر را ثبت می کند.
برای آشنایی خوب با معیارها و نحوه استفاده از آنها، به استفاده از APIs معیارها برای اندازه گیری عملکرد برنامه API مراجعه کنید. برای فهرست کامل معیارها، به مرجع معیارها، ابعاد و فیلترها Analytics مراجعه کنید.
معیارهای سفارشی را جمع آوری کنید
همچنین می توانید با استفاده از خط مشی StatisticsCollector معیارهای سفارشی را جمع آوری کنید. خطمشی StatisticsCollector میتواند اطلاعاتی را از سرصفحههای درخواست، بارهای XML/JSON، پارامترهای جستجو، URI و سایر مکانها برای تجزیه و تحلیل و تولید گزارش در سرور Analytics بنویسد.
دسترسی به داده های Analytics
پس از تولید، میتوانید با استفاده از ابزارهای تجسم API Analytics، از جمله داشبورد، گزارشهای سفارشی و نقشه جغرافیایی، به معیارهای از پیش تعریفشده و معیارهای سفارشی دسترسی داشته باشید. برای اطلاعات بیشتر در مورد ابزارهای تجسم ارائه شده توسط API Analytics، به داشبورد Analytics مراجعه کنید. برای اطلاعات بیشتر در مورد گزارش های سفارشی، به ایجاد گزارش های سفارشی مراجعه کنید.
مقایسه API Monitoring و API Analytics
توسعه دهندگان API از API Monitoring و API Analytics استفاده می کنند. یکی از تفاوت های اصلی بین این دو مکانیسم هشدار تعبیه شده در API Monitoring است. هشدارها به تیم عملیاتی شما اجازه میدهد به مشکلات مربوط به APIهای شما در زمان واقعی پاسخ دهد تا اطمینان حاصل شود که APIهای شما در دسترس هستند و مطابق انتظار عمل میکنند.
شرایط هشدار، کد وضعیت خاص (2xx/4xx/5xx)، تاخیر و آستانه کد خطا را مشخص میکند که وقتی از آن فراتر رفت، هشدارهای بصری را در رابط کاربری ایجاد میکند و اعلانها را از طریق کانالهای مختلف، مانند ایمیل، شلی، پیجردوتی یا وبکهوک ارسال میکند. میتوانید هشدارها را در محیط، پروکسی API یا سرویس هدف یا سطح منطقه تنظیم کنید.
پس از فعال شدن یک هشدار، تیم عملیات شما میتواند از رابط کاربری API Monitoring برای بررسی مشکل و بررسی علت اصلی آن استفاده کند. سپس می توانید یک گزارش سفارشی ایجاد کنید که شامل اطلاعات از پیش تعریف شده درباره هشدار است، مانند:
- کل زمان پاسخگویی
- زمان پاسخگویی هدف
- خطاهای پروکسی
- خطاهای هدف
- UUID را درخواست کنید
- بسیاری دیگر
API Analytics به گونه ای طراحی شده است که طیف وسیعی از داده ها را برای استفاده توسط چندین تیم جمع آوری کند. به عنوان مثال:
- تیم عملیات میتواند از دادههای Analytics برای شناسایی دورههای ترافیک بالا یا کم استفاده کند تا بتوانند خدمات شما را برای برآورده کردن تقاضاهای در حال تغییر مقیاس یا کاهش دهند.
- تیم بازاریابی میتواند از دادههای Analytics برای تعیین الگوهای استفاده مشتری که توسط APIها، برنامهها، مشتریان یا دادههای دیگر شناسایی شدهاند، استفاده کند.
- همه تیمها میتوانند به دادههای سفارشی جمعآوریشده از یک درخواست برای ردیابی اطلاعات خاص مانند مقادیر سرصفحه، پارامترهای پرس و جو یا بار درخواست دسترسی داشته باشند.