Memecahkan masalah integrasi

Berikut adalah beberapa masalah umum dan langkah-langkah pemecahannya untuk integrasi konektor hub API.

Metadata API tidak muncul di hub API

• Waktu sinkronisasi awal: Diperlukan waktu beberapa jam agar sinkronisasi awal dimulai dan data API muncul di Hub API. Sebaiknya tunggu beberapa jam.
• Status instance plugin: Verifikasi bahwa instance Plugin di hub API belum dihapus atau diubah.
• ID Gateway: Pastikan ID Gateway yang benar dikonfigurasi dengan benar di setelan konektor hub API Apigee Edge untuk Private Cloud.
• Periksa log: Periksa apakah ada error yang dicatat dalam log layanan konektor hub API Edge untuk Private Cloud /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log.

Proxy di-deploy, tetapi informasi di hub API tidak akurat

• Penundaan Penerapan: Tunggu beberapa menit agar informasi proxy yang di-deploy diterapkan dan ditampilkan di hub API.
• Periksa log: Tinjau log konektor hub API Edge untuk Private Cloud guna mengetahui detail tentang proxy yang diupload. Hal ini dapat membantu mengidentifikasi apakah update proxy berhasil diproses untuk sinkronisasi.

Organisasi pengguna berhenti menyinkronkan tanpa mengubah apa pun di konektor hub API

• Status instance plugin (sisi hub API): Verifikasi apakah instance plugin terkait di hub API telah di-deprovisi, dihapus, atau diubah. Setiap perubahan di sisi hub API dapat secara langsung memengaruhi sinkronisasi dari konektor hub API.
• Periksa log: Tinjau log konektor hub API Edge untuk Private Cloud untuk mengetahui adanya error, peringatan, atau masalah yang mungkin menunjukkan gangguan dalam proses sinkronisasi. Hal ini dapat mencakup masalah konektivitas atau masalah autentikasi dengan hub API.

Menggunakan status API (Direkomendasikan untuk organisasi yang memilih untuk mengaktifkan fitur ini):

Status API menyediakan cara langsung untuk melihat organisasi mana yang telah memilih untuk ikut serta dan sedang menyinkronkan secara aktif.

Pemecahan masalah berbasis log

Di mana log konektor hub API disimpan?

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

Bagaimana cara mendapatkan informasi tentang organisasi yang diaktifkan?

Untuk menentukan organisasi (org.) mana yang saat ini diaktifkan dan disinkronkan, Anda dapat memanfaatkan status API dan memeriksa log sistem.

• Tindakan: Panggil endpoint API status.
• Output yang diharapkan: Organisasi yang memilih untuk ikut serta akan tercantum di bagian apiSyncStatus dan analyticsSyncStatus dalam respons API. Organisasi yang mengaktifkan sinkronisasi Metadata akan muncul di bagian apiSyncStatus dan Organisasi yang mengaktifkan sinkronisasi runtime akan muncul di bagian 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"
     }
   ]
  }
  

• Memeriksa log sistem: Untuk melihat tampilan yang lebih terperinci dan mengonfirmasi penyiapan sinkronisasi untuk setiap organisasi, Anda dapat memeriksa log sistem untuk menemukan entri tertentu.
  • Periksa log:

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

  • Perintah penelusuran: Gunakan grep atau alat penelusuran log serupa untuk menemukan baris log berikut:
    • Untuk sinkronisasi metadata org metadata-org:

      grep "Setup metadata sync for organization: metadata-org"  /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • Contoh cuplikan log:

      2025-07-10 08:47:09,901  main INFO  c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.setupMetadataSync() : Setup metadata sync for organization: metadata-org

    • Cari teks Siapkan sinkronisasi metadata untuk organisasi:, diikuti dengan nama organisasi.
    • Untuk sinkronisasi data runtime org runtime-org:

      grep "Setup runtime data sync for organization: runtime-org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • Contoh cuplikan 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

    • Cari teks Siapkan sinkronisasi data runtime untuk organisasi: yang diikuti dengan nama organisasi.

Bagaimana cara mendapatkan informasi semua (org,env) yang gagal diaktifkan dari log?

Untuk mendapatkan informasi tentang organisasi yang gagal diaktifkan, Anda dapat memeriksa entri error tertentu dalam log sistem.

• Periksa log: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Perintah penelusuran: Gunakan grep atau alat penelusuran log serupa untuk menemukan baris log yang menunjukkan error selama pembaruan status sinkronisasi metadata.
  • Untuk update status sinkronisasi metadata yang gagal untuk 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

  • Contoh cuplikan 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

  • Cari teks Error while updating metadata sync status for org/env: yang diikuti dengan organisasi dan lingkungan (misalnya, failed-org/failed-env).

Bagaimana cara mendapatkan ringkasan perubahan status transfer organisasi dari log?

Untuk mendapatkan ringkasan kapan status transfer sinkronisasi (org, env) diperbarui, Anda dapat memeriksa log sistem untuk menemukan entri tertentu.

• Periksa log: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Perintah penelusuran Gunakan grep atau alat penelusuran log serupa untuk menemukan baris log yang menunjukkan pembaruan pada status transfer untuk organisasi dan lingkungan.
  • Untuk info terbaru status transfer:

    grep "Transfer status is updated for org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • Contoh cuplikan 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

  • Cari teks persis "Status transfer diperbarui untuk org/env" diikuti dengan organisasi dan lingkungan tertentu (misalnya, org1/prod) dan statusnya.