عیب یابی ادغام

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

فراداده API در هاب API نمایش داده نمی شود

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

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

• تأخیر انتشار: چند دقیقه فرصت دهید تا اطلاعات پراکسی مستقر شده منتشر شود و در هاب API منعکس شود.
• بررسی گزارش‌ها: برای جزئیات بیشتر در مورد پراکسی‌های آپلود شده، Edge for Private Cloud Hub API را مرور کنید. این می تواند به شناسایی اینکه آیا به روز رسانی پراکسی برای همگام سازی با موفقیت پردازش شده است یا خیر کمک کند.

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

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

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

وضعیت API یک راه مستقیم برای مشاهده اینکه کدام سازمان ها شرکت کرده اند و به طور فعال همگام سازی می کنند، فراهم می کند.

عیب یابی مبتنی بر گزارش

لاگ های رابط هاب API کجا ذخیره می شوند؟

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

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

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

• اقدام: نقطه پایانی API وضعیت را فراخوانی کنید.
• خروجی مورد انتظار: سازمان‌های انتخاب‌شده در بخش‌های apiSyncStatus و analyticsSyncStatus در پاسخ API فهرست می‌شوند. سازمان‌هایی که همگام‌سازی فراداده را فعال کرده‌اند، تحت 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 یا ابزارهای جستجوی گزارش مشابه برای یافتن خطوط گزارش زیر استفاده کنید:
    • برای همگام سازی فراداده org metadata-org:

      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

    • به دنبال متن Setup metadata sync برای سازمان بگردید: به دنبال آن نام سازمان.
    • برای همگام سازی داده های زمان اجرا 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

    • به دنبال متن Setup runtime data sync برای سازمان بگردید: به دنبال آن نام سازمان.

چگونه می توانم اطلاعات تمام (org,env)هایی که فعال نشدند را از لاگ دریافت کنم؟

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

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

    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: به دنبال آن سازمان و محیط (به عنوان مثال، شکست-org/failed-env).

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

برای دریافت خلاصه ای از زمانی که یک وضعیت انتقال همگام سازی (org، 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

  • به دنبال متن دقیق "وضعیت انتقال برای org/env به روز است" و سپس سازمان و محیط خاص (به عنوان مثال، org1/prod) و وضعیت بگردید.