排解整合問題

以下列舉幾個常見問題，以及 API 中心連接器整合的疑難排解步驟。

API 中繼資料未顯示在 API 中心

• 初始同步時間：初始同步作業可能需要幾小時才會開始，API 資料也會在這段時間後顯示在 API 中心。建議稍候幾小時。
• 外掛程式執行個體狀態：確認 API 中心中的外掛程式執行個體未遭刪除或變更。
• 閘道 ID：請確認 Apigee Edge for Private Cloud API 中心連接器設定中，已正確設定閘道 ID。
• 檢查記錄：檢查 Edge for Private Cloud API 中樞連接器服務記錄 /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log 中是否有任何錯誤。

已部署 Proxy，但 API Hub 中的資訊不正確

• 傳播延遲：部署的 Proxy 資訊需要幾分鐘才會傳播，並反映在 API 中心。
• 檢查記錄：查看 Edge for Private Cloud API 中樞連接器記錄，瞭解上傳的 Proxy 詳細資料。這有助於判斷系統是否已成功處理 Proxy 更新，以進行同步。

使用者機構停止同步，但 API 中心連接器未進行任何變更

• 外掛程式執行個體狀態 (API 中心端)：確認 API 中心內相關聯的外掛程式執行個體是否已取消佈建、刪除或變更。API 中樞端的任何變更，都可能直接影響 API 中樞連接器的同步作業。
• 檢查記錄：查看 Edge for Private Cloud API 中樞連接器記錄，找出可能導致同步程序中斷的錯誤、警告或問題。這可能包括連線問題，或是 API 中心驗證問題。

使用狀態 API (建議已啟用機構使用)：

狀態 API 可直接顯示哪些機構已選擇加入並積極同步。

以記錄為基礎的疑難排解

API 中樞連接器記錄檔儲存在哪裡？

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

如何取得已啟用機構的相關資訊？

如要判斷目前已啟用及同步處理的機構，您可以運用狀態 API 並檢查系統記錄。

• 動作：呼叫狀態 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

    • 尋找「為機構設定中繼資料同步」文字，後面會顯示機構名稱。
    • 如要同步處理機構執行階段 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 或類似的記錄搜尋工具，找出指出中繼資料同步狀態更新期間發生錯誤的記錄行。
  • For failed metadata synchronization status updates for 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: 後方接續機構和環境的文字 (例如：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

  • 請尋找「Transfer status is updated for org/env」這段文字，後面會接上特定機構和環境 (例如 org1/prod) 和狀態。