عیب‌یابی API

بررسی سرویسی تبادل داده میان AI Analytics و پلتفرم دستگاه‌های اندازه‌گیری، با آزمودن هر درخواستی که سایر گزارش‌ها به آن متکی‌اند.

بررسی سرویسی تبادل داده میان AI Analytics و پلتفرم دستگاه‌های اندازه‌گیری. گزارش به‌نوبت همه درخواست‌های پلتفرم را که سایر گزارش‌ها استفاده می‌کنند فرامی‌خواند و نشان می‌دهد کدام‌یک عادی پاسخ می‌دهند و کدام با خطا بازمی‌گردند. مخاطب آن مدیر و پشتیبانی فنی است: هنگام ظن به اختلال یکپارچه‌سازی آن را اجرا کنید و بی‌درنگ ببینید کجا ارتباط با دستگاه یا سرور قطع شده است.

چه چیزی نشان می‌دهد

برای هر نوع درخواست پلتفرم — یک سطر با نتیجه: کدام endpoint فراخوانده شد، آیا سرور موفق پاسخ داد، چند سطر داده برگرداند و چه فیلدهایی در سطر اول بودند (تا مطمئن شویم قالب داده تغییر نکرده است).

عنصر سطرمعنا
endpoint درخواستچه نوع داده‌ای بررسی شد (ورود به سیستم، فهرست ناوگان، دفترچه‌ها، جلسات ارتباطی، آرشیوهای قرائت، شناسنامه دستگاه)
وضعیتآیا سرور موفق پاسخ داد یا خطا برگرداند
تعداد سطرچند رکورد در پاسخ آمد
نمونه فیلدهانام فیلدهای رکورد اول — نشانه‌ای که قالب تغییر نکرده است

رنگ سطر را کد پاسخ سرور تعیین می‌کند:

رنگمعنا
سبز («200»)درخواست عادی کار می‌کند
زرد (خطای دسترسی، به‌جز «یافت نشد»)باید حقوق دسترسی بررسی شود
قرمز (خطای سروری یا نبود پاسخ به‌موقع)مشکل سمت سرور
خاکستری («404» — یافت نشد)چنین درخواستی در این نسخه پلتفرم وجود ندارد

چگونه محاسبه می‌شود

گزارش به‌نوبت همه درخواست‌های پلتفرم را که سایر گزارش‌ها استفاده می‌کنند فرامی‌خواند: ورود به سیستم، فهرست ناوگان، دفترچه‌ها (انواع دستگاه، سازمان‌های تأمین منابع، مشتریان)، جلسات ارتباطی (در چهار حالت پارامتر)، آرشیوهای قرائت (ساعتی، روزانه، ماهانه، تنظیمات)، آرشیوهای وضعیت‌های اضطراری و دفترهای رویداد، و نیز شناسنامه دستگاه. برای هر فراخوان، endpoint، پاسخ سرور، تعداد سطر و نمونه فیلدها ثبت می‌شود. اگر نقطه‌ای مشخص تعیین شده باشد، علاوه بر آن آرشیوهای وضعیت‌های اضطراری برای همان نقطه بررسی می‌شوند.

پارامترهای اجرا

پارامترپیش‌فرضمعنا
شناسه نقطه برای بررسی آرشیو اضطراری (اختیاری)از زمینه گرفته می‌شوداگر تعیین شود — بررسی روی این نقطه انجام می‌شود؛ اگر خالی باشد — نخستین نقطه فهرست ناوگان گرفته می‌شود

چگونه نتیجه را بخوانیم

به رنگ سطرها نگاه کنید. سراسر سبز — تبادل داده سالم است. سطرهای زرد یعنی سرور سرجایش است اما بدون حقوق لازم داده‌ای بازنمی‌گرداند — دلیلی برای بررسی دسترسی. سطرهای قرمز اختلال سمت سرور است و در درجه نخست بررسی می‌شوند. سطرهای خاکستری («یافت نشد») اغلب عادی‌اند: همه دستگاه‌ها همه انواع آرشیو را پشتیبانی نمی‌کنند، پس نبود آرشیوهای اضطراری در یک دستگاه مشخص خطا نیست.

به یک ویژگی ورود به سیستم توجه کنید: پلتفرم مجوز پیش‌تر گرفته‌شده را حدود دو هفته بازاستفاده می‌کند، پس بررسی ورود معمولاً موفق است حتی بدون ورود واقعی مجدد به سرور.

گزارش‌های مرتبط

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

آخرین به‌روزرسانی در

آیا این صفحه مفید بود؟