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

メタデータとランタイム データのアップロードのステータスは、Apigee API Hub for 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 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 ログで、アップロードされたプロキシに関する情報を確認します。これにより、コネクタがデプロイ イベントを処理しているかどうかを特定できます。