بررسی وضعیت بارگذاری و خطاها

هرزمان بخواهید می‌توانید وضعیت بارگذاری‌های فراداده و داده‌های زمان اجرا را با پُرسمان کردن نقطه پایانی وضعیت محلی رابط Apigee API Hub برای اتصال‌دهنده «ابر خصوصی» بررسی کنید.

درحال بررسی وضعیت بارگذاری

از فرمان curl زیر در ماشین مجازی که رابط Apigee API Hub for Private Cloud را اجرا می‌کند استفاده کنید:

curl localhost:8080/v1/uapim/status

  {
 "apiSyncStatus": [
   {
     "organization": "foo",
     "phase": "Preparing",
     "components": [
       "proxy": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 100,
           "pendingItems": 90,
           "completedItems": 6,
           "failedItems": 4
         }
       },
       "environment": { //environment upload status
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 5,
           "pendingItems": 1,
           "completedItems": 3,
           "failedItems": 1
         }
       }]
   },
   {
     "organization": "bar",
     "phase": "Processing",
     "components": [
       "proxy": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 110,
           "pendingItems": 16,
           "completedItems": 3,
           "failedItems": 1
         }
       },
       "environment": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 5,
           "pendingItems": 3,
           "completedItems": 1,
           "failedItems": 1
         }
       }]
   },
   {
     "organization": "test",
     "phase": "Queued",
     "lastUpdated": "2025-04-16T00:56:45Z"
   }
 ],
 "analyticsSyncStatus": [
   {
     "organization": "test",
     "environment": "dev",
     "failedItems": 2,
     "lastUpdated": "2025-04-16T00:56:45Z"
   },
   {
     "organization": "test",
     "environment": "prod",
     "failedItems": 4,
     "lastUpdated": "2025-04-16T00:56:45Z"
   }
 ]
}

برونداد اطلاعات آماری زیر را ارائه می‌دهد:

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

مشکلات رایج و مراحل عیب‌یابی

اگر با مشکلی مواجه شدید، گزارش‌های اتصال‌دهنده و نقطه پایانی وضعیت را بررسی کنید. فایل گزارش اصلی برای رابط کانال Apigee در /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log قرار دارد

1. اتصال‌دهنده Apigee API Hub for Private Cloud راه‌اندازی نمی‌شود:
   • بررسی گزارش‌ها: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log را برای پیام‌های خطای مربوط به پیکربندی بررسی کنید.
   • درستی‌سنجی تنظیمات: همه تنظیمات پیکربندی‌شده در uapim-connector.properties و متغیرهای محیطی را دوباره بررسی کنید.
   • دسترسی Pub/Sub: در گزارش‌ها بررسی کنید که آیا opdk-connector می‌تواند به موضوعات Pub/Sub ارائه‌شده دسترسی داشته باشد یا نه.
   • دسترسی به سرور مدیریت: بررسی کنید که آیا opdk-connector می‌تواند با نشانی وب و اعتبارنامه‌های داده‌شده با سرور مدیریت Apigee تماس بگیرد یا نه.
   • زمان راه‌اندازی: اگر هزاران استقرار در محیط Apigee شما وجود داشته باشد، اتصال‌دهنده هاب Apigee می‌تواند تقریباً ۲۰ تا ۳۰ دقیقه طول بکشد تا راه‌اندازی شود.
2. فراداده‌های API در مرکز API نشان داده نمی‌شود:
   • گزارش‌های اتصال‌دهنده: گزارش‌های opdk-connector را بررسی کنید تا ببینید آیا می‌تواند به موضوع Pub/Sub فراداده API دسترسی داشته باشد و سرور مدیریت را فراخوانی کند یا نه.
   • وضعیت بارگذاری: خروجی curl localhost:8080/v1/uapim/status را بررسی کنید. بخش APIMetadata را پیدا کنید.
     • آیا lastUpdated جدید است؟
     • آیا errorCount به‌طور پیوسته درحال افزایش است؟
     • در چه مرحله‌ای است؟
   • استثناها/خطاها: گزارش‌ها را برای یافتن هرگونه استثنا یا خطای مربوط به پردازش فراداده جستجو کنید.
3. داده‌های زمان اجرا در مرکز API نشان داده نمی‌شود:
   • گزارش‌های اتصال‌دهنده: بررسی کنید که آیا opdk-connector می‌تواند به موضوع Pub/Sub زمان اجرا دسترسی داشته باشد و سرور مدیریت را فراخوانی کند.
   • وضعیت بارگذاری: از فرمان curl localhost:8080/v1/uapim/status استفاده کنید. روی بخش RuntimeData تمرکز کنید.
     • آیا lastUpdated جدید است؟
     • آیا errorCount به‌طور پیوسته درحال افزایش است؟
   • استثناها/خطاها: هرگونه استثنا یا خطایی را در گزارش‌های مربوط به پردازش داده‌های زمان اجرا جستجو کنید.
   • پیکربندی پردازشگر پیام: مطمئن شوید که message-processor-communication.properties در همه «پردازشگرهای پیام» برای نوشتن دوگانه به‌درستی پیکربندی شده باشد و «پردازشگرهای پیام» بازراه‌اندازی شده باشند.
   • نصب NFS: بررسی کنید که نصب NFS به‌درستی پیکربندی شده باشد و هم توسط MPs و هم توسط اتصال‌دهنده UAPIM قابل‌دسترسی باشد.
4. پراکسی مستقر شده است، اما اطلاعات در مرکز API دقیق نیست:
   • زمان انتظار: چند دقیقه صبر کنید تا داده‌ها منتشر شوند.
   • گزارش‌ها: گزارش‌های opdk-connector را برای اطلاعات درباره پراکسی‌های بارگذاری‌شده بررسی کنید. این کار می‌تواند به شناسایی اینکه آیا اتصال‌دهنده رویدادهای استقرار را پردازش می‌کند یا نه کمک کند.