您可以隨時查詢 Apigee API Hub 的 Private Cloud 連接器本機狀態端點，查看中繼資料和執行階段資料的上傳狀態。
查看上傳狀態
在執行 Apigee API Hub for Private Cloud 連接器的虛擬機器上，使用下列 curl 指令：
curl localhost:8080/v1/uapim/status
{
"APIMetadata": [
{
"organization": "test",
"environment": "dev",
"stage": "BULK_TRANSFER",
"totalDeployments": 100,
"completed": 10,
"lastUpdated": "04-16-2025 00:56:45",
"errors": 0
},
{
"organization": "test",
"environment": "prod",
"stage": "STREAMING",
"pendingUploads": 10,
"errors": 1,
"lastUpdated": "04-16-2025 00:56:45"
},
{
"organization": "test1",
"environment": "staging",
"stage": "Yet to Start",
"lastUpdated": "04-16-2025 00:56:45"
}
],
"RuntimeData": [
{
"organization": "test",
"environment": "dev",
"errorCount": 2,
"lastUpdated": "04-16-2025 00:56:45"
},
{
"organization": "test",
"environment": "prod",
"errorCount": 4,
"lastUpdated": "04-16-2025 00:56:45"
},
{
"organization": "test1",
"environment": "staging",
"errorCount": 0,
"lastUpdated": "04-16-2025 00:56:45"
}
]
}輸出內容會深入分析下列項目：
- API 中繼資料：API 中繼資料上傳狀態，包括機構、環境、目前階段 (例如「大量轉移」、「串流」、「尚未開始」)、上傳總數/已完成/待處理的上傳作業、錯誤計數，以及上次更新時間。
- 執行階段中繼資料：顯示執行階段資料上傳狀態，包括機構、環境、錯誤計數和上次更新時間。
常見問題和疑難排解步驟
如果遇到問題，請參閱連接器的記錄和狀態端點。Apigee 中樞連接器的主要記錄檔位於 /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
- 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 Hub 連接器可能需要大約 20 到 30 分鐘才能啟動。
- 檢查記錄：檢查
- API 中繼資料未顯示在 API 中心：
- 連結器記錄：查看
opdk-connector記錄，確認連結器是否可以存取 API 中繼資料 Pub/Sub 主題，並呼叫管理伺服器。 - 上傳狀態：檢查
curl localhost:8080/v1/uapim/status輸出內容。尋找「APIMetadata」部分。- lastUpdated 是否為近期更新？
- errorCount 是否持續增加？
- 目前處於哪個階段？
- 例外狀況/錯誤：在記錄檔中搜尋與中繼資料處理相關的任何例外狀況或錯誤。
- 連結器記錄：查看
- API 中樞未顯示執行階段資料：
- 連接器記錄：檢查 opdk-connector 是否可以存取執行階段 Pub/Sub 主題，並呼叫管理伺服器。
- 上傳狀態：使用
curl localhost:8080/v1/uapim/status指令。請著重於RuntimeData部分。- lastUpdated 是否為近期更新？
- errorCount 是否持續增加？
- 例外狀況/錯誤：在與執行階段資料處理相關的記錄中，尋找任何例外狀況或錯誤。
- 訊息處理器設定：請確認所有訊息處理器都已正確設定雙重寫入功能，並已重新啟動。
message-processor-communication.properties - NFS 掛接：確認 NFS 掛接設定正確，且 MP 和 UAPIM 連接器都能存取。
- 已部署 Proxy，但 API 中心內的資訊不正確：
- 等待時間：資料傳播需要幾分鐘的時間。
- 記錄：查看
opdk-connector記錄，瞭解已上傳 Proxy 的相關資訊。這有助於判斷連接器是否正在處理部署事件。