عیب‌یابی یکپارچه‌سازی

در اینجا برخی‌از مشکلات رایج و مراحل عیب‌یابی آن‌ها برای ادغام اتصال‌دهنده مرکز API آورده شده است.

فراداده‌های میانای برنامه‌سازی کاربردی در مرکز میانای برنامه‌سازی کاربردی نشان داده نمی‌شود

• زمان همگام‌سازی اولیه: ممکن است چند ساعت طول بکشد تا همگام‌سازی اولیه شروع شود و داده‌های API در «مرکز API» ظاهر شود. توصیه می‌شود چند ساعت صبر کنید.
• وضعیت نمونه افزایه: تأیید کنید که نمونه افزایه در مرکز API حذف یا تغییر نکرده باشد.
• شناسه درگاه: مطمئن شوید که شناسه درگاه صحیح در تنظیمات رابط Apigee Edge برای مرکز API «ابر خصوصی» به‌درستی پیکربندی شده است.
• بررسی گزارش‌ها: بررسی کنید که آیا خطایی در گزارش‌های سرویس اتصال‌دهنده مرکز میانای برنامه‌سازی کاربردی Edge for Private Cloud ثبت شده است یا نه /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log.

کارگزار پراکسی مستقر شده است اما اطلاعات کانون API دقیق نیست

• تأخیر انتشار: چند دقیقه زمان بدهید تا اطلاعات پراکسی مستقر منتشر شود و در کانون API منعکس شود.
• بررسی گزارش‌ها: گزارش‌های اتصال‌دهنده مرکز API «لبه برای ابر خصوصی» را برای جزئیات مربوط به پراکسی‌های بارگذاری‌شده مرور کنید. این کار می‌تواند به شناسایی اینکه آیا به‌روزرسانی پراکسی برای هم‌زمان‌سازی باموفقیت پردازش شده است یا نه کمک کند.

سازمان کاربر بدون تغییر دادن چیزی در اتصال‌دهنده مرکز API همگام‌سازی را متوقف کرد

• وضعیت نمونه افزایه (سمت مرکز API): بررسی کنید که آیا نمونه افزایه مرتبط در مرکز API لغو تخصیص، حذف، یا تغییر کرده است یا نه. هرگونه تغییر در سمت مرکز API می‌تواند مستقیماً بر همگام‌سازی از اتصال‌دهنده مرکز API تأثیر بگذارد.
• بررسی گزارش‌ها: گزارش‌های اتصال‌دهنده مرکز API مربوط به Edge for Private Cloud را برای یافتن خطاها، هشدارهای، یا مشکلاتی که ممکن است نشان‌دهنده اختلال در فرایند همگام‌سازی باشد مرور کنید. این می‌تواند شامل مشکلات اتصال یا مشکلات احراز هویت با کانون API باشد.

استفاده از API وضعیت (توصیه‌شده برای سازمان‌های موافقت‌کننده):

«میانای برنامه‌سازی کاربردی وضعیت» روشی مستقیم برای دیدن اینکه کدام سازمان‌ها موافقت کرده‌اند و به‌طور فعال همگام‌سازی می‌کنند ارائه می‌دهد.

عیب‌یابی براساس گزارش

گزارش‌های اتصال‌دهنده مرکز API کجا ذخیره می‌شود؟

/opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

چگونه می‌توانم اطلاعات مربوط به سازمان‌های فعال را دریافت کنم؟

برای تعیین اینکه کدام سازمان‌ها (orgs) درحال‌حاضر فعال هستند و همگام‌سازی می‌شوند، می‌توانید از API وضعیت استفاده کنید و گزارش‌های سیستم را بررسی کنید.

• کنش: نقطه پایان API وضعیت را فراخوانی کنید.
• برونداد موردانتظار: سازمان‌های موافقت‌کننده در بخش‌های apiSyncStatus و analyticsSyncStatus در پاسخ «میانای برنامه‌سازی کاربردی» فهرست خواهند شد. سازمان‌هایی که «همگام‌سازی فراداده» برای آن‌ها فعال است در بخش apiSyncStatus و سازمان‌هایی که «همگام‌سازی زمان اجرا» برای آن‌ها فعال است در بخش analyticsSyncStatus نشان داده می‌شوند.

  {
   "apiSyncStatus": [
     {
       "organization": "foo",
       "phase": "Preparing", // ColdTransfer => Preparing
       "components": [
         "proxy": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 100, // total proxies known to uapim connector
             "pendingItems": 90,  // pending proxies to upload
             "completedItems": 6, // completed proxies to upload
             "failedItems": 4 // proxies failed to upload
           }
         },
         "environment": { //environment upload status
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 5, // total number of environments
             "pendingItems": 1, // pending environments to process
             "completedItems": 3, // completed environment processing
             "failedItems": 1 // failed environment processing
           }
         }]
     },
     {
       "organization": "bar",
       "phase": "Processing", // "Streaming" -> "Processing"
       "components": [
         "proxy": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 110, // total proxies known to uapim connector
             "pendingItems": 16, // pending proxies to upload
             "completedItems": 3, // completed proxies to upload
             "failedItems": 1 // proxies failed to upload
           }
         },
         "environment": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 5, // total number of environments
             "pendingItems": 3, // pending environments to process
             "completedItems": 1, // completed environment processing
             "failedItems": 1 // failed environment processing
           }
         }]
     },
     {
       "organization": "test",
       "phase": "Queued", // "Yet to start" -> "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"
     }
   ]
  }
  

• بازرسی گزارش‌های سیستم: برای مشاهده دقیق‌تر و تأیید تنظیمات همگام‌سازی برای هر سازمان، می‌توانید گزارش‌های سیستم را برای ورودی‌های خاص بررسی کنید.
  • بررسی گزارش‌ها:

    /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • فرمان‌های جستجو: از grep یا ابزارهای مشابه جستجوی گزارش برای یافتن خطوط گزارش زیر استفاده کنید:
    • برای همگام‌سازی فراداده‌های سازمان-سازمان:

      grep "Setup metadata sync for organization: metadata-org"  /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • تکه‌کد گزارش نمونه:

      2025-07-10 08:47:09,901  main INFO  c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.setupMetadataSync() : Setup metadata sync for organization: metadata-org

    • به‌دنبال نوشتار راه‌اندازی همگام‌سازی فراداده برای سازمان: و پس‌از آن نام سازمان بگردید.
    • برای همگام‌سازی داده‌های زمان اجرا در سازمان runtime-org:

      grep "Setup runtime data sync for organization: runtime-org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • تکه‌کد گزارش نمونه:

      2025-07-10 08:47:09,902  main INFO  c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.setupRuntimeSyncData() : Setup runtime data sync for organization: runtime-org

    • به‌دنبال نوشتار راه‌اندازی همگام‌سازی داده‌های زمان اجرا برای سازمان: و پس‌از آن نام سازمان بگردید.

چگونه اطلاعات همه (سازمان، محیط) را که فعال کردن آن‌ها از گزارش‌ها ناموفق بوده است دریافت کنم؟

برای دریافت اطلاعات درباره سازمان‌هایی که فعال نشدند، می‌توانید گزارش‌های سیستم را برای ورودی‌های خطای خاص بررسی کنید.

• بررسی گزارش‌ها: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• فرمان‌های جستجو: از grep یا ابزارهای مشابه جستجوی گزارش برای یافتن خطوط گزارش که نشان‌دهنده خطا درطول به‌روزرسانی وضعیت همگام‌سازی فراداده است استفاده کنید.
  • برای به‌روزرسانی‌های وضعیت همگام‌سازی فراداده ناموفق برای سازمان/محیط ناموفق-سازمان/ناموفق-محیط:

    grep "Error while updating metadata sync status for org: failed-org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • تکه‌کد گزارش نمونه:

    2025-07-15 10:30:15,123 main ERROR c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.updateMetadataSyncStatus() : Error while updating metadata sync status for org: failed-org

  • به‌دنبال نوشتار Error while updating metadata sync status for org/env: و پس‌از آن سازمان و محیط (برای مثال، failed-org/failed-env) بگردید.

چگونه می‌توانم خلاصه‌ای از تغییر وضعیت انتقال سازمان از گزارش‌ها دریافت کنم؟

برای دریافت خلاصه زمانی که وضعیت انتقال همگام‌سازی (سازمان، محیط) به‌روزرسانی می‌شود، می‌توانید گزارش‌های سیستم را برای ورودی‌های خاص بررسی کنید.

• بررسی گزارش‌ها: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• فرمان‌های جستجو از grep یا ابزارهای مشابه جستجوی گزارش برای یافتن خطوط گزارش که نشان‌دهنده به‌روزرسانی وضعیت انتقال برای سازمان و محیط است استفاده کنید.
  • برای به‌روزرسانی‌های وضعیت انتقال:

    grep "Transfer status is updated for org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • تکه‌کد گزارش نمونه:

    2025-07-15 18:35:01,789 main INFO c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.updateTransferStatus() : Transfer status is updated for org: org1 to BULK_TRANSFER
    2025-07-10 08:47:11,364  main INFO  c.a.u.m.UAPIMMetadataServiceImpl - UAPIMMetadataServiceImpl.updateEnvironmentStatus() : Transfer status is updated for org: org1 to STREAMING

  • نوشتار دقیق «وضعیت انتقال برای سازمان/محیط به‌روز شد» را به‌همراه سازمان و محیط خاص (برای نمونه، org1/prod) و وضعیت جستجو کنید.