アップロードのステータスとエラーを確認する

メタデータとランタイム データのアップロードのステータスは、Apigee API Hub for Private Cloud コネクタのローカル ステータス エンドポイントにクエリを実行することで、いつでも確認できます。

アップロード ステータスの確認

Apigee API Hub for Private Cloud コネクタを実行している仮想マシンで、次の curl コマンドを使用します。

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 Hub Connector のメインログファイルは /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 トピックにアクセスできるかどうかを確認します。
   • 管理サーバーへのアクセス: 指定された URL と認証情報を使用して opdk-connector が Apigee 管理サーバーを正常に呼び出すことができるかどうかをログで確認します。
   • 起動時間: Apigee 環境に数千のデプロイがある場合、Apigee Hub コネクタの起動に 20 ～ 30 分ほどかかることがあります。
2. API メタデータが API Hub に表示されない:
   • コネクタログ: opdk-connector ログを確認して、API メタデータ Pub/Sub トピックにアクセスし、管理サーバーを呼び出すことができるかどうかを確認します。
   • アップロード ステータス: curl localhost:8080/v1/uapim/status の出力を確認します。APIMetadata セクションを探します。
     • lastUpdated は最近のものですか？
     • errorCount は一貫して増加していますか？
     • どの段階にありますか？
   • 例外/エラー: ログで、メタデータ処理に関連する例外またはエラーがスローされていないか確認します。
3. ランタイム データが API Hub に表示されない:
   • コネクタログ: opdk-connector がランタイム Pub/Sub トピックにアクセスして管理サーバーを呼び出すことができるかどうかを確認します。
   • アップロード ステータス: curl localhost:8080/v1/uapim/status コマンドを使用します。RuntimeData セクションに注目してください。
     • lastUpdated は最近のものですか？
     • errorCount は一貫して増加していますか？
   • 例外/エラー: ランタイム データ処理に関連するログで例外またはエラーを探します。
   • メッセージ プロセッサの構成: デュアル書き込み用にすべての MP で message-processor-communication.properties が正しく構成され、MP が再起動されていることを確認します。
   • NFS マウント: NFS マウントが正しく構成され、MP と UAPIM コネクタの両方からアクセスできることを確認します。
4. プロキシはデプロイされているが、API Hub の情報が正確でない:
   • 待機時間: データが伝播するまで数分待ちます。
   • ログ: opdk-connector ログで、アップロードされたプロキシに関する情報を確認します。これにより、コネクタがデプロイ イベントを処理しているかどうかを特定できます。