Memeriksa status dan error upload

Anda dapat memeriksa status upload metadata dan data runtime kapan saja dengan membuat kueri endpoint status lokal konektor Apigee API Hub untuk Private Cloud.

Memeriksa status upload

Gunakan perintah curl berikut di virtual machine yang menjalankan konektor Apigee API Hub untuk Private Cloud:

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"
        }
      ]
    }

Output memberikan insight tentang:

• Metadata API: Status upload metadata API, termasuk organisasi, lingkungan, tahap saat ini (misalnya, "Transfer Massal", "Streaming", "Belum dimulai"), total/selesai/tertunda upload, jumlah error, dan waktu pembaruan terakhir.
• Metadata runtime: Status upload data runtime, yang menampilkan organisasi, lingkungan, jumlah error, dan waktu update terakhir.

Masalah umum dan langkah-langkah pemecahan masalah

Jika Anda mengalami masalah, lihat log konektor dan endpoint status. File log utama untuk konektor hub Apigee terletak di /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

1. Konektor Apigee API Hub untuk Private Cloud tidak dimulai:
   • Periksa log: Periksa /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log untuk melihat pesan error terkait konfigurasi.
   • Verifikasi setelan: Periksa ulang semua setelan yang dikonfigurasi di uapim-connector.properties dan variabel lingkungan.
   • Akses Pub/Sub: Verifikasi di log apakah opdk-connector dapat mengakses topik Pub/Sub yang disediakan.
   • Akses server pengelolaan: Periksa log jika opdk-connector berhasil memanggil server pengelolaan Apigee dengan URL dan kredensial yang diberikan.
   • Waktu mulai: Jika ada ribuan deployment di lingkungan Apigee Anda, konektor hub Apigee dapat memerlukan waktu sekitar 20-30 menit untuk dimulai.
2. Metadata API tidak muncul di hub API:
   • Log konektor: Tinjau log opdk-connector untuk melihat apakah konektor dapat mengakses topik Pub/Sub metadata API dan memanggil server pengelolaan.
   • Status upload: Periksa output curl localhost:8080/v1/uapim/status. Cari bagian APIMetadata.
     • Apakah lastUpdated baru-baru ini?
     • Apakah errorCount terus bertambah?
     • Di tahap apa?
   • Pengecualian/error: Cari pengecualian atau error yang terjadi terkait pemrosesan metadata di log.
3. Data runtime tidak muncul di hub API:
   • Log konektor: Periksa apakah opdk-connector dapat mengakses topik Pub/Sub runtime dan memanggil server pengelolaan.
   • Status upload: Gunakan perintah curl localhost:8080/v1/uapim/status. Fokus pada bagian RuntimeData.
     • Apakah lastUpdated baru-baru ini?
     • Apakah errorCount terus bertambah?
   • Pengecualian/error: Cari pengecualian atau error dalam log yang terkait dengan pemrosesan data runtime.
   • Konfigurasi pemroses pesan: Pastikan message-processor-communication.properties dikonfigurasi dengan benar di semua MP untuk penulisan ganda, dan MP telah dimulai ulang.
   • Pemasangan NFS: Pastikan pemasangan NFS dikonfigurasi dengan benar dan dapat diakses oleh MP dan konektor UAPIM.
4. Proxy di-deploy, tetapi informasi di hub API tidak akurat:
   • Waktu tunggu: Beri waktu beberapa menit agar data diterapkan.
   • Log: Periksa log opdk-connector untuk mengetahui informasi tentang proxy yang diupload. Hal ini dapat membantu mengidentifikasi apakah konektor sedang memproses peristiwa deployment.